鸿蒙OS 控制类小器件概述

基本概念

控制类小器件指的是设备上的 LED灯和振动器。其中， LED灯主要用作指示（如充电状态）、闪烁功能（如三色灯）等；振动器主要用于闹钟、开关机振动、来电振动等场景。

运作机制

控制类小器件主要包含以下四个模块：控制类小器件 API、控制类小器件 Framework、控制类小器件 Service、HD_IDL 层。

图1 控制类小器件

• 控制类小器件 API：提供灯和振动器基础的 API，主要包含灯的列表查询、打开灯、关闭灯等接口，振动器的列表查询、振动器的振动器效果查询、触发/关闭振动器等接口。
• 控制类小器件 Framework：主要实现灯和振动器的框架层管理，实现与控制类小器件 Service 的通信。
• 控制类小器件 Service：实现灯和振动器的服务管理。
• HD_IDL层：对不同设备（车机、智能穿戴、智慧屏等）的适配。

约束与限制

• 在调用 Light API 时，请先通过 getLightIdList 接口查询设备所支持的灯的 ID 列表，以免调用打开接口异常。
• 在调用 Vibrator API 时，请先通过 getVibratorIdList 接口查询设备所支持的振动器的ID列表，以免调用振动接口异常。
• 在使用振动器时，开发者需要配置请求振动器的权限ohos.permission.VIBRATE，才能控制振动器振动。