鴻蒙OS 控制類(lèi)小器件概述

基本概念

控制類(lèi)小器件指的是設(shè)備上的 LED燈和振動(dòng)器。其中， LED燈主要用作指示（如充電狀態(tài)）、閃爍功能（如三色燈）等；振動(dòng)器主要用于鬧鐘、開(kāi)關(guān)機(jī)振動(dòng)、來(lái)電振動(dòng)等場(chǎng)景。

運(yùn)作機(jī)制

控制類(lèi)小器件主要包含以下四個(gè)模塊：控制類(lèi)小器件 API、控制類(lèi)小器件 Framework、控制類(lèi)小器件 Service、HD_IDL 層。

圖1 控制類(lèi)小器件

• 控制類(lèi)小器件 API：提供燈和振動(dòng)器基礎(chǔ)的 API，主要包含燈的列表查詢、打開(kāi)燈、關(guān)閉燈等接口，振動(dòng)器的列表查詢、振動(dòng)器的振動(dòng)器效果查詢、觸發(fā)/關(guān)閉振動(dòng)器等接口。
• 控制類(lèi)小器件 Framework：主要實(shí)現(xiàn)燈和振動(dòng)器的框架層管理，實(shí)現(xiàn)與控制類(lèi)小器件 Service 的通信。
• 控制類(lèi)小器件 Service：實(shí)現(xiàn)燈和振動(dòng)器的服務(wù)管理。
• HD_IDL層：對(duì)不同設(shè)備（車(chē)機(jī)、智能穿戴、智慧屏等）的適配。

約束與限制

• 在調(diào)用 Light API 時(shí)，請(qǐng)先通過(guò) getLightIdList 接口查詢?cè)O(shè)備所支持的燈的 ID 列表，以免調(diào)用打開(kāi)接口異常。
• 在調(diào)用 Vibrator API 時(shí)，請(qǐng)先通過(guò) getVibratorIdList 接口查詢?cè)O(shè)備所支持的振動(dòng)器的ID列表，以免調(diào)用振動(dòng)接口異常。
• 在使用振動(dòng)器時(shí)，開(kāi)發(fā)者需要配置請(qǐng)求振動(dòng)器的權(quán)限ohos.permission.VIBRATE，才能控制振動(dòng)器振動(dòng)。