提交 f453a735 编写于 作者: C cff-gite

修改废弃接口

Signed-off-by: Ncff-gite <chenfeifei8@huawei.com>
上级 5eb5458c
# @system.vibrator (振动)
## 模块说明
vibrator模块提供控制马达振动的能力,主要包含灯的列表查询、打开灯、关闭灯等接口,振动器的列表查询、振动器的振动器效果查询、触发/关闭振动器等接口。
控制类小器件指的是设备上的LED灯和振动器。其中,LED灯主要用作指示(如充电状态)、闪烁功能(如三色灯)等;振动器主要用于闹钟、开关机振动、来电振动等场景。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> - 本模块首批接口从API version 4开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> **说明:**
> - 本模块首批接口从API version 3开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
> - 从API Version 8开始,该接口不再维护,推荐使用新接口[`@ohos.vibrator`](js-apis-vibrator.md)。
> - 该功能使用需要对应硬件支持,仅支持真机调试。
......@@ -22,26 +20,23 @@ import vibrator from '@system.vibrator';
## vibrator.vibrate
vibrate(Object): void
vibrate(options?: VibrateOptions): void
触发设备振动。
**系统能力**:SystemCapability.Sensors.MiscDevice
**需要权限**:ohos.permission.VIBRATE
**需要权限**:ohos.permission.VIBRATE,该权限为系统权限
**系统能力**:SystemCapability.Sensors.MiscDevice
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| mode | string | 否 | 振动的模式,其中long表示长振动,short表示短振动,默认值为long。 |
| success | Function | 是 | 感应到振动数据变化后的回调函数。 |
| fail | Function | 否 | 接口调用失败的回调函数。 |
| complete | Function | 否 | 接口调用结束的回调函数。 |
| 参数名 | 类型 | 必填 | 说明 |
| ------- | --------------------------------- | ---- | ---------- |
| options | [VibrateOptions](#vibrateoptions) | 否 | 振动模式。 |
**示例:**
```
```js
vibrator.vibrate({
mode: 'short',
success: function() {
......@@ -56,3 +51,17 @@ vibrator.vibrate({
});
```
## VibrateOptions
振动模式。
**需要权限**:ohos.permission.VIBRATE
**系统能力**:SystemCapability.Sensors.MiscDevice
| 名称 | 类型 | 必填 | 说明 |
| -------- | -------- | ---- | ------------------------------------------------------------ |
| mode | string | 否 | 振动的模式,其中long表示长振动,short表示短振动,默认值为long。 |
| success | Function | 否 | 感应到振动数据变化后的回调函数。 |
| fail | Function | 否 | 接口调用失败的回调函数。 |
| complete | Function | 否 | 接口调用结束的回调函数。 |
\ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册