Stationary开发指导

场景介绍

当应用需要获取当前设备状态时，可以调用Stationary模块，例如：需要判断当前设备处于绝对静止状态或者相对静止状态。

详细的接口介绍请参考Stationary接口。

设备状态类型参数说明

名称 描述
still 绝对静止。
relativeStill 相对静止。

订阅设备状态事件参数说明

变量 值 说明
ENTER 1 订阅进入事件。
EXIT 2 订阅退出事件。
ENTER_EXIT 3 订阅进入和退出事件。

返回设备状态参数说明

变量 值 说明
ENTER 1 返回进入状态。
EXIT 2 返回退出状态。

接口说明

模块 接口名 描述
ohos.stationary on(activity: ActivityType, event: ActivityEvent, reportLatencyNs: number, callback: Callback<ActivityResponse>): void 订阅设备状态，结果通过callback返回。
ohos.stationary once(activity: ActivityType, callback: Callback<ActivityResponse>): void 查询设备状态，结果通过callback返回。
ohos.stationary off(activity: ActivityType, event: ActivityEvent, callback?: Callback<ActivityResponse>): void 取消订阅设备状态。

约束与限制

设备需要支持加速度传感器。

开发步骤

  1. 订阅绝对静止的进入事件，1秒上报一次。

    import stationary from '@ohos.stationary';
var reportLatencyNs = 1000000000;
try {
   stationary.on('still', stationary.ActivityEvent.ENTER, reportLatencyNs, (data) => {
      console.log('data='+ JSON.stringify(data));
   })
} catch (err) {
   console.error('errCode: ' + err.code + ' ,msg: ' + err.message);
}

  2. 查询绝对静止状态的进入事件。

    import stationary from '@ohos.stationary';
try {
   stationary.once('still', (data) => {
      console.log('data='+ JSON.stringify(data));
   })
} catch (err) {
   console.error('errCode: ' + err.code + ' ,msg: ' + err.message);
}

  3. 取消订阅绝对静止状态的进入事件。

    import stationary from '@ohos.stationary';
try {
   stationary.off('still', stationary.ActivityEvent.ENTER, (data) => {
      console.log('data='+ JSON.stringify(data));
   })
} catch (err) {
   console.error('errCode: ' + err.code + ' ,msg: ' + err.message);
}