Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
81857245
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看板
未验证
提交
81857245
编写于
9月 16, 2022
作者:
O
openharmony_ci
提交者:
Gitee
9月 16, 2022
浏览文件
操作
浏览文件
下载
差异文件
!9514 修改docs文档
Merge pull request !9514 from 陈飞飞/master
上级
af85432a
535a0e8d
变更
2
显示空白变更内容
内联
并排
Showing
2 changed file
with
114 addition
and
91 deletion
+114
-91
zh-cn/application-dev/reference/apis/js-apis-sensor.md
zh-cn/application-dev/reference/apis/js-apis-sensor.md
+80
-69
zh-cn/application-dev/reference/apis/js-apis-vibrator.md
zh-cn/application-dev/reference/apis/js-apis-vibrator.md
+34
-22
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-sensor.md
浏览文件 @
81857245
...
...
@@ -29,7 +29,7 @@ on(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback: Callback<Acceler
监听加速度传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。
**需要权限**
:ohos.permission.ACCELEROMETER
,该权限为系统权限
**需要权限**
:ohos.permission.ACCELEROMETER,该权限为系统权限
**系统能力**
:SystemCapability.Sensors.Sensor
...
...
@@ -52,7 +52,7 @@ on(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback: Callback<Acceler
);
```
### LINEAR_ACCELERATION<sup>
deprecated
</sup>
### LINEAR_ACCELERATION<sup>
(deprecated)
</sup>
on(type: SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION,callback:Callback
<
LinearAccelerometerResponse
>
, options?: Options): void
...
...
@@ -60,7 +60,7 @@ on(type: SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION,callback:Callback<Line
从API Version9开始该接口不再维护,推荐使用sensor.on.LINEAR_ACCELEROMETER
<sup>
9+
</sup>
**需要权限**
:ohos.permission.ACCELEROMETER
,该权限为系统权限
**需要权限**
:ohos.permission.ACCELEROMETER,该权限为系统权限
**系统能力**
:SystemCapability.Sensors.Sensor
...
...
@@ -116,7 +116,7 @@ on(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED,callback: Callback
监听未校准加速度计传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。
**需要权限**
:ohos.permission.ACCELEROMETER
,该权限为系统权限
**需要权限**
:ohos.permission.ACCELEROMETER,该权限为系统权限
**系统能力**
:SystemCapability.Sensors.Sensor
...
...
@@ -173,7 +173,7 @@ on(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE, callback: Callback<GyroscopeRes
监听陀螺仪传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。
**需要权限**
:ohos.permission.GYROSCOPE
,该权限为系统权限
**需要权限**
:ohos.permission.GYROSCOPE,该权限为系统权限
**系统能力**
:SystemCapability.Sensors.Sensor
...
...
@@ -201,7 +201,7 @@ on(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED,callback:Callback<G
监听未校准陀螺仪传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。
**需要权限**
:ohos.permission.GYROSCOPE
,该权限为系统权限
**需要权限**
:ohos.permission.GYROSCOPE,该权限为系统权限
**系统能力**
:SystemCapability.Sensors.Sensor
...
...
@@ -304,7 +304,7 @@ on(type: SensorType.SENSOR_TYPE_ID_PEDOMETER, callback: Callback<PedometerRes
### AMBIENT_TEMPERATURE
on(type:SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE,callback:Callback
<
AmbientTemperatureResponse
>
, options?: Options): void
on(type:
SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE,callback:Callback
<
AmbientTemperatureResponse
>
, options?: Options): void
监听环境温度传感器的数据变化。如果多次调用该接口,仅最后一次调用生效。
...
...
@@ -318,6 +318,7 @@ on(type:SensorType.SENSOR_TYPE_ID_AMBIENT_TEMPERATURE,callback:Callback<Ambie
| options |
[
Options
](
#options
)
| 否 | 可选参数列表,设置上报频率,默认值为200000000ns。 |
**示例:**
```
js
sensor
.
on
(
sensor
.
SensorType
.
SENSOR_TYPE_ID_AMBIENT_TEMPERATURE
,
function
(
data
){
console
.
info
(
'
Temperature:
'
+
data
.
temperature
);
...
...
@@ -335,6 +336,7 @@ on(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, callback: Callback<Magneti
**系统能力**
:SystemCapability.Sensors.Sensor
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ---------------------------------------- |
| type |
[
SensorType
](
#sensortype
)
| 是 | 要订阅的磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD。 |
...
...
@@ -361,6 +363,7 @@ on(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED,callback: Callbac
**系统能力**
:SystemCapability.Sensors.Sensor
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ---------------------------------------- |
| type |
[
SensorType
](
#sensortype
)
| 是 | 要订阅的未校准磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED。 |
...
...
@@ -421,6 +424,7 @@ on(type: SensorType.SENSOR_TYPE_ID_HUMIDITY, callback: Callback<HumidityRespo
| options |
[
Options
](
#options
)
| 否 | 可选参数列表,设置上报频率,默认值为200000000ns。 |
**示例:**
```
js
sensor
.
on
(
sensor
.
SensorType
.
SENSOR_TYPE_ID_HUMIDITY
,
function
(
data
){
console
.
info
(
'
Humidity:
'
+
data
.
humidity
);
...
...
@@ -438,6 +442,7 @@ on(type: SensorType.SENSOR_TYPE_ID_BAROMETER, callback: Callback<BarometerRes
**系统能力**
:SystemCapability.Sensors.Sensor
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ---------------------------------------- |
| type |
[
SensorType
](
#sensortype
)
| 是 | 要订阅的气压计传感器类型为SENSOR_TYPE_ID_BAROMETER。 |
...
...
@@ -445,6 +450,7 @@ on(type: SensorType.SENSOR_TYPE_ID_BAROMETER, callback: Callback<BarometerRes
| options |
[
Options
](
#options
)
| 否 | 可选参数列表,设置上报频率,默认值为200000000ns。 |
**示例:**
```
js
sensor
.
on
(
sensor
.
SensorType
.
SENSOR_TYPE_ID_BAROMETER
,
function
(
data
){
console
.
info
(
'
Atmospheric pressure:
'
+
data
.
pressure
);
...
...
@@ -527,7 +533,7 @@ on(type: SensorType.SENSOR_TYPE_ID_ORIENTATION, callback: Callback<Orientatio
);
```
### HEART_RATE<sup>
deprecated
</sup>
### HEART_RATE<sup>
(deprecated)
</sup>
on(type: SensorType.SENSOR_TYPE_ID_HEART_RATE, callback: Callback
<
HeartRateResponse
>
, options?: Options): void
...
...
@@ -642,11 +648,12 @@ once(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback: Callback<Accele
监听加速度传感器的数据变化一次。
**需要权限**
:ohos.permission.ACCELEROMETER
,该权限为系统权限
**需要权限**
:ohos.permission.ACCELEROMETER,该权限为系统权限
**系统能力**
:SystemCapability.Sensors.Sensor
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ---------------------------------------- |
| type |
[
SensorType
](
#sensortype
)
| 是 | 加速度传感器类型为SENSOR_TYPE_ID_ACCELEROMETER。 |
...
...
@@ -662,7 +669,7 @@ once(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER, callback: Callback<Accele
);
```
### LINEAR_ACCELERATION<sup>
deprecated
</sup>
### LINEAR_ACCELERATION<sup>
(deprecated)
</sup>
once(type: SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION,callback:Callback
<
LinearAccelerometerResponse
>
): void
...
...
@@ -670,7 +677,7 @@ once(type: SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION,callback:Callback<Li
从API Version9开始该接口不再维护,推荐使用sensor.once.LINEAR_ACCELEROMETER
<sup>
9+
</sup>
**需要权限**
:ohos.permission.ACCELEROMETER
,该权限为系统权限
**需要权限**
:ohos.permission.ACCELEROMETER,该权限为系统权限
**系统能力**
:SystemCapability.Sensors.Sensor
...
...
@@ -696,7 +703,7 @@ once(type: SensorType.SENSOR_TYPE_ID_LINEAR_ACCELEROMETER,callback:Callback<L
订阅一次线性加速度传感器数据。
**需要权限**
:ohos.permission.ACCELEROMETER
,该权限为系统权限
**需要权限**
:ohos.permission.ACCELEROMETER,该权限为系统权限
**系统能力**
:SystemCapability.Sensors.Sensor
...
...
@@ -722,7 +729,7 @@ once(type: SensorType.SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED,callback: Callba
监听未校准加速度传感器的数据变化一次。
**需要权限**
:ohos.permission.ACCELEROMETER
,该权限为系统权限
**需要权限**
:ohos.permission.ACCELEROMETER,该权限为系统权限
**系统能力**
:SystemCapability.Sensors.Sensor
...
...
@@ -775,7 +782,7 @@ once(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE, callback: Callback<GyroscopeR
监听陀螺仪传感器的数据变化一次。
**需要权限**
:ohos.permission.GYROSCOPE
,该权限为系统权限
**需要权限**
:ohos.permission.GYROSCOPE,该权限为系统权限
**系统能力**
:SystemCapability.Sensors.Sensor
...
...
@@ -801,7 +808,7 @@ once(type: SensorType.SENSOR_TYPE_ID_GYROSCOPE_UNCALIBRATED,callback: Callback&l
监听未校准陀螺仪传感器的数据变化一次。
**需要权限**
:ohos.permission.GYROSCOPE
,该权限为系统权限
**需要权限**
:ohos.permission.GYROSCOPE,该权限为系统权限
**系统能力**
:SystemCapability.Sensors.Sensor
...
...
@@ -925,6 +932,7 @@ once(type: SensorType.SENSOR_TYPE_ID_MAGNETIC_FIELD, callback: Callback<Magne
**系统能力**
:SystemCapability.Sensors.Sensor
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ---------------------------------------- |
| type |
[
SensorType
](
#sensortype
)
| 是 | 磁场传感器类型为SENSOR_TYPE_ID_MAGNETIC_FIELD。 |
...
...
@@ -976,6 +984,7 @@ once(type: SensorType.SENSOR_TYPE_ID_PROXIMITY, callback: Callback<ProximityR
**系统能力**
:SystemCapability.Sensors.Sensor
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ---------------------------------------- |
| type |
[
SensorType
](
#sensortype
)
| 是 | 接近光传感器类型为SENSOR_TYPE_ID_PROXIMITY。 |
...
...
@@ -1064,12 +1073,14 @@ once(type: SensorType.SENSOR_TYPE_ID_AMBIENT_LIGHT, callback: Callback<LightR
**系统能力**
:SystemCapability.Sensors.Sensor
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | -------------------------------------- |
| type |
[
SensorType
](
#sensortype
)
| 是 | 环境光传感器类型为SENSOR_TYPE_ID_AMBIENT_LIGHT。 |
| callback | Callback
<
[LightResponse](#lightresponse)
>
| 是 | 注册一次环境光传感器的回调函数,上报的数据类型为LightResponse。 |
**示例:**
```
js
sensor
.
once
(
sensor
.
SensorType
.
SENSOR_TYPE_ID_AMBIENT_LIGHT
,
function
(
data
)
{
console
.
info
(
'
Illumination:
'
+
data
.
intensity
);
...
...
@@ -1126,7 +1137,7 @@ once(type: SensorType.SENSOR_TYPE_ID_ROTATION_VECTOR, callback: Callback<Rota
);
```
### HEART_RATE<sup>
deprecated
</sup>
### HEART_RATE<sup>
(deprecated)
</sup>
once(type: SensorType.SENSOR_TYPE_ID_HEART_RATE, callback: Callback
<
HeartRateResponse
>
): void
...
...
@@ -1437,7 +1448,7 @@ function callback(data) {
sensor
.
off
(
sensor
.
SensorType
.
SENSOR_TYPE_ID_HALL
,
callback
);
```
### HEART_RATE<sup>
deprecated
</sup>
### HEART_RATE<sup>
(deprecated)
</sup>
off(type: SensorType.SENSOR_TYPE_ID_HEART_RATE, callback?: Callback
<
HeartRateResponse
>
): void
...
...
@@ -1515,7 +1526,7 @@ function callback(data) {
sensor
.
off
(
sensor
.
SensorType
.
SENSOR_TYPE_ID_HUMIDITY
,
callback
);
```
### LINEAR_ACCELERATION<sup>
deprecated
</sup>
### LINEAR_ACCELERATION<sup>
(deprecated)
</sup>
off(type: SensorType.SENSOR_TYPE_ID_LINEAR_ACCELERATION, callback?: Callback
<
LinearAccelerometerResponse
>
): void
...
...
@@ -2385,7 +2396,7 @@ createRotationMatrix(gravity: Array<number>, geomagnetic: Array<number&
## sensor.getSensorLists<sup>9+</sup>
getSensorLists(callback: AsyncCallback
<Array
&
lt
;
s
ensor
&
gt
;
>
): void
getSensorLists(callback: AsyncCallback
<Array
&
lt
;
S
ensor
&
gt
;
>
): void
获取设备上的所有传感器信息。
...
...
@@ -2394,19 +2405,19 @@ createRotationMatrix(gravity: Array<number>, geomagnetic: Array<number&
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------------------------- | ---- | ---------------- |
| callback | AsyncCallback
<Array
&
lt
;[
Sensor
](
#sensor
)&
gt
;
>
| 是 | 返回传感器列表。 |
| -------- | ---------------------------------------------
-
| ---- | ---------------- |
| callback | AsyncCallback
<Array
&
lt
;[
Sensor
](
#sensor
9
)&
gt
;
>
| 是 | 返回传感器列表。 |
**示例:**
```
js
sensor
.
getSensorList
((
error
,
data
)
=>
{
sensor
.
getSensorList
s
((
error
,
data
)
=>
{
if
(
error
)
{
console
.
error
(
'
getSensorList failed
'
);
console
.
error
(
'
getSensorList
s
failed
'
);
}
else
{
console
.
info
(
"
getSensorList callback in
"
+
data
.
length
);
console
.
info
(
"
getSensorList
s
callback in
"
+
data
.
length
);
for
(
var
i
=
0
;
i
<
data
.
length
;
i
++
)
{
console
.
info
(
"
getSensorList
"
+
JSON
.
stringify
(
data
[
i
]));
console
.
info
(
"
getSensorList
s
"
+
JSON
.
stringify
(
data
[
i
]));
}
}
});
...
...
@@ -2423,25 +2434,25 @@ sensor.getSensorList((error, data) => {
**返回值:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | --------------------------------------- | ---- | ---------------- |
| promise | Promise
<Array
&
lt
;[
Sensor
](
#sensor
)&
gt
;
>
| 是 | 返回传感器列表。 |
| ------- | ---------------------------------------
-
| ---- | ---------------- |
| promise | Promise
<Array
&
lt
;[
Sensor
](
#sensor
9
)&
gt
;
>
| 是 | 返回传感器列表。 |
**示例:**
```
js
sensor
.
getSensorList
().
then
((
data
)
=>
{
console
.
info
(
"
getSensorList promise in
"
+
data
.
length
);
sensor
.
getSensorList
s
().
then
((
data
)
=>
{
console
.
info
(
"
getSensorList
s
promise in
"
+
data
.
length
);
for
(
var
i
=
0
;
i
<
data
.
length
;
i
++
)
{
console
.
info
(
"
getSensorList
"
+
JSON
.
stringify
(
data
[
i
]));
console
.
info
(
"
getSensorList
s
"
+
JSON
.
stringify
(
data
[
i
]));
}
},
(
error
)
=>
{
console
.
error
(
'
getSensorList failed
'
);
console
.
error
(
'
getSensorList
s
failed
'
);
});
```
## sensor.getSingleSensor<sup>9+</sup>
getSingleSensor(type
:SensorType, callback: AsyncCallback
<
s
ensor
>
): void
getSingleSensor(type
: SensorType, callback: AsyncCallback
<
S
ensor
>
): void
获取指定类型的传感器信息。
...
...
@@ -2450,9 +2461,9 @@ getSingleSensor(type:SensorType, callback: AsyncCallback<sensor>): void
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------------------- | ---- | ---------------- |
| -------- | --------------------------------------
-
| ---- | ---------------- |
| type | SensorType | 是 | 传感器类型。 |
| callback | AsyncCallback
<
[Sensor](#sensor)
>
| 是 | 返回传感器信息。 |
| callback | AsyncCallback
<
[Sensor](#sensor
9
)
>
| 是 | 返回传感器信息。 |
**示例:**
...
...
@@ -2468,7 +2479,7 @@ getSingleSensor(type:SensorType, callback: AsyncCallback<sensor>): void
## sensor.getSingleSensor<sup>9+</sup>
getSingleSensor(type: SensorType
,
): Promise
<
Sensor
>
getSingleSensor(type: SensorType): Promise
<
Sensor
>
获取指定类型的传感器信息。
...
...
@@ -2483,8 +2494,8 @@ getSingleSensor(type:SensorType, callback: AsyncCallback<sensor>): void
**返回值:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | -------------------------------- | ---- | ---------------- |
| promise | Promise
<
[Sensor](#sensor)
>
| 是 | 返回传感器信息。 |
| ------- | --------------------------------
-
| ---- | ---------------- |
| promise | Promise
<
[Sensor](#sensor
9
)
>
| 是 | 返回传感器信息。 |
**示例:**
...
...
@@ -2504,7 +2515,7 @@ sensor.getSingleSensor(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER).then((dat
| 名称 | 默认值 | 说明 |
| ----------------------------------------
| ---- |
----------- |
| ----------------------------------------
----------------- | ------ | -----------
----------- |
| SENSOR_TYPE_ID_ACCELEROMETER | 1 | 加速度传感器。 |
| SENSOR_TYPE_ID_GYROSCOPE | 2 | 陀螺仪传感器。 |
| SENSOR_TYPE_ID_AMBIENT_LIGHT | 5 | 环境光传感器。 |
...
...
@@ -2515,8 +2526,8 @@ sensor.getSingleSensor(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER).then((dat
| SENSOR_TYPE_ID_HUMIDITY | 13 | 湿度传感器。 |
| SENSOR_TYPE_ID_ORIENTATION | 256 | 方向传感器。 |
| SENSOR_TYPE_ID_GRAVITY | 257 | 重力传感器。 |
| SENSOR_TYPE_ID_LINEAR_ACCELERATION
<sup>
deprecated
</sup>
| 258 | 线性加速度传感器。
|
| SENSOR_TYPE_ID_LINEAR_ACCELEROMETER
| 258 | 线性加速度传感器。
|
| SENSOR_TYPE_ID_LINEAR_ACCELERATION
<sup>
(deprecated)
</sup>
| 258 | 线性加速度传感器。
|
| SENSOR_TYPE_ID_LINEAR_ACCELEROMETER
<sup>
9+
</sup>
| 258 | 线性加速度传感器。
|
| SENSOR_TYPE_ID_ROTATION_VECTOR | 259 | 旋转矢量传感器。 |
| SENSOR_TYPE_ID_AMBIENT_TEMPERATURE | 260 | 环境温度传感器。 |
| SENSOR_TYPE_ID_MAGNETIC_FIELD_UNCALIBRATED | 261 | 未校准磁场传感器。 |
...
...
@@ -2524,8 +2535,8 @@ sensor.getSingleSensor(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER).then((dat
| SENSOR_TYPE_ID_SIGNIFICANT_MOTION | 264 | 有效运动传感器。 |
| SENSOR_TYPE_ID_PEDOMETER_DETECTION | 265 | 计步检测传感器。 |
| SENSOR_TYPE_ID_PEDOMETER | 266 | 计步传感器。 |
| SENSOR_TYPE_ID_HEART_RATE
<sup>
deprecated
</sup>
| 278 | 心率传感器。
|
| SENSOR_TYPE_ID_HEART_BEAT_RATE
| 278 | 心率传感器。
|
| SENSOR_TYPE_ID_HEART_RATE
<sup>
(deprecated)
</sup>
| 278 | 心率传感器。
|
| SENSOR_TYPE_ID_HEART_BEAT_RATE
<sup>
9+
</sup>
| 278 | 心率传感器。
|
| SENSOR_TYPE_ID_WEAR_DETECTION | 280 | 佩戴检测传感器。 |
| SENSOR_TYPE_ID_ACCELEROMETER_UNCALIBRATED | 281 | 未校准加速度计传感器。 |
...
...
@@ -2540,7 +2551,7 @@ sensor.getSingleSensor(sensor.SensorType.SENSOR_TYPE_ID_ACCELEROMETER).then((dat
| --------- | -------- | ---- | ---- | ------------------------ |
| timestamp | number | 是 | 是 | 传感器数据上报的时间戳。 |
## Sensor
## Sensor
<sup>9+</sup>
指示传感器信息。
...
...
zh-cn/application-dev/reference/apis/js-apis-vibrator.md
浏览文件 @
81857245
...
...
@@ -58,9 +58,9 @@ vibrate(effect: VibrateEffect, attribute: VibrateAttribute): Promise<void>
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------------------------------------- | ---- | :------------- |
| effect |
[
VibrateEffect
](
#vibrateeffect
)
| 是 | 马达振动效果。 |
| attribute |
[
VibrateAttribute
](
#vibrateattribute
)
| 是 | 马达振动属性。 |
| --------- | -------------------------------------
-
| ---- | :------------- |
| effect |
[
VibrateEffect
](
#vibrateeffect
9
)
| 是 | 马达振动效果。 |
| attribute |
[
VibrateAttribute
](
#vibrateattribute
9
)
| 是 | 马达振动属性。 |
**返回值:**
...
...
@@ -77,10 +77,10 @@ vibrator.vibrate({
},
{
id
:
0
,
usage
:
'
alarm
'
}).
then
((
result
)
=>
{
}).
then
(()
=>
{
console
.
log
(
"
Promise returned to indicate a successful vibration
"
);
}).
catch
((
error
)
=>
{
console
.
log
(
"
error.code
"
+
error
.
code
+
"
error.message
"
+
error
.
message
);
console
.
log
(
"
error.code
"
+
error
.
code
+
"
error.message
"
+
error
.
message
);
})
```
...
...
@@ -105,7 +105,7 @@ vibrate(duration: number, callback?: AsyncCallback<void>): void
```
js
vibrator
.
vibrate
(
1000
,
function
(
error
){
if
(
error
){
console
.
log
(
"
error.code
"
+
error
.
code
+
"
error.message
"
+
error
.
message
);
console
.
log
(
"
error.code
"
+
error
.
code
+
"
error.message
"
+
error
.
message
);
}
else
{
console
.
log
(
"
Callback returned to indicate a successful vibration.
"
);
}
...
...
@@ -138,7 +138,7 @@ vibrate(effectId: EffectId): Promise<void>
vibrator
.
vibrate
(
vibrator
.
EffectId
.
EFFECT_CLOCK_TIMER
).
then
(()
=>
{
console
.
log
(
"
Promise returned to indicate a successful vibration.
"
);
},
(
error
)
=>
{
console
.
log
(
"
error.code
"
+
error
.
code
+
"
error.message
"
+
error
.
message
);
console
.
log
(
"
error.code
"
+
error
.
code
+
"
error.message
"
+
error
.
message
);
});
```
...
...
@@ -164,7 +164,7 @@ vibrate(effectId: EffectId, callback?: AsyncCallback<void>): void
```
js
vibrator
.
vibrate
(
vibrator
.
EffectId
.
EFFECT_CLOCK_TIMER
,
function
(
error
){
if
(
error
){
console
.
log
(
"
error.code
"
+
error
.
code
+
"
error.message
"
+
error
.
message
);
console
.
log
(
"
error.code
"
+
error
.
code
+
"
error.message
"
+
error
.
message
);
}
else
{
console
.
log
(
"
Callback returned to indicate a successful vibration.
"
);
}
...
...
@@ -184,9 +184,9 @@ vibrate(effect: VibrateEffect, attribute: VibrateAttribute, callback: AsyncCallb
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------------------------------------- | ---- | :--------------------------------------------------------- |
| effect |
[
VibrateEffect
](
#vibrateeffect
)
| 是 | 马达振动效果。 |
| attribute |
[
VibrateAttribute
](
#vibrateattribute
)
| 是 | 马达振动属性。 |
| --------- | -------------------------------------
-
| ---- | :--------------------------------------------------------- |
| effect |
[
VibrateEffect
](
#vibrateeffect
9
)
| 是 | 马达振动效果。 |
| attribute |
[
VibrateAttribute
](
#vibrateattribute
9
)
| 是 | 马达振动属性。 |
| callback | AsyncCallback
<
void
>
| 是 | 回调函数。当马达振动成功,err为undefined,否则为错误对象。 |
示例:
...
...
@@ -200,7 +200,7 @@ vibrator.vibrate({
usage
:
'
alarm
'
},
(
error
)
=>
{
if
(
error
){
console
.
log
(
TAG
+
"
fail, error.code:
"
+
error
.
code
+
"
,error.message:
"
+
error
.
message
);
console
.
log
(
"
vibrate fail, error.code:
"
+
error
.
code
+
"
,error.message:
"
+
error
.
message
);
}
else
{
console
.
log
(
"
Callback returned to indicate a successful vibration.
"
);
}
...
...
@@ -234,7 +234,7 @@ stop(stopMode: VibratorStopMode): Promise<void>
vibrator
.
stop
(
vibrator
.
VibratorStopMode
.
VIBRATOR_STOP_MODE_PRESET
).
then
(()
=>
{
console
.
log
(
"
Promise returned to indicate a successful vibration.
"
);
},
(
error
)
=>
{
console
.
log
(
"
error.code
"
+
error
.
code
+
"
error.message
"
+
error
.
message
);
console
.
log
(
"
error.code
"
+
error
.
code
+
"
error.message
"
+
error
.
message
);
});
```
...
...
@@ -260,7 +260,7 @@ stop(stopMode: VibratorStopMode, callback?: AsyncCallback<void>): void;
```
js
vibrator
.
stop
(
vibrator
.
VibratorStopMode
.
VIBRATOR_STOP_MODE_PRESET
,
function
(
error
){
if
(
error
){
console
.
log
(
"
error.code
"
+
error
.
code
+
"
error.message
"
+
error
.
message
);
console
.
log
(
"
error.code
"
+
error
.
code
+
"
error.message
"
+
error
.
message
);
}
else
{
console
.
log
(
"
Callback returned to indicate successful.
"
);
}
...
...
@@ -292,15 +292,21 @@ stop(stopMode: VibratorStopMode, callback?: AsyncCallback<void>): void;
## VibrateEffect<sup>9+</sup>
马达振动效果。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Sensors.MiscDevice
| 类型 | 说明 |
| ------------------------------- | ------------------------------ |
|
[
VibrateTime
](
#vibratetime
)
| 按照指定持续时间触发马达振动。 |
|
[
VibratePreset
](
#vibratepreset
)
| 按照预置振动类型触发马达振动。 |
| -------------------------------
-
| ------------------------------ |
|
[
VibrateTime
](
#vibratetime
9
)
| 按照指定持续时间触发马达振动。 |
|
[
VibratePreset
](
#vibratepreset
9
)
| 按照预置振动类型触发马达振动。 |
## VibrateTime<sup>9+</sup>
马达振动时长。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Sensors.MiscDevice
| 名称 | 默认值 | 说明 |
| -------- | ------ | ------------------------------ |
| type | "time" | 按照指定持续时间触发马达振动。 |
...
...
@@ -310,6 +316,8 @@ stop(stopMode: VibratorStopMode, callback?: AsyncCallback<void>): void;
马达预置振动类型。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Sensors.MiscDevice
| 名称 | 默认值 | 说明 |
| -------- | -------- | ------------------------------ |
| type | "preset" | 按照预置振动效果触发马达振动。 |
...
...
@@ -320,6 +328,8 @@ stop(stopMode: VibratorStopMode, callback?: AsyncCallback<void>): void;
马达振动属性。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Sensors.MiscDevice
| 名称 | 默认值 | 说明 |
| ----- | ------ | -------------- |
| id | 0 | 振动器id。 |
...
...
@@ -329,6 +339,8 @@ stop(stopMode: VibratorStopMode, callback?: AsyncCallback<void>): void;
振动使用场景。
**系统能力**
:以下各项对应的系统能力均为SystemCapability.Sensors.MiscDevice
| 名称 | 类型 | 说明 |
| ---------------- | ------ | ------------------------------ |
| unknown | string | 没有明确使用场景,最低优先级。 |
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录