-

基本概念

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

运作机制

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

图1 控制类小器件 img

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

约束与限制

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