咨询Azure Digital Twin中3D模型资产属性绑定的API
2026-8-22
Azure Digital Twin 3D模型交互与属性绑定相关API
核心可用API分类
1. 数字孪生模型定义与实例管理API
- Digital Twins Model API：用于定义资产的数字孪生描述语言（DTDL）模型，可预先定义机器的属性结构（如设备ID、运行状态、能耗等）。
- 关键操作：
CreateModel、GetModel，用来标准化机器的属性模板，为后续绑定3D资产做准备。
- 关键操作：
- Azure Digital Twins Graph Management API：管理数字孪生实例，将3D模型中的实体映射为孪生实例。
- 关键操作：
CreateDigitalTwin、GetDigitalTwin、UpdateDigitalTwin，通过机器ID创建对应的孪生实例，后续用于绑定属性。
- 关键操作：
2. 3D场景资产识别与关联API
- Azure Digital Twins Spatial Intelligence Graph API：处理3D空间模型的资产映射逻辑，支持通过3D模型中元素的命名ID（与你的数据库机器ID匹配）关联孪生实例。
- 关键操作：
CreateSpatialGraphResource、GetSpatialGraphResource，实现GLTF/GLB模型中的机器节点与孪生实例的绑定。
- 关键操作：
- Model Conversion API：导入GLTF/GLB模型时，可通过该API完成格式转换，同时提取模型内各元素的标识信息（如节点ID），方便后续与数据库ID匹配。
3. 属性绑定与数据同步API
- Digital Twins Property Update API：通过
UpdateDigitalTwin操作，将数据库中的属性值同步到对应的孪生实例。只需通过机器ID定位到孪生实例ID，即可批量更新属性。 - Query API：使用
QueryDigitalTwins语句快速定位目标孪生实例，比如通过机器ID作为查询条件：SELECT * FROM digitaltwins WHERE $dtId = '<你的机器ID>'，为属性绑定提供精准定位。
实现流程参考
- 调用Model Conversion API导入GLTF/GLB模型，提取模型内各机器的节点ID，确保与数据库中的机器ID匹配。
- 用Digital Twins Model API定义对应机器的DTDL模型，包含需要绑定的属性字段。
- 通过Graph Management API创建机器对应的孪生实例，并关联3D模型中的节点ID。
- 从数据库读取机器ID与属性数据，调用UpdateDigitalTwin API完成属性绑定与同步。
内容的提问来源于stack exchange，提问作者Kailas J C
相关产品推荐
相关产品推荐
