Skip to main content
版本:v3+

Vibrator

API_LEVEL 2.0 开始支持,API 兼容性请参考 API_LEVEL

振动马达。

方法

start

开始振动,传入的 option 参数,只对此次振动生效,在 API_LEVEL 3.6 后支持传入震动场景数组

start(option?: Option | Array<Action>): void

Option

属性类型必填默认值说明API_LEVEL
modenumberVIBRATOR_SCENE_SHORT_MIDDLE振动模式,值参考振动马达模式常量2.0

Action

属性类型必填默认值说明API_LEVEL
typenumber-震动场景类型3.6
durationnumber-震动持续时长3.6

常量

振动马达模式常量
常量说明API_LEVEL
VIBRATOR_SCENE_SHORT_LIGHT振动强度轻,时间较短(20ms)2.0
VIBRATOR_SCENE_SHORT_MIDDLE振动强度中等,时间较短(20ms)2.0
VIBRATOR_SCENE_SHORT_STRONG振动强度高,时间较短(20ms)2.0
VIBRATOR_SCENE_DURATION振动强度高,持续 600ms2.0
VIBRATOR_SCENE_DURATION_LONG振动强度高,持续 1000ms2.0
VIBRATOR_SCENE_STRONG_REMINDER振动强度高,1200ms 内振动四次,用于较强提醒2.0
VIBRATOR_SCENE_NOTIFICATION短促振动两次,与手表消息通知振动反馈一致2.0
VIBRATOR_SCENE_CALL振动强度高,单次 500ms 内振动两次,持续振动,需要手动 stop 才会停止,与手表来电振动反馈一致2.0
VIBRATOR_SCENE_TIMER振动强度高,单次长振动 500ms,持续振动,需要手动 stop 才会停止,与手表闹钟、倒计时振动反馈一致2.0

stop

停止振动

stop(): void

setMode

设置振动模式,设置成功后调用 start(),会依照设置的模式进行振动

setMode(option: Option): void

Option

属性类型必填默认值说明API_LEVEL
modenumber-振动模式,值参考振动马达模式常量2.0

getConfig

获取振动马达配置

getConfig(): Option

Option

属性类型说明API_LEVEL
modenumber振动模式,值参考振动马达模式常量2.0

getType

API_LEVEL 3.6

获取振动场景类型

getType(): Type

Type

属性类型说明API_LEVEL
GENTLE_SHORTnumber震动场景,轻短振3.6
STRONG_SHORTnumber震动场景,强短振3.6
STANDARD_CROWNnumber震动场景,标准表冠振动3.6
STRONG_CROWNnumber震动场景,强表冠振动3.6
SPULSE_CROWNnumber震动场景,单脉冲表冠振动3.6
DIPULSE_CROWNnumber震动场景,双脉冲表冠振动3.6
KEYCODE_CLICKnumber震动场景,密码按键振动3.6
URGENTnumber震动场景,加急振动3.6
CONTINUOUSnumber震动场景,持续振动3.6
PAUSEnumber震动场景,停止振动3.6

代码示例

import { Vibrator, VIBRATOR_SCENE_DURATION } from '@zos/sensor'

const vibrator = new Vibrator()
vibrator.start()

// set scene
vibrator.setMode(VIBRATOR_SCENE_DURATION)
vibrator.start()