如何从设备端更新IoT Hub可写属性？代码未同步至IoT Central

我需要实现从设备端更新IoT Hub的可写属性，已编写如下期望属性变更回调代码，但该代码无法将上报属性同步至IoT Central后端：

private async Task OnDesiredPropertyChangedAsync(TwinCollection desiredProperties, object userContext)
 {
    JValue targetHeartbeatPeriodJson = desiredProperties["heartbeatPeriod"];
            if (targetHeartbeatPeriodJson != null)
            {
                int targetPeriod = targetHeartbeatPeriodJson.Value<int>();
                timerInterval = targetPeriod;  
                timer.Interval = timerInterval * 60000; // minutes * milliseconds

                TwinCollection reportedProperties = new TwinCollection();
                TwinCollection ackProps = new TwinCollection();

                ackProps["value"] = targetPeriod;
                ackProps["ac"] = 200;
                ackProps["av"] = desiredProperties.Version;
                ackProps["ad"] = "Desired property accepted";
                reportedProperties["heartbeatPeriod"] = ackProps;
                eventLog1.WriteEntry($"Set desired property heartbeatPeriod : {ackProps["value"]}");
                await deviceClient.UpdateReportedPropertiesAsync(reportedProperties);
            }
}

当前设备属性状态如下：

{
    "$metadata": {
       
        "heartbeatPeriod": {
            "desiredValue": 15,
            "desiredVersion": 7,
            "lastUpdateTime": "2023-08-22T09:30:45.6558675Z",
            "ackDescription": "reported value",
            "ackCode": 200
        },
        ...
    },
    ...,
    ...,
    "heartbeatPeriod": 1,
    ...
  
}

请问我遗漏了什么导致属性未更新？

问题分析与修复方案 #

从代码和设备孪生状态来看，核心问题是上报属性的格式不符合IoT Central的要求，具体问题和修复如下：

1. 格式不匹配
   IoT Central要求上报属性时，属性值直接作为顶层字段，而ACK确认信息（ac/av/ad）需要嵌套在$metadata的对应属性节点下。你的代码把ACK结构直接赋值给了heartbeatPeriod字段，导致Central无法正确解析上报的属性值。

2. 修复后的代码
   修改回调代码，将属性值和元数据分开构建：

   private async Task OnDesiredPropertyChangedAsync(TwinCollection desiredProperties, object userContext)
   {
       JValue targetHeartbeatPeriodJson = desiredProperties["heartbeatPeriod"];
       if (targetHeartbeatPeriodJson != null)
       {
           int targetPeriod = targetHeartbeatPeriodJson.Value<int>();
           timerInterval = targetPeriod;  
           timer.Interval = timerInterval * 60000; // 分钟转毫秒
   
           // 构建正确的上报结构：顶层放属性值，$metadata下放ACK信息
           TwinCollection reportedProperties = new TwinCollection();
           // 直接设置属性值
           reportedProperties["heartbeatPeriod"] = targetPeriod;
   
           // 构建元数据部分
           TwinCollection metadata = new TwinCollection();
           TwinCollection heartbeatMeta = new TwinCollection();
           heartbeatMeta["ac"] = 200; // 确认码，200表示成功
           heartbeatMeta["av"] = desiredProperties.Version; // 对应期望属性的版本
           heartbeatMeta["ad"] = "Desired property accepted"; // 描述信息
           metadata["heartbeatPeriod"] = heartbeatMeta;
           reportedProperties["$metadata"] = metadata;
   
           eventLog1.WriteEntry($"设置期望属性heartbeatPeriod为: {targetPeriod}");
           await deviceClient.UpdateReportedPropertiesAsync(reportedProperties);
       }
   }
   

3. 额外检查项

   • 确认deviceClient已正常连接到IoT Hub，没有连接中断或权限问题
   • 检查IoT Central中的设备模型，确保heartbeatPeriod被定义为可写属性，且数据类型为整数
   • 查看IoT Hub的设备孪生历史，确认上报请求已成功发送到Hub（如果Hub收到但Central没更新，需检查模型映射是否正确）

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