Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
650c7b38
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看板
提交
650c7b38
编写于
11月 30, 2022
作者:
C
cff-gite
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
修改docs资料
Signed-off-by:
N
cff-gite
<
chenfeifei8@huawei.com
>
上级
65649aaf
变更
5
隐藏空白更改
内联
并排
Showing
5 changed file
with
72 addition
and
27 deletion
+72
-27
zh-cn/application-dev/device/sensor-guidelines.md
zh-cn/application-dev/device/sensor-guidelines.md
+17
-17
zh-cn/application-dev/device/vibrator-guidelines.md
zh-cn/application-dev/device/vibrator-guidelines.md
+55
-10
zh-cn/figures/171e6f30-a8d9-414c-bafa-b430340305fb.png
zh-cn/figures/171e6f30-a8d9-414c-bafa-b430340305fb.png
+0
-0
zh-cn/figures/65d69983-29f6-4381-80a3-f9ef2ec19e53.png
zh-cn/figures/65d69983-29f6-4381-80a3-f9ef2ec19e53.png
+0
-0
zh-cn/figures/db5d017d-6c1c-4a71-a2dd-f74b7f23239e.png
zh-cn/figures/db5d017d-6c1c-4a71-a2dd-f74b7f23239e.png
+0
-0
未找到文件。
zh-cn/application-dev/device/sensor-guidelines.md
浏览文件 @
650c7b38
...
...
@@ -24,9 +24,9 @@
| 模块 | 接口名 | 描述 |
| -------- | -------- | -------- |
| ohos.sensor | sensor.on(sensor
Type
, callback:AsyncCallback
<
Response
>
): void | 持续监听传感器数据变化 |
| ohos.sensor | sensor.once(sensor
Type
, callback:AsyncCallback
<
Response
>
): void | 获取一次传感器数据变化 |
| ohos.sensor | sensor.off(sensor
Type
, callback?:AsyncCallback
<
void
>
): void | 注销传感器数据的监听 |
| ohos.sensor | sensor.on(sensor
Id
, callback:AsyncCallback
<
Response
>
): void | 持续监听传感器数据变化 |
| ohos.sensor | sensor.once(sensor
Id
, callback:AsyncCallback
<
Response
>
): void | 获取一次传感器数据变化 |
| ohos.sensor | sensor.off(sensor
Id
, callback?:AsyncCallback
<
void
>
): void | 注销传感器数据的监听 |
## 开发步骤
...
...
@@ -45,47 +45,47 @@
2.
持续监听传感器数据变化。
```
```
js
import
sensor
from
"
@ohos.sensor
"
;
sensor.on(sensor.Sensor
Type.SENSOR_TYPE_ID_
ACCELEROMETER, function(data){
sensor
.
on
(
sensor
.
Sensor
Id
.
ACCELEROMETER
,
function
(
data
){
console
.
info
(
"
Data obtained successfully. x:
"
+
data
.
x
+
"
y:
"
+
data
.
y
+
"
z:
"
+
data
.
z
);
// 获取数据成功
});
```
以Sensor
Type为SENSOR_TYPE_ID_
ACCELEROMETER为例展示运行结果,持续监听传感器接口的结果如下图所示:
以Sensor
Id为
ACCELEROMETER为例展示运行结果,持续监听传感器接口的结果如下图所示:
!
[
zh-cn_image_0000001241693881
](
figures/zh-cn_image_0000001241693881
.png
)
!
[
171e6f30-a8d9-414c-bafa-b430340305f
](
D:\docs\docs\zh-cn\figures\171e6f30-a8d9-414c-bafa-b430340305fb
.png
)
3.
注销传感器数据监听。
```
```
js
import
sensor
from
"
@ohos.sensor
"
;
sensor.off(sensor.Sensor
Type.SENSOR_TYPE_ID_
ACCELEROMETER);
sensor
.
off
(
sensor
.
Sensor
Id
.
ACCELEROMETER
);
```
以Sensor
Type为SENSOR_TYPE_ID_
ACCELEROMETER为例展示运行结果,注销传感器成功结果如下图所示:
以Sensor
Id为
ACCELEROMETER为例展示运行结果,注销传感器成功结果如下图所示:
!
[
zh-cn_image_0000001196654004
](
figures/zh-cn_image_0000001196654004
.png
)
!
[
65d69983-29f6-4381-80a3-f9ef2ec19e53
](
D:\docs\docs\zh-cn\figures\65d69983-29f6-4381-80a3-f9ef2ec19e53
.png
)
4.
获取一次传感器数据变化。
```
```
js
import
sensor
from
"
@ohos.sensor
"
;
sensor.once(sensor.Sensor
Type.SENSOR_TYPE_ID_
ACCELEROMETER, function(data) {
sensor
.
once
(
sensor
.
Sensor
Id
.
ACCELEROMETER
,
function
(
data
)
{
console
.
info
(
"
Data obtained successfully. x:
"
+
data
.
x
+
"
y:
"
+
data
.
y
+
"
z:
"
+
data
.
z
);
// 获取数据成功
});
```
以Sensor
Type为SENSOR_TYPE_ID_
ACCELEROMETER为例展示运行结果,获取数据成功日志如下图所示:
以Sensor
Id为
ACCELEROMETER为例展示运行结果,获取数据成功日志如下图所示:
!
[
zh-cn_image_0000001241733907
](
figures/zh-cn_image_0000001241733907
.png
)
!
[
db5d017d-6c1c-4a71-a2dd-f74b7f23239e
](
D:\docs\docs\zh-cn\figures\db5d017d-6c1c-4a71-a2dd-f74b7f23239e
.png
)
若接口调用不成功,建议使用try/catch语句捕获代码中可能出现的错误信息。例如:
```
```
js
import sensor from "@ohos.sensor";
try {
sensor.once(sensor.Sensor
Type.SENSOR_TYPE_ID_
ACCELEROMETER, function(data) {
sensor.once(sensor.Sensor
Id.
ACCELEROMETER, function(data) {
console.info("Data obtained successfully. x: " + data.x + "y: " + data.y + "z: " + data.z);// 获取数据成功
});
} catch (error) {
...
...
zh-cn/application-dev/device/vibrator-guidelines.md
浏览文件 @
650c7b38
...
...
@@ -10,14 +10,18 @@
## 接口说明
| 模块 | 接口名 | 描述 |
| ------------- | ---------------------------------------- | ------------------------------- |
| ohos.vibrator | vibrate(duration:
number):
Promise
<
void
>
| 触发马达按照时长振动,使用Promise异步回调。 |
| ohos.vibrator | vibrate(duration:
number,
callback?:
AsyncCallback
<
void
>
):
void | 触发马达按照时长振动,使用Callback异步回调。 |
| ohos.vibrator | vibrate(effectId:
EffectId):
Promise
<
void
>
| 触发马达按照开发者传递效果振动,使用Promise异步回调。 |
| ohos.vibrator | vibrate(effectId:
EffectId,
callback?:
AsyncCallback
<
void
>
):
void | 触发马达按照开发者传递效果振动,使用Callback异步回调。 |
| ohos.vibrator | stop(stopMode:
VibratorStopMode):
Promise
<
void
>
| 停止振动。 |
| ohos.vibrator | stop(stopMode:
VibratorStopMode,
callback?:
AsyncCallback
<
void
>
):
void | 停止振动。 |
| 模块 | 接口名 | 描述 |
| ------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| ohos.vibrator | vibrate(duration:
number):
Promise
<
void
>
| 触发马达按照时长振动,使用Promise异步回调。 |
| ohos.vibrator | vibrate(duration:
number,
callback?:
AsyncCallback
<
void
>
):
void | 触发马达按照时长振动,使用Callback异步回调。 |
| ohos.vibrator | vibrate(effectId:
EffectId):
Promise
<
void
>
| 触发马达按照开发者传递效果振动,使用Promise异步回调。 |
| ohos.vibrator | vibrate(effectId:
EffectId,
callback?:
AsyncCallback
<
void
>
):
void | 触发马达按照开发者传递效果振动,使用Callback异步回调。 |
| ohos.vibrator | startVibration(effect: VibrateEffect, attribute: VibrateAttribute): Promise
<
void
>
| 根据指定振动效果和振动属性触发马达振动,使用Promise异步回调。 |
| ohos.vibrator | startVibration(effect: VibrateEffect, attribute: VibrateAttribute, callback: AsyncCallback
<
void
>
): void | 根据指定振动效果和振动属性触发马达振动,使用Callback异步回调。 |
| ohos.vibrator | stop(stopMode:
VibratorStopMode):
Promise
<
void
>
| 停止振动。 |
| ohos.vibrator | stop(stopMode:
VibratorStopMode,
callback?:
AsyncCallback
<
void
>
):
void | 停止振动。 |
| ohos.vibrator | stopVibration(stopMode: VibratorStopMode): Promise
<
void
>
| 按照指定模式停止马达的振动。 |
| ohos.vibrator | stopVibration(stopMode: VibratorStopMode, callback: AsyncCallback
<
void
>
): void | 按照指定模式停止马达的振动。 |
## 开发步骤
...
...
@@ -26,7 +30,7 @@
2.
触发设备振动。
```
```
js
import
vibrator
from
"
@ohos.vibrator
"
vibrator
.
vibrate
(
1000
).
then
((
error
)
=>
{
if
(
error
)
{
//调用失败,打印error.code和error.message
...
...
@@ -39,7 +43,7 @@
3.
停止设备振动。
```
```
js
import
vibrator
from
"
@ohos.vibrator
"
vibrator
.
stop
(
vibrator
.
VibratorStopMode
.
VIBRATOR_STOP_MODE_PRESET
).
then
((
error
)
=>
{
if
(
error
)
{
//调用失败,打印error.code和error.message
...
...
@@ -50,6 +54,47 @@
})
```
4.
根据指定振动效果和振动属性触发马达振动 。
```
js
try
{
vibrator
.
startVibration
({
type
:
'
time
'
,
duration
:
1000
,
},
{
id
:
0
,
usage
:
'
alarm
'
},
(
error
)
=>
{
if
(
error
)
{
console
.
error
(
'
vibrate fail, error.code:
'
+
error
.
code
+
'
error.message:
'
,
+
error
.
message
);
return
;
}
console
.
log
(
'
Callback returned to indicate a successful vibration.
'
);
});
}
catch
(
err
)
{
console
.
error
(
'
errCode:
'
+
err
.
code
+
'
,msg:
'
+
err
.
message
);
}
```
5.
按照指定模式停止马达的振动。
```
js
try
{
// 按照VIBRATOR_STOP_MODE_TIME模式停止振动
vibrator
.
stopVibration
(
vibrator
.
VibratorStopMode
.
VIBRATOR_STOP_MODE_TIME
,
function
(
error
)
{
if
(
error
)
{
console
.
log
(
'
error.code
'
+
error
.
code
+
'
error.message
'
+
error
.
message
);
return
;
}
console
.
log
(
'
Callback returned to indicate successful.
'
);
})
}
catch
(
err
)
{
console
.
info
(
'
errCode:
'
+
err
.
code
+
'
,msg:
'
+
err
.
message
);
}
```
## 相关实例
针对振动开发,有以下相关实例可供参考:
...
...
zh-cn/figures/171e6f30-a8d9-414c-bafa-b430340305fb.png
0 → 100644
浏览文件 @
650c7b38
750.3 KB
zh-cn/figures/65d69983-29f6-4381-80a3-f9ef2ec19e53.png
0 → 100644
浏览文件 @
650c7b38
114.7 KB
zh-cn/figures/db5d017d-6c1c-4a71-a2dd-f74b7f23239e.png
0 → 100644
浏览文件 @
650c7b38
155.9 KB
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录