振動

說明：
開發前請熟悉鴻蒙開發指導文檔 ：[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

參數：

返回值：

示例：

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

參數：

示例：

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

參數：

返回值：

示例：

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

參數：

示例：

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

參數：

返回值：

示例：

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

參數：

示例：

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

VibratorStopMode

表示馬達要停止指定的振動模式。

系統能力 ：以下各項對應的系統能力均為SystemCapability.Sensors.MiscDevice

審核編輯 黃宇