一、簡介

① 基本概念

• 控制類小器件指的是設備上的 LED 燈和振動器。其中，LED 燈主要用作指示（如充電狀態）、閃爍功能（如三色燈）等；振動器主要用于鬧鐘、開關機振動、來電振動等場景。
• 控制類小器件主要包含以下四個模塊：控制類小器件 API、控制類小器件Framework、控制類小器件 Service、HD_IDL 層。

• 控制類小器件 API：提供燈和振動器基礎的 API，主要包含燈的列表查詢、打開燈、關閉燈等接口，振動器的列表查詢、振動器的振動器效果查詢、觸發/關閉振動器等接口。
• 控制類小器件 Framework：主要實現燈和振動器的框架層管理，實現與控制類小器件 Service 的通信。
• 控制類小器件 Service：實現燈和振動器的服務管理。
• HD_IDL 層：對不同設備的適配。

② 約束與限制

• 在調用 Light API 時，請先通過 getLightIdList 接口查詢設備所支持的燈的 ID 列表，以免調用打開接口異常。
• 在調用 Vibrator API 時，請先通過 getVibratorIdList 接口查詢設備所支持的振動器的ID列表，以免調用振動接口異常。
• 在使用振動器時，開發者需要配置請求振動器的權限 ohos.permission.VIBRATE，才能控制振動器振動。

二、Light

① 應用場景

• 當設備需要設置不同的閃爍效果時，可以調用 Light 模塊，例如，LED 燈能夠設置燈顏色、燈亮和燈滅時長的閃爍效果。

② Light 的 API

• 燈模塊主要提供的功能有：查詢設備上燈的列表，查詢某個燈設備支持的效果，打開和關閉燈設備。
• LightAgent 類開放能力如下：

接口名描述

getLightIdList()	獲取硬件設備上的燈列表
isSupport(int)	根據指定燈Id查詢硬件設備是否有該燈
isEffectSupport(int, String)	查詢指定的燈是否支持指定的閃爍效果
turnOn(int, String)	對指定的燈創建指定效果的一次性閃爍
turnOn(int, LightEffect)	對指定的燈創建自定義效果的一次性閃爍
turnOn(String)	對指定的燈創建指定效果的一次性閃爍
turnOn(LightEffect)	對指定的燈創建自定義效果的一次性閃爍
turnOff(int)	關閉指定的燈
turnOff()	關閉指定的燈

③ Light 的使用

• 查詢硬件設備上燈的列表。
• 查詢指定的燈是否支持指定的閃爍效果。
• 創建不同的閃爍效果。
• 關閉指定的燈。

private LightAgent lightAgent = new LightAgent();@Overridepublic void onStart(Intent intent) {super.onStart(intent);super.setUIContent(ResourceTable.Layout_light_layout);// ...// 查詢硬件設備上的燈列表List<Integer> myLightList = lightAgent.getLightIdList();if (myLightList.isEmpty()) {return;}int lightId = myLightList.get(0);// 查詢指定的燈是否支持指定的閃爍效果boolean isSupport = lightAgent.isEffectSupport(lightId, LightEffect.LIGHT_ID_KEYBOARD);// 創建指定效果的一次性閃爍boolean turnOnResult = lightAgent.turnOn(lightId, LightEffect.LIGHT_ID_KEYBOARD);// 創建自定義效果的一次性閃爍LightBrightness lightBrightness = new LightBrightness(255, 255, 255);LightEffect lightEffect = new LightEffect(lightBrightness, 1000, 1000);boolean turnOnEffectResult = lightAgent.turnOn(lightId, lightEffect);// 關閉指定的燈boolean turnOffResult = lightAgent.turnOff(lightId);}

三、Vibrator

① 應用場景

• 當設備需要設置不同的振動效果時，可以調用 Vibrator 模塊，例如，設備的按鍵可以設置不同強度和時長的振動，鬧鐘和來電可以設置不同強度和時長的單次或周期性振動。

② Vibrator 的 API

• 振動器模塊主要提供的功能有：查詢設備上振動器的列表，查詢某個振動器是否支持某種振動效果，觸發和關閉振動器。
• VibratorAgent類開放能力如下：

接口名描述

getVibratorIdList()	獲取硬件設備上的振動器列表
isSupport(int)	根據指定的振動器Id查詢硬件設備是否存在該振動器
isEffectSupport(int, String)	查詢指定的振動器是否支持指定的震動效果
startOnce(int, String)	對指定的振動器創建指定效果的一次性振動
startOnce?(String)	對指定的振動器創建指定效果的一次性振動
startOnce(int, int)	對指定的振動器創建指定振動時長的一次性振動
startOnce?(int)	對指定的振動器創建指定振動時長的一次性振動
start(String, boolean)	對指定的振動器以預設的某種振動效果進行循環振動
start(int, VibrationPattern)	對指定的振動器創建自定義效果的波形或一次性振動
start?(VibrationPattern)	對指定的振動器創建自定義效果的波形或一次性振動
stop(int, String)	關閉指定的振動器指定模式的振動
stop(String)	關閉指定的振動器指定模式的振動

③ Vibrator 的使用

• 控制設備上的振動器，需要在“config.json”里面進行配置請求權限，具體如下：

"reqPermissions": [{"name": "ohos.permission.VIBRATE","reason": "","usedScene": {"ability": [".MainAbility"],"when": "inuse"}}]

• 查詢硬件設備上的振動器列表。
• 查詢指定的振動器是否支持指定的震動效果。
• 創建不同效果的振動。
• 關閉指定的振動器指定模式的振動。

private VibratorAgent vibratorAgent = new VibratorAgent();private int[] timing = {1000, 1000, 2000, 5000};private int[] intensity = {50, 100, 200, 255};@Overridepublic void onStart(Intent intent) {super.onStart(intent);super.setUIContent(ResourceTable.Layout_vibrator_layout);// ...// 查詢硬件設備上的振動器列表List<Integer> vibratorList = vibratorAgent.getVibratorIdList();if (vibratorList.isEmpty()) {return;}int vibratorId = vibratorList.get(0);// 查詢指定的振動器是否支持指定的振動效果boolean isSupport = vibratorAgent.isEffectSupport(vibratorId,VibrationPattern.VIBRATOR_TYPE_CAMERA_CLICK);// 創建指定效果的一次性振動boolean vibrateEffectResult = vibratorAgent.startOnce(vibratorId,VibrationPattern.VIBRATOR_TYPE_CAMERA_CLICK);// 創建指定振動時長的一次性振動int vibratorTiming = 1000;boolean vibrateResult = vibratorAgent.startOnce(vibratorId, vibratorTiming);// 以預設的某種振動效果進行循環振動boolean vibratorRepeatEffect = vibratorAgent.start(VibrationPattern.VIBRATOR_TYPE_RINGTONE_BOUNCE, true);// 控制振動器停止循環振動vibratorAgent.stop();// 創建自定義效果的周期性波形振動int count = 5;VibrationPattern vibrationPeriodEffect = VibrationPattern.createPeriod(timing, intensity, count);boolean vibratePeriodResult = vibratorAgent.start(vibratorId, vibrationPeriodEffect);// 創建自定義效果的一次性振動VibrationPattern vibrationOnceEffect = VibrationPattern.createSingle(3000, 50);boolean vibrateSingleResult = vibratorAgent.start(vibratorId, vibrationOnceEffect);// 關閉指定的振動器自定義模式的振動boolean stopResult = vibratorAgent.stop(vibratorId,VibratorAgent.VIBRATOR_STOP_MODE_CUSTOMIZED);}

總結

以上是生活随笔為你收集整理的HarmonyOS之LED灯和振动器Vibrator的功能和使用的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。