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

  • 2022-12-05
  • 浏览 (689)

@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&lt;ActivityResponse&gt;): 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&lt;ActivityResponse&gt;): void

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

系统能力:SystemCapability.Msdp.DeviceStatus.Stationary

参数:

参数名 类型 必填 说明
activity ActivityType 设备状态能力类型。
event ActivityEvent 事件类型。
callback Callback:<ActivityResponse> 回调函数,接收上报状态变化事件,如果没有传递callback参数或者传递的类型是undefined,会移除该进程下订阅该类型得所有callback。

示例:

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

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述(仅对系统应用开放)

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)

0  赞