场景介绍
通常在汽车使用过程中,驾驶员需要设置仪表屏亮度、时间单位等参数,将电台、音乐等娱乐数据或导航数据显示在仪表屏上,因此 HarmonyOS 提供了和仪表交互相关的接口,供三方开发者开发仪表设置、显示等相关应用。
说明
该功能与具体的车厂车型相关,部分低配车型可能不具备该项功能。
接口说明
目前Cluster提供的功能有如下表所示:
接口名 | 描述 |
---|---|
getClusterSignal() | 获取指定Cluster信号值。 |
setClusterActuator() | 设置指定Cluster执行器值。 |
sendClusterSignal() | 发送指定字节数组类型的Cluster信号请求信息。 |
subscribeClusterSignal() | 订阅指定Cluster信号。 |
subscribeBatchProperties() | 批量订阅Cluster信号。 |
unsubscribeClusterSignal() | 取消订阅指定的Cluster信号。 |
unsubscribeClusterSignalAll() | 取消所有订阅的Cluster信号。 |
开发步骤
- 根据不同管理入口类,调对应接口。
// 设置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;
}