HarmonyOS API：设备管理

版本：v3.1 Beta

@ohos.stationary (设备状态感知框架)

更新时间: 2023-02-17 09:19

设备状态感知框架提供设备状态感知能力，包括绝对静止和相对静止。

说明

本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

本模块不支持x86模拟器。

导入模块

import stationary from '@ohos.stationary'

ActivityResponse

服务响应抽象接口。

系统能力 SystemCapability.Msdp.DeviceStatus.Stationary

属性

ActivityType

设备状态类型。

系统能力 SystemCapability.Msdp.DeviceStatus.Stationary

ActivityEvent

设备状态事件。

系统能力 SystemCapability.Msdp.DeviceStatus.Stationary

ActivityState

设备状态返回值。

系统能力 SystemCapability.Msdp.DeviceStatus.Stationary

stationary.on('still' | 'relativeStill')

on(activity: ActivityType, event: ActivityEvent, reportLatencyNs: number, callback: Callback<ActivityResponse>): void

设备状态管理，订阅设备状态服务。

系统能力 SystemCapability.Msdp.DeviceStatus.Stationary

参数：

示例：

var reportLatencyNs = 100;
stationary.on('still', stationary.ActivityEvent.ENTER, reportLatencyNs, (data) => {
    console.log('data='+ JSON.stringify(data));
})

stationary.once('still' | 'relativeStill')

once(activity: ActivityType, callback: Callback<ActivityResponse>): void

设备状态管理，查询设备状态。

系统能力 SystemCapability.Msdp.DeviceStatus.Stationary

参数：

示例：

stationary.once('still', (data) => {
    console.log("data="+ JSON.stringify(data));
})

stationary.off('still' | 'relativeStill')

off(activity: ActivityType, event: ActivityEvent, callback?: Callback<ActivityResponse>): void

设备状态管理，取消订阅设备状态服务。

系统能力 SystemCapability.Msdp.DeviceStatus.Stationary

参数：

示例：

stationary.off('still', stationary.ActivityEvent.ENTER);

@ohos.thermal (热管理)

更新时间: 2023-02-17 09:19

该模块提供热管理相关的接口，包括热档位查询及注册回调等功能。

说明

本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import thermal from '@ohos.thermal';

thermal.registerThermalLevelCallback⁹⁺

registerThermalLevelCallback(callback: Callback<ThermalLevel>): void

订阅热档位变化时的回调提醒。

系统能力： SystemCapability.PowerManager.ThermalManager

参数：

错误码：

以下错误码的详细介绍请参见​​耗电统计错误码​​。

示例：

try {
    thermal.registerThermalLevelCallback(level => {
        console.info('thermal level is: ' + level);
    });
    console.info('register thermal level callback success.');
} catch(err) {
    console.error('register thermal level callback failed, err: ' + err);
}

thermal.unregisterThermalLevelCallback⁹⁺

unregisterThermalLevelCallback(callback?: Callback<void>): void

取消订阅热档位变化时的回调提醒。

系统能力： SystemCapability.PowerManager.ThermalManager

参数：

错误码：

以下错误码的详细介绍请参见​​热管理错误码​​。

示例：

try {
    thermal.unregisterThermalLevelCallback(() => {
        console.info('unsubscribe thermal level success.');
    });
    console.info('unregister thermal level callback success.');
} catch(err) {
    console.error('unregister thermal level callback failed, err: ' + err);
}

thermal.getLevel⁹⁺

getLevel(): ThermalLevel

获取当前热档位信息。

系统能力： SystemCapability.PowerManager.ThermalManager

返回值：

错误码：

以下错误码的详细介绍请参见​​热管理错误码​​。

示例：

try {
    var level = thermal.getLevel();
    console.info('thermal level is: ' + level);
} catch(err) {
    console.error('get thermal level failed, err: ' + err);
}

thermal.subscribeThermalLevel^(deprecated)

subscribeThermalLevel(callback: AsyncCallback<ThermalLevel>): void

说明

从API version 9开始不再维护，建议使用​​thermal.registerThermalLevelCallback​​替代。

订阅热档位变化时的回调提醒。

系统能力： SystemCapability.PowerManager.ThermalManager

参数：

示例：

thermal.subscribeThermalLevel((level) => {
    console.info('thermal level is: ' + level);
});

thermal.unsubscribeThermalLevel^(deprecated)

unsubscribeThermalLevel(callback?: AsyncCallback<void>): void

说明

从API version 9开始不再维护，建议使用​​thermal.unregisterThermalLevelCallback​​替代。

取消订阅热档位变化时的回调提醒。

系统能力： SystemCapability.PowerManager.ThermalManager

参数：

示例：

thermal.unsubscribeThermalLevel(() => {
    console.info('unsubscribe thermal level success.');
});

thermal.getThermalLevel^(deprecated)

getThermalLevel(): ThermalLevel

说明

从API version 9开始不再维护，建议使用​​thermal.getLevel​​替代。

获取当前热档位信息。

系统能力： SystemCapability.PowerManager.ThermalManager

返回值：

示例：

var level = thermal.getThermalLevel();
console.info('thermal level is: ' + level);

ThermalLevel

热档位信息。

系统能力： SystemCapability.PowerManager.ThermalManager

文章转载自：​​https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/js-apis-stationary-0000001427745104-V3?catalogVersion=V3​​