如何通过编程在Azure Digital Twins中关联3D对象与孪生体

核心思路 #

Azure 3D Scenes Studio的场景配置存储在Blob存储的3DScenesConfiguration.json文件中，目前官方虽未提供直接操作关联关系的公开SDK/API，但可以通过增量更新配置文件的方式实现批量关联，规避全量提交的繁琐操作。

具体操作步骤 #

1. 获取现有场景配置

   • 发送GET请求到https://explorer.digitaltwins.azure.net/proxy/blob/scenemodels/3DScenesConfiguration.json，请求需携带Azure Digital Twins的身份验证令牌（可通过Azure AD获取，比如借助Azure SDK中的TokenCredential实现）。
   • 解析返回的JSON数据，定位到configuration.scenes数组里目标场景的elements列表。

2. 批量生成关联映射

   • 基于你已有的孪生体与3D对象唯一ID（两者ID一致），批量构造TwinToObjectMapping对象，格式示例：

     {
       "type": "TwinToObjectMapping",
       "objectIDs": ["你的3D对象唯一ID"],
       "primaryTwinID": "对应孪生体的唯一ID"
     }
     

   • 将这些新映射对象追加到之前提取的elements数组中，注意保留原有已存在的关联内容。

3. 增量更新配置文件

   • 保留配置文件中其他所有原有项，仅替换目标场景的elements数组，构造完整的更新后JSON。
   • 发送PUT请求到同一个URL，携带验证令牌，请求体为更新后的JSON内容。

关键注意事项 #

• 权限验证：确保请求使用的令牌拥有Azure Digital Twins的DigitalTwinsDataOwner权限，或同时具备DigitalTwinsDataReader与DigitalTwinsDataWriter权限。
• 并发冲突处理：操作前务必获取最新配置，避免覆盖他人修改；多线程批量操作时建议添加锁机制或冲突处理逻辑。
• 结果验证：更新完成后，可再次发送GET请求获取配置，检查关联是否正确添加，也可在Scene Studio中直观验证效果。

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