如何获取Autodesk Viewable的全局偏移（无需加载至Viewer）

核心逻辑 #

全局偏移（global offset）是模型原生坐标系与Viewer世界坐标系的转换参数，主要存储在Viewable的衍生清单（manifest）或元数据（metadata）中。

无需加载Viewer，通过Model Derivative API获取 #

步骤1：获取目标Viewable的衍生清单 #

调用GET https://developer.api.autodesk.com/modelderivative/v2/designdata/{urn}/manifest接口，返回的JSON结构中：

• 定位到你选中的3D Viewable对应的derivatives条目；
• 记录该条目下的metadata.guid（用于后续元数据查询），部分SVF2资源可直接在metadata字段中找到globalOffset（格式为[x, y, z]数组）。

步骤2：查询Viewable元数据获取偏移 #

如果步骤1中未直接拿到globalOffset，调用GET https://developer.api.autodesk.com/modelderivative/v2/designdata/{urn}/metadata/{guid}接口：

• 在返回的JSON的data.metadata节点下，globalOffset字段即为所需的全局偏移值。

备选方案：解析viewable.json文件 #

若上述接口未返回偏移参数，可从manifest中提取目标3D资源的urn（即derivatives.children[0].urn），调用GET https://developer.api.autodesk.com/modelderivative/v2/designdata/{urn}/manifest/{resourceUrn}下载viewable.json文件：

• 在文件的model或camera节点中，可找到坐标系偏移相关参数，转换为全局偏移值。

内容的提问来源于stack exchange，提问作者Gustavo da Costa e Silva