鸿蒙HarmonyOS SDK
设备通信
设备信息

设备信息

不同通信通道都通过 capability 提供设备信息和重置标识查询,但信息来源与前置条件不同。

通过 BLE 查询信息

const bleInfo = await device.bleCapability.getDeviceInfo(device);

该调用连接设备并读取模组、MCU 和协议版本信息。

await device.bleCapability.queryResetFlag(device);

通过 LAN 查询信息

const lanInfo = await device.lanCapability.getDeviceInfo(device);
await device.lanCapability.queryResetFlag(device);

通过 MQTT 查询信息

MQTT 实现从绑定设备资料读取版本信息:

const cloudInfo = await device.mqttCapability.getDeviceInfo(device);
// 等价入口:const cloudInfo = await GizMqttManager.getDeviceInfo(device);
await device.mqttCapability.queryResetFlag(device);

设备离线、绑定资料缺失、鉴权失败或操作超时时,上述 Promise 会抛出异常。查询重置标识后的结果由设备上报流程处理。