鸿蒙HarmonyOS SDK
设备通信
写入数据点

写入数据点

数据点名称、类型和取值范围必须与机智云产品定义一致。支持 booleannumberstringArray<number>

自动选择通信通道

GizDevice.sendDataPoints() 会从已达到 ONLINE_CONTROLLABLE 的通道中选择 BLE、LAN、MQTT 顺序的第一个通道。

import { GizDataPointMap, GizDataPointValue } from '@gizwits/smart-sdk';
 
const dataPoints: GizDataPointMap = new Map<string, GizDataPointValue>();
dataPoints.set('power', true);
dataPoints.set('temperature', 26);
 
await device.sendDataPoints(dataPoints);

指定通信通道

业务必须固定传输方式时,调用对应 capability:

await device.bleCapability.sendDataPoints(device, dataPoints);
await device.lanCapability.sendDataPoints(device, dataPoints);
await device.mqttCapability.sendDataPoints(device, dataPoints);

MQTT 还提供等价的管理器入口:

await GizMqttManager.sendDeviceDataPoints(device, dataPoints);

仅调用当前已安装、初始化且状态可控的通道。所有异步方法都可能因设备离线、鉴权失败、网络切换或超时抛出异常。