振動

說明：
開發前請熟悉鴻蒙開發指導文檔 ：[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"	調整定時器時振動器的振動效果。

搜狗高速瀏覽器截圖20240326151450.png

VibratorStopMode

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

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

名稱	默認值	說明
VIBRATOR_STOP_MODE_TIME	"time"	停止模式為duration模式的振動。即觸發振動時參數類型為number，參數本身為指示振動持續時間的觸發方式。
VIBRATOR_STOP_MODE_PRESET	"preset"	停止模式為預置EffectId的振動。即觸發振動時參數類型為EffectId，參數本身為指示馬達振動效果的字符串的觸發方式。

審核編輯黃宇

聲明：本文內容及配圖由入駐作者撰寫或者入駐合作網站授權轉載。文章觀點僅代表作者本人，不代表電子發燒友網立場。文章及其配圖僅供工程師學習之用，如有內容侵權或者其他違規問題，請聯系本站處理。舉報投訴