Resource Guide
数字孪生资产与协议兼容矩阵
摘要：数字孪生资产与协议兼容矩阵用于在立项、联调和验收阶段逐行记录三维模型、GIS地图、视频流、工业设备协议和业务接口的来源、版本、坐标、单位、语义、权限、转换方式、性能限制、目标终端、兼容结论与证据位置。
兼容不能只看文件扩展名或协议名称。可交付的兼容结论至少要同时回答：样例能否解析、空间与单位是否一致、业务身份能否映射、时间和数据类型是否正确、访问是否合规、目标终端能否稳定运行，以及结论能否由测试证据复核。
这份兼容矩阵解决什么问题
项目资料中常见“支持GLB、IFC、3D Tiles、OPC UA、MQTT”等表述，但同一名称下仍可能存在版本、扩展、坐标参考系、数据类型、鉴权、网络区和运行终端差异。只在需求文档里写“支持”，容易把需要转换、需要网关、需要二次开发或仅在特定终端可用的情况混在一起。
本矩阵把一个资产或接口拆成可测试的条件，并把“直接兼容、需要转换、需要适配开发、暂不支持”与样例、目标环境和证据绑定。它适合用于项目边界确认，不替代第三方产品认证、协议一致性认证或合同验收文件。
应该在什么时候开始填写
| 阶段 | 需要取得的输入 | 矩阵产出 |
|---|---|---|
| 立项与需求确认 | 源文件清单、设备协议、地图与视频服务、业务接口、目标浏览器和部署环境。 | 每类输入的责任人、样例、版本、网络边界和初步兼容等级。 |
| 技术设计 | 坐标、单位、层级、材质、字段、主题、地址、鉴权和性能要求。 | 转换链路、网关或适配方式、身份映射、权限和验收方法。 |
| 联调 | 可访问的受控样例、测试账号、目标终端和数据更新条件。 | 实测结果、问题状态、性能限制、证据位置和责任人。 |
| 验收与变更 | 正式版本、替换资产、协议或接口变更、回归范围。 | 带版本的兼容结论、未关闭风险、复验记录和变更影响。 |
如果尚未形成项目资料目录，可先使用数字孪生项目前期资料清单收集输入；如果已经进入对象绑定阶段，再使用对象—资产—点位—页面映射模板记录业务身份和页面定位。兼容矩阵关注“能否在目标环境正确接入”，两者不重复。
矩阵覆盖的五类输入
| 类别 | 示例 | 不能遗漏的条件 |
|---|---|---|
| 三维模型与BIM | glTF/GLB、IFC、3D Tiles，以及作为输入的RVT、FBX、OBJ等源文件。 | 版本、扩展、坐标、单位、层级、构件属性、材质纹理、LOD、压缩和转换损失。 |
| GIS地图与空间数据 | WMTS、WMS、TMS、GeoJSON、地形、影像和倾斜摄影。 | 坐标参考系、轴顺序、图层或切片集、访问范围、样式、服务版本、缓存和空间精度。 |
| 视频流 | HLS等适合目标前端的播放地址，以及由受控网关转换的监控视频。 | 协议、容器与编解码、鉴权、跨域、并发、首帧、切换、断流恢复、区域权限和脱敏。 |
| 工业设备协议 | OPC UA、Modbus TCP、MQTT、BACnet/IP。 | 地址空间、寄存器或主题、数据类型、字节序、读写方向、频率、网络区、质量码和断线补传。 |
| 业务系统接口 | REST API、WebSocket、数据库视图、文件交换。 | 端点、版本、认证、请求与响应Schema、分页、限流、时间戳、幂等、错误码和字段权限。 |
兼容结论建议分为四级
| 兼容等级 | 适用条件 | 验收要求 |
|---|---|---|
| 直接兼容 | 目标系统可在约定版本和环境直接解析、访问并正确显示或使用。 | 仍需保留样例、环境、权限、功能和性能测试证据。 |
| 需要转换 | 通过可复现的离线或自动转换流程生成目标格式，业务语义和质量可接受。 | 核对转换工具与版本、损失项、输出规则、增量更新和原文件责任。 |
| 需要适配开发 | 需要插件、网关、服务端代理、协议转换或业务字段映射。 | 明确开发范围、接口边界、网络与权限、异常恢复、工期和维护责任。 |
| 暂不支持 | 在当前版本、部署条件或合规边界下无法满足要求。 | 记录限制原因、可替代方案、影响和重新评估条件，避免口头承诺。 |
兼容等级不是长期不变的产品标签。每一条结论都应同时限定源版本、样例、目标系统版本、浏览器或终端、网络环境和验收日期。
模板字段如何分组
| 字段组 | 需要记录 | 主要风险 |
|---|---|---|
| 记录属性 | 资产或接口类别、对象名称、业务用途、来源系统和提供方。 | 同名资产被混用，缺少责任人，无法取得可测试样例。 |
| 格式与空间 | 格式或协议、版本、扩展名或MIME、编解码、坐标参考系、单位、精度或LOD。 | 只匹配扩展名，坐标漂移，单位缩放错误，版本扩展不受支持。 |
| 结构与映射 | 层级与属性、材质纹理、端点和认证、路径或寄存器、Schema、业务ID、时间戳和频率。 | 模型能显示但对象不可查询，点位绑定错误，时间或数据类型被误读。 |
| 安全与授权 | 读写方向、网络区、权限与脱敏、资产授权或第三方许可状态。 | 前端暴露真实地址或令牌，越权读写，项目没有取得内容或接口使用权。 |
| 实现与性能 | 样例位置、转换或适配方式、性能限制、目标浏览器或终端。 | 演示样例可用但生产规模不可用，转换流程不可复现，端侧能力不一致。 |
| 结论与证据 | 兼容判定、验收方法、问题状态、责任人、证据位置、备注和参考来源。 | 结论没有条件和证据，问题无人关闭，后续变更无法回归。 |
一次兼容测试怎样执行
- 为每种格式、服务或协议取得最小可用样例，并记录来源、版本、使用授权和责任人。
- 确认目标系统、浏览器或终端版本以及部署网络，避免只在开发人员电脑上测试。
- 先验证解析、连接和认证，再核对坐标、单位、属性、数据类型、时间戳和业务身份映射。
- 如果需要转换或网关，记录工具、版本、参数、输入输出、失败处理和是否支持增量更新。
- 使用不同角色验证读取、控制、导出和前端显示权限，公开版本只保留脱敏占位符。
- 按接近生产的资产规模、点位频率、并发和网络条件测试加载、刷新、切换与断线恢复。
- 把日志、截图、示例请求、转换报告或录像保存到受控位置，并在矩阵中记录证据路径。
- 只有在问题关闭并完成回归后更新兼容等级；版本或环境变化后重新复验。
三维模型：格式可解析不等于语义可用
Khronos glTF规范注册表给出了glTF核心规范与扩展入口；buildingSMART IFC规范页面用于确认IFC版本；OGC 3D Tiles标准页面说明面向大规模三维地理内容的标准范围。项目核对应从这些规范入口确认版本，但不能直接据此推断某个具体引擎已经支持全部扩展和属性。
浏览器三维场景更关心运行时体量、层级、材质、纹理、坐标和拾取ID；BIM交付还关心构件分类、属性集和空间关系；大范围三维地理内容还关心分层加载、包围体和空间精度。源文件能够打开，并不表示转换后仍保留了对象查询、告警定位和设备绑定所需的信息。
对RVT、FBX、OBJ等源文件，应把“客户交付格式”和“目标运行格式”分开填写。转换验收至少包含几何数量、层级、材质纹理、坐标单位、关键属性、对象ID和性能对比。
GIS地图：重点核对坐标、服务版本和访问边界
OGC WMTS和OGC WMS是不同的地图服务标准，矩阵中应分别记录服务版本、Capabilities地址、图层或TileMatrixSet、坐标参考系、样式、鉴权和示例请求。TMS或厂商自定义切片也应单独建行，不能只写“支持地图”。
RFC 7946定义了GeoJSON格式及其坐标参考要求。对项目中的实际空间数据，还应核对客户坐标制度、轴顺序、经纬度范围、数据精度、敏感位置和与三维场景的转换关系，避免图层能加载但整体偏移或缩放错误。
视频流：不能只测试一条播放地址
RFC 8216记录了HTTP Live Streaming协议。实际项目仍需确认目标浏览器或播放组件支持的编解码、跨域和认证方式，以及摄像机网络是否允许通过受控网关访问。
兼容测试至少覆盖首帧时间、清晰度切换、并发、长时间播放、令牌过期、断流重连和权限变化。公开文档和前端页面不应出现真实摄像机地址、内网域名、用户名、密码或长期有效令牌。
工业协议：不同协议可能同时存在
OPC Foundation的OPC UA介绍、Modbus规范入口、OASIS MQTT 5.0规范和BACnet International介绍分别提供协议范围和规范入口。它们并不是同一层面的简单替代品，项目中可能由设备、控制系统、边缘网关和平台分别使用。
OPC UA要核对端点、安全策略、证书、命名空间、NodeId、数据类型、质量码和订阅；Modbus要核对功能码、地址偏移、寄存器类型、字节序和轮询周期；MQTT要核对Broker、版本、主题、QoS、保留、遗嘱、重连和消息Schema；BACnet/IP要核对设备发现、对象与属性、网络段以及读写权限。最终页面只应接收满足安全边界的业务数据，不应默认直连控制网络。
REST API与WebSocket：接口名称不是验收结论
REST API通常需要继续明确版本、认证、分页、限流、幂等、错误码、字段权限和时间格式；WebSocket则要核对握手、认证、消息Schema、心跳、重连、顺序和补发策略。RFC 6455是WebSocket协议规范入口，但具体业务消息结构仍应由项目接口文档定义。
如果同一告警既能查询历史列表，又能接收实时事件，建议在矩阵中分别记录REST查询接口和WebSocket事件通道，并用统一业务ID、时间戳和状态字段验证两条链路的一致性。
安全、隐私与资产授权
矩阵中的端点、设备地址、访问凭据、人员信息和空间数据可能属于敏感项目资料。公开或跨组织流转版本应使用占位符；真实地址、账号、令牌和证书位置应存放在受控系统中，并按最小权限、网络分区、审计和密钥轮换要求管理。
三维模型、地图、视频、字体、纹理、设备驱动和第三方接口还可能受合同或许可限制。模板中的“资产授权/第三方许可状态”用于提醒项目核对权利边界，不代表网站已经为任何外部资产取得许可，也不构成法律意见。
参考来源与适用边界
页面引用Khronos、buildingSMART、OGC、IETF RFC Editor、OPC Foundation、Modbus Organization、OASIS和BACnet International的公开规范或标准入口，用于帮助识别应核对的版本和能力范围。具体产品是否实现某项规范、扩展或配置，应以产品官方文档、供应商确认和目标环境实测为准。
模板中的11行均标注为“填写示例”，只说明记录方法，不对应真实客户、设备、地址、账号或兼容承诺。验收结论应由项目双方依据合同、技术协议、客户制度、测试环境和实际证据确认。
常见问题
数字孪生支持GLB、IFC或3D Tiles是不是就能直接用？
不一定。支持一种文件或服务格式只是第一层条件，还要核对版本、坐标与单位、层级和属性、材质纹理、身份映射、加载性能、权限以及目标浏览器或终端。矩阵把这些条件和测试证据分开记录。
RVT、FBX、OBJ等源文件能直接在浏览器加载吗？
通常需要先转换为目标运行环境支持的格式，并用实际样例核对几何、材质、坐标、构件属性和层级是否保留。源文件可作为交付输入，但不能只凭扩展名承诺浏览器直接加载。
WMTS、WMS、TMS有什么区别，矩阵怎么填？
它们的服务能力、请求方式、切片规则和客户端适配不同，应按实际端点分别建行，记录服务版本、坐标参考系、图层或TileMatrixSet、鉴权、访问范围、示例请求和目标终端测试结果，不要只写一个笼统的地图服务。
OPC UA、Modbus、MQTT和BACnet需要四选一吗？
不需要。它们可能位于不同设备、网络或数据分发层，也可能由边缘网关完成转换。应分别记录地址或主题、数据类型、读写方向、采样频率、网络区、权限和断线恢复策略，再明确平台实际接入边界。
视频地址能直接放进数字孪生前端吗？
不能据此直接判断。还要核对协议与编解码、跨域、令牌有效期、并发、首帧与切换延迟、断流恢复、区域访问限制和脱敏要求。公开模板中不要填写真实摄像机地址、账号或令牌。
兼容判定有哪四级？
可按直接兼容、需要转换、需要适配开发和暂不支持四级记录。判定必须限定版本、样例、目标终端和验收方法；离开这些条件，单独的支持或不支持结论容易被误用。
公开模板能写真实IP、账号和访问令牌吗？
不应填写。公开或跨组织流转的版本应使用占位符，并对设备地址、内网域名、账号、令牌、人员信息和敏感空间数据做脱敏。真实配置应留在受控项目资料中并按最小权限管理。
填完矩阵是否代表通过验收或获得产品认证？
不代表。矩阵是测试范围、结论和证据的组织工具，最终验收仍应依据项目合同、技术协议、客户制度和实测结果。示例行不构成对任何第三方产品、格式或协议组合的兼容承诺。
模板可以免费商用或再分发吗？
当前页面提供免费下载，但网站尚未公布适用于该模板的统一复制、修改、再分发或商业使用许可。若使用方式超出项目内部填写与评估，请先向北京泓珊科技有限公司确认授权边界。
下载与相关资料
CSV采用UTF-8 BOM与CRLF换行，便于中文环境下导入表格工具；Excel版提供“使用说明”和带筛选、冻结窗格、状态下拉的“兼容矩阵”工作表。两份文件中的示例行都应替换为项目实测信息。
下载免费不等于已经授予复制、修改、再分发或商业使用许可。网站目前没有公开统一模板许可证；超出项目内部填写与评估的使用方式，请先确认授权边界。
继续梳理资料和映射关系，可使用数字孪生项目前期资料清单、对象—资产—点位—页面映射模板和点位与告警分级模板。技术路线可阅读WebGL、Cesium与UE5数字孪生怎么选，实时数据接入可阅读工业实时数据接入与验收指南。