鸿蒙开发设备管理：ohos.vibrator 振动

振动

说明：
开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import vibrator from '@ohos.vibrator';

vibrator.vibrate

vibrate(duration: number): Promise

按照指定持续时间触发马达振动。

权限列表 ：ohos.permission.VIBRATE，该权限为系统权限

系统能力 ：SystemCapability.Sensors.MiscDevice

参数：

参数名	类型	必填	说明
duration	number	是	指示马达振动的持续时间。

返回值：

类型	说明
Promise	指示触发振动是否成功。

示例：

vibrator.vibrate(1000).then(()= >{
    console.log("Promise returned to indicate a successful vibration.");
}, (error)= >{
    console.log("error.code"+error.code+"error.message"+error.message);
});

vibrator.vibrate

vibrate(duration: number, callback?: AsyncCallback): void

按照指定持续时间触发马达振动。

权限列表 ：ohos.permission.VIBRATE，该权限为系统权限

系统能力 ：SystemCapability.Sensors.MiscDevice

参数：

参数名	类型	必填	说明
duration	number	是	指示马达振动的持续时间。
callback	AsyncCallback	否	马达执行振动的回调函数，指示触发振动是否成功。

示例：

vibrator.vibrate(1000,function(error){
    if(error){
        console.log("error.code"+error.code+"error.message"+error.message);
    }else{
        console.log("Callback returned to indicate a successful vibration.");
    }
})

vibrator.vibrate

vibrate(effectId: EffectId): Promise

按照指定振动效果触发马达振动。

权限列表 ：ohos.permission.VIBRATE，该权限为系统权限

系统能力 ：SystemCapability.Sensors.MiscDevice

参数：

参数名	类型	必填	说明
effectId	[EffectId]	是	指示马达振动效果的字符串。

返回值：

类型	说明
Promise	指示触发振动是否成功。

示例：

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);
});

vibrator.vibrate

vibrate(effectId: EffectId, callback?: AsyncCallback): void

按照指定振动效果触发马达振动。

权限列表 ：ohos.permission.VIBRATE，该权限为系统权限

系统能力 ：SystemCapability.Sensors.MiscDevice

参数：

参数名	类型	必填	说明
effectId	[EffectId]	是	指示马达振动效果的字符串。
callback	AsyncCallback	否	马达执行振动的回调函数，指示触发振动是否成功。

示例：

vibrator.vibrate(vibrator.EffectId.EFFECT_CLOCK_TIMER, function(error){
    if(error){
        console.log("error.code"+error.code+"error.message"+error.message);
    }else{
        console.log("Callback returned to indicate a successful vibration.");
    }
})

vibrator.stop

stop(stopMode: VibratorStopMode): Promise

按照要停止指定的振动模式来停止马达的振动。如果要停止的振动模式与触发马达振动时的模式不相同，则调用本接口会失败。

权限列表 ：ohos.permission.VIBRATE，该权限为系统权限

系统能力 ：SystemCapability.Sensors.MiscDevice

参数：

参数名	类型	必填	说明
stopMode	[ViatorStopMode]	是	指示马达要停止指定的振动模式。

返回值：

类型	说明
Promise	指示停止振动是否成功。

示例：

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);
});

vibrator.stop

stop(stopMode: VibratorStopMode, callback?: AsyncCallback): void;

按照要停止指定的振动模式来停止马达的振动。如果要停止的振动模式与触发马达振动时的模式不相同，则调用本接口会失败。

权限列表 ：ohos.permission.VIBRATE，该权限为系统权限

系统能力 ：SystemCapability.Sensors.MiscDevice

参数：

参数名	类型	必填	说明
stopMode	[ViatorStopMode]	是	指示马达要停止指定的振动模式。
callback	AsyncCallback	否	马达停止振动的回调函数，指示停止振动是否成功。

示例：

vibrator.stop(vibrator.VibratorStopMode.VIBRATOR_STOP_MODE_PRESET, function(error){
    if(error){
        console.log("error.code"+error.code+"error.message"+error.message);
    }else{
        console.log("Callback returned to indicate successful.");
    }
})

EffectId

表示马达振动效果的字符串。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Sensors.MiscDevice

名称	默认值	说明HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿
EFFECT_CLOCK_TIMER	"haptic.clock.timer"	调整定时器时振动器的振动效果。

VibratorStopMode

表示马达要停止指定的振动模式。

系统能力 ：以下各项对应的系统能力均为SystemCapability.Sensors.MiscDevice

名称	默认值	说明
VIBRATOR_STOP_MODE_TIME	"time"	停止模式为duration模式的振动。即触发振动时参数类型为number，参数本身为指示振动持续时间的触发方式。
VIBRATOR_STOP_MODE_PRESET	"preset"	停止模式为预置EffectId的振动。即触发振动时参数类型为EffectId，参数本身为指示马达振动效果的字符串的触发方式。

审核编辑 黄宇