harmony 鸿蒙@ohos.stationary (设备状态感知框架)
@ohos.stationary (设备状态感知框架)
设备状态感知框架提供设备状态感知能力，包括绝对静止和相对静止。
说明：
本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
本模块不支持x86模拟器。
导入模块
import stationary from '@ohos.stationary'
ActivityResponse
服务响应抽象接口。
系统能力：SystemCapability.Msdp.DeviceStatus.Stationary
属性
| 名称 | 类型 | 可读 | 可写 | 说明 |
|---|---|---|---|---|
| state | ActivityState | 是 | 否 | 设备状态变化返回值。 |
ActivityType
设备状态类型。
系统能力：SystemCapability.Msdp.DeviceStatus.Stationary
| 名称 | 说明 |
|---|---|
| still | 绝对静止。 |
| relativeStill | 相对静止。 |
ActivityEvent
设备状态事件。
系统能力：SystemCapability.Msdp.DeviceStatus.Stationary
| 名称 | 值 | 说明 |
|---|---|---|
| ENTER | 1 | 进入。 |
| EXIT | 2 | 退出。 |
| ENTER_EXIT | 3 | 进入和退出。 |
ActivityState
设备状态返回值。
系统能力：SystemCapability.Msdp.DeviceStatus.Stationary
| 名称 | 值 | 说明 |
|---|---|---|
| ENTER | 1 | 进入。 |
| EXIT | 2 | 退出。 |
stationary.on(‘still’|‘relativeStill’)
on(activity: ActivityType, event: ActivityEvent, reportLatencyNs: number, callback: Callback<ActivityResponse>): void
设备状态管理，订阅设备状态服务。
系统能力：SystemCapability.Msdp.DeviceStatus.Stationary
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| activity | ActivityType | 是 | 设备状态能力类型。 |
| event | ActivityEvent | 是 | 事件类型。 |
| reportLatencyNs | number | 是 | 报告延时。 |
| callback | Callback<ActivityResponse> | 是 | 回调函数，接收上报状态变化事件。 |
示例：
let 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
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| activity | ActivityType | 是 | 设备状态能力类型。 |
| callback | Callback<ActivityResponse> | 是 | 回调函数，接收上报状态变化事件。 |
示例：
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
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| activity | ActivityType | 是 | 设备状态能力类型。 |
| event | ActivityEvent | 是 | 事件类型。 |
| callback | Callback：<ActivityResponse> | 否 | 回调函数，接收上报状态变化事件，如果没有传递callback参数或者传递的类型是undefined，会移除该进程下订阅该类型得所有callback。 |
示例：
stationary.off('still', stationary.ActivityEvent.ENTER);
你可能感兴趣的鸿蒙文章
harmony 鸿蒙BundleStatusCallback
harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)
harmony 鸿蒙@ohos.distributedBundle (分布式包管理)
harmony 鸿蒙@ohos.bundle (Bundle模块)
harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)
- 所属分类： 后端技术
- 本文标签：
热门推荐
-
2、 - 优质文章
-
3、 gate.io
-
6、 golang
-
7、 openharmony