1# Stationary开发指导 2 3 4## 场景介绍 5 6当应用需要获取当前设备状态时，可以调用Stationary模块，例如：需要判断当前设备处于绝对静止状态或者相对静止状态。 7 8详细的接口介绍请参考[Stationary接口](../reference/apis/js-apis-stationary.md)。 9 10## 设备状态类型参数说明 11 12| 名称 | 描述 | 13| -------- | -------- | 14| still | 绝对静止。 | 15| relativeStill | 相对静止。 | 16 17## 订阅设备状态事件参数说明 18 19| 变量 | 值 | 说明 | 20| ------------------------------ | ---- | ---------------------------------------- | 21| ENTER | 1 | 订阅进入事件。 | 22| EXIT | 2 | 订阅退出事件。 | 23| ENTER_EXIT | 3 | 订阅进入和退出事件。 | 24 25## 返回设备状态参数说明 26 27| 变量 | 值 | 说明 | 28| ------------------------------ | ---- | ---------------------------------------- | 29| ENTER | 1 | 返回进入状态。 | 30| EXIT | 2 | 返回退出状态。 | 31 32## 接口说明 33 34| 模块 | 接口名 | 描述 | 35| ------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | 36| ohos.stationary | on(activity: ActivityType, event: ActivityEvent, reportLatencyNs: number, callback: Callback<ActivityResponse>): void | 订阅设备状态，结果通过callback返回。 | 37| ohos.stationary | once(activity: ActivityType, callback: Callback<ActivityResponse>): void | 查询设备状态，结果通过callback返回。 | 38| ohos.stationary | off(activity: ActivityType, event: ActivityEvent, callback?: Callback<ActivityResponse>): void | 取消订阅设备状态。 | 39 40## 约束与限制 41 42设备需要支持加速度传感器。 43 44## 开发步骤 45 461. 订阅绝对静止的进入事件，1秒上报一次。 47 48 ```ts 49 import stationary from '@ohos.stationary'; 50 import { BusinessError } from '@ohos.base'; 51 let reportLatencyNs = 1000000000; 52 try { 53 stationary.on('still', stationary.ActivityEvent.ENTER, reportLatencyNs, (data) => { 54 console.log('data='+ JSON.stringify(data)); 55 }) 56 } catch (error) { 57 let message = (error as BusinessError).message; 58 console.error('stationary on failed:' + message); 59 } 60 ``` 61 622. 查询绝对静止状态的进入事件。 63 64 ```ts 65 import stationary from '@ohos.stationary'; 66 import { BusinessError } from '@ohos.base'; 67 try { 68 stationary.once('still', (data) => { 69 console.log('data='+ JSON.stringify(data)); 70 }) 71 } catch (error) { 72 let message = (error as BusinessError).message; 73 console.error('stationary once failed:' + message); 74 } 75 ``` 76 773. 取消订阅绝对静止状态的进入事件。 78 79 ```ts 80 import stationary from '@ohos.stationary'; 81 import { BusinessError } from '@ohos.base'; 82 try { 83 stationary.off('still', stationary.ActivityEvent.ENTER, (data) => { 84 console.log('data='+ JSON.stringify(data)); 85 }) 86 } catch (error) { 87 let message = (error as BusinessError).message; 88 console.error('stationary off failed:' + message); 89 } 90 ``` 91