-

场景介绍

通常在汽车使用过程中,驾驶员需要设置仪表屏亮度、时间单位等参数,将电台、音乐等娱乐数据或导航数据显示在仪表屏上,因此 HarmonyOS 提供了和仪表交互相关的接口,供三方开发者开发仪表设置、显示等相关应用。

说明

该功能与具体的车厂车型相关,部分低配车型可能不具备该项功能。

接口说明

目前Cluster提供的功能有如下表所示:

接口名 描述
getClusterSignal() 获取指定Cluster信号值。
setClusterActuator() 设置指定Cluster执行器值。
sendClusterSignal() 发送指定字节数组类型的Cluster信号请求信息。
subscribeClusterSignal() 订阅指定Cluster信号。
subscribeBatchProperties() 批量订阅Cluster信号。
unsubscribeClusterSignal() 取消订阅指定的Cluster信号。
unsubscribeClusterSignalAll() 取消所有订阅的Cluster信号。

开发步骤

  1. 根据不同管理入口类,调对应接口。

   // 设置Cluster属性值
   String propId = ClusterManager.ID_CLUSTER_SETTINGS_BRIGHTNESS;
   ClusterActuatorCallback callback = new ClusterActuatorCallback() {
       @Override
       public void onErrorActuator(String propId, int errorCode) {}
   };
   boolean result = false;
   byte[] value = new byte[1];
   try {
        ClusterManager.sendClusterSignal(propId, callback, value);
        result = true;
   } catch (RemoteException | IllegalArgumentException | UnsupportedOperationException e) {
        result = false;
   }