!14223 Add msdp stationary guidelines

Merge pull request !14223 from 范豆豆/20230129_add_guide

zh-cn/application-dev/device/Readme-CN.md

@@ -17,3 +17,5 @@
 - 升级服务
   - [示例服务器开发概述](sample-server-overview.md)
   - [示例服务器开发指导](sample-server-guidelines.md)
+- 设备状态
+  - [设备状态开发指导](stationary-guidelines.md)

zh-cn/application-dev/device/stationary-guidelines.md

+# Stationary开发指导
+
+
+## 场景介绍
+
+当应用需要获取当前设备状态时，可以调用Stationary模块，例如：需要判断当前设备处于绝对静止状态或者相对静止状态。
+
+详细的接口介绍请参考[Stationary接口](../reference/apis/js-apis-stationary.md)。
+
+## 设备状态类型参数说明
+
+| 名称 | 描述 |
+| -------- | -------- |
+| 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秒上报一次。
+
+   ```js
+   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. 查询绝对静止状态的进入事件。
+
+   ```js
+   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. 取消订阅绝对静止状态的进入事件。
+
+   ```js
+   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);
+   }
+   ```