Azure IoT C SDK：两个异步发送接口的功能差异

问题描述 #

我刚开始使用Azure IoT C SDK，正在尝试设备与云端间的多种数据传输方式。请问IoTHubDeviceClient_LL_SendTelemetryAsync和IoTHubDeviceClient_LL_SendEventAsync有什么区别？官方文档未明确说明遥测数据与事件的差异，且调用这两个接口后的日志输出完全一致，谷歌搜索也未找到相关信息。日志输出如下：

-> 08:14:54 PUBLISH | IS_DUP: false | RETAIN: 0 | QOS: DELIVER_AT_LEAST_ONCE | TOPIC_NAME: devices/Test1/messages/events/ | PACKET_ID: 5 | PAYLOAD_LEN: 9
-> 08:14:54 PUBLISH | IS_DUP: false | RETAIN: 0 | QOS: DELIVER_AT_LEAST_ONCE | TOPIC_NAME: devices/Test1/messages/events/ | PACKET_ID: 6 | PAYLOAD_LEN: 9

解答 #

这两个接口完全没有功能差异，属于Azure IoT C SDK版本演进中的命名优化：

• IoTHubDeviceClient_LL_SendEventAsync是早期版本的命名，当时用“Event”指代设备上报的遥测数据；
• IoTHubDeviceClient_LL_SendTelemetryAsync是后续版本推出的更精准命名，因为在Azure IoT生态里，“Telemetry（遥测）”是设备上报的时序性、状态类数据的标准称呼，能避免和其他类型的“Event（事件）”（比如数字孪生事件、设备生命周期事件）产生混淆。

从你提供的日志也能验证这一点：两个接口调用后都会向同一个MQTT主题devices/Test1/messages/events/发送消息，协议参数（QoS、Retain等）完全一致，底层实现逻辑完全相同。

官方文档未明确说明是因为这属于SDK的兼容性保留设计——为了让旧代码无需修改就能正常运行，SDK保留了旧命名接口，但推荐新开发的代码优先使用SendTelemetryAsync这类更规范的命名。

内容的提问来源于stack exchange，提问作者DrP3pp3r