Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
3d9c131d
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
3d9c131d
编写于
11月 28, 2022
作者:
M
mayunteng_1
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
add msdp device_status js doc Signed-off-by:mayunteng_1<mayunteng@huawei.com>
Signed-off-by:
N
mayunteng_1
<
mayunteng@huawei.com
>
上级
e1585bda
变更
2
显示空白变更内容
内联
并排
Showing
2 changed file
with
130 addition
and
0 deletion
+130
-0
zh-cn/application-dev/reference/apis/Readme-CN.md
zh-cn/application-dev/reference/apis/Readme-CN.md
+1
-0
zh-cn/application-dev/reference/apis/js-apis-devicestatus.md
zh-cn/application-dev/reference/apis/js-apis-devicestatus.md
+129
-0
未找到文件。
zh-cn/application-dev/reference/apis/Readme-CN.md
浏览文件 @
3d9c131d
...
...
@@ -231,6 +231,7 @@
-
[
@ohos.batteryStatistics (耗电统计)
](
js-apis-batteryStatistics.md
)
-
[
@ohos.brightness (屏幕亮度)
](
js-apis-brightness.md
)
-
[
@ohos.deviceInfo (设备信息)
](
js-apis-device-info.md
)
-
[
@ohos.devicestatus (设备状态感知框架)
](
js-apis-devicestatus.md
)
-
[
@ohos.distributedHardware.deviceManager (设备管理)
](
js-apis-device-manager.md
)
-
[
@ohos.geoLocationManager (位置服务)
](
js-apis-geoLocationManager.md
)
-
[
@ohos.multimodalInput.inputConsumer (组合按键)
](
js-apis-inputconsumer.md
)
...
...
zh-cn/application-dev/reference/apis/js-apis-devicestatus.md
0 → 100644
浏览文件 @
3d9c131d
# 设备状态感知框架
设备状态感知框架提供设备状态感知能力,包括绝对静止和相对静止。
> **说明:**
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
js
import
deviceStatus
from
'
@ohos.devicestatus
'
```
## ActivityResponse
服务响应抽象接口。
**系统能力**
SystemCapability.Msdp.DeviceStatus.Stationary
### 属性
| 名称 | 参数类型 | 可读 | 可写 | 说明 |
| -------- | -------- | -------- | -------- | -------- |
| state |
[
ActivityState
](
#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 | 退出。 |
## deviceStatus.on('still' | 'relativeStill')
on(activity: ActivityType, event: ActivityEvent, reportLatencyNs: number, callback: Callback
<
ActivityResponse
>
): void
设备状态管理,订阅设备状态服务。
**系统能力**
SystemCapability.Msdp.DeviceStatus.Stationary
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| -------------------- | -------------------------------------------------- | ---- | ---------------------------- |
| activity |
[
ActivityType
](
#activitytype
)
| 是 | 设备状态能力类型。 |
| event |
[
ActivityEvent
](
#activityevent
)
| 是 | 事件类型。 |
| reportLatencyNs | number | 是 | 报告延时。 |
| callback | Callback<
[
ActivityResponse
](
#activityresponse
)
\>
| 是 | 回调函数,接收上报状态变化事件。 |
**示例:**
```
js
var
reportLatencyNs
=
100
;
deviceStatus
.
on
(
'
still
'
,
deviceStatus
.
ActivityEvent
.
ENTER
,
reportLatencyNs
,
(
data
)
=>
{
console
.
log
(
'
data=
'
+
JSON
.
stringify
(
data
));
})
```
## deviceStatus.once('still' | 'relativeStill')
once(activity: ActivityType, callback: Callback
<
ActivityResponse
>
): void
设备状态管理,查询设备状态。
**系统能力**
SystemCapability.Msdp.DeviceStatus.Stationary
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| -------------------- | -------------------------------------------------- | ---- | ---------------------------- |
| activity |
[
ActivityType
](
#activitytype
)
| 是 | 设备状态能力类型。 |
| callback | Callback<
[
ActivityResponse
](
#activityresponse
)
\>
| 是 | 回调函数,接收上报状态变化事件。 |
**示例:**
```
js
deviceStatus
.
once
(
'
still
'
,
(
data
)
=>
{
console
.
log
(
"
data=
"
+
JSON
.
stringify
(
data
));
})
```
## deviceStatus.off('still' | 'relativeStill')
off(activity: ActivityType, event: ActivityEvent, callback?: Callback
<
ActivityResponse
>
): void
设备状态管理,取消订阅设备状态服务。
**系统能力**
SystemCapability.Msdp.DeviceStatus.Stationary
**参数:**
| 名称 | 类型 | 必填 | 说明 |
| -------------------- | -------------------------------------------------- | ---- | ---------------------------- |
| activity |
[
ActivityType
](
#activitytype
)
| 是 | 设备状态能力类型。 |
| event |
[
ActivityEvent
](
#activityevent
)
| 是 | 事件类型。 |
| callback | Callback<
[
ActivityResponse
](
#activityresponse
)
\>
| 否 | 回调函数,接收上报状态变化事件。 |
**示例:**
```
js
deviceStatus
.
off
(
'
still
'
,
deviceStatus
.
ActivityEvent
.
ENTER
);
```
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录