振動(dòng)

說明：
開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
本模塊首批接口從API version 8開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。

導(dǎo)入模塊

import vibrator from '@ohos.vibrator';

vibrator.vibrate

vibrate(duration: number): Promise

按照指定持續(xù)時(shí)間觸發(fā)馬達(dá)振動(dòng)。

權(quán)限列表 ：ohos.permission.VIBRATE，該權(quán)限為系統(tǒng)權(quán)限

系統(tǒng)能力 ：SystemCapability.Sensors.MiscDevice

參數(shù)：

返回值：

示例：

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

按照指定持續(xù)時(shí)間觸發(fā)馬達(dá)振動(dòng)。

權(quán)限列表 ：ohos.permission.VIBRATE，該權(quán)限為系統(tǒng)權(quán)限

系統(tǒng)能力 ：SystemCapability.Sensors.MiscDevice

參數(shù)：

示例：

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

按照指定振動(dòng)效果觸發(fā)馬達(dá)振動(dòng)。

權(quán)限列表 ：ohos.permission.VIBRATE，該權(quán)限為系統(tǒng)權(quán)限

系統(tǒng)能力 ：SystemCapability.Sensors.MiscDevice

參數(shù)：

返回值：

示例：

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

按照指定振動(dòng)效果觸發(fā)馬達(dá)振動(dòng)。

權(quán)限列表 ：ohos.permission.VIBRATE，該權(quán)限為系統(tǒng)權(quán)限

系統(tǒng)能力 ：SystemCapability.Sensors.MiscDevice

參數(shù)：

示例：

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

按照要停止指定的振動(dòng)模式來停止馬達(dá)的振動(dòng)。如果要停止的振動(dòng)模式與觸發(fā)馬達(dá)振動(dòng)時(shí)的模式不相同，則調(diào)用本接口會(huì)失敗。

權(quán)限列表 ：ohos.permission.VIBRATE，該權(quán)限為系統(tǒng)權(quán)限

系統(tǒng)能力 ：SystemCapability.Sensors.MiscDevice

參數(shù)：

返回值：

示例：

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;

按照要停止指定的振動(dòng)模式來停止馬達(dá)的振動(dòng)。如果要停止的振動(dòng)模式與觸發(fā)馬達(dá)振動(dòng)時(shí)的模式不相同，則調(diào)用本接口會(huì)失敗。

權(quán)限列表 ：ohos.permission.VIBRATE，該權(quán)限為系統(tǒng)權(quán)限

系統(tǒng)能力 ：SystemCapability.Sensors.MiscDevice

參數(shù)：

示例：

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

表示馬達(dá)振動(dòng)效果的字符串。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Sensors.MiscDevice

VibratorStopMode

表示馬達(dá)要停止指定的振動(dòng)模式。

系統(tǒng)能力 ：以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.Sensors.MiscDevice

審核編輯 黃宇