Autodesk Viewer中哪些文件格式需URN列表才能完整查看?
Autodesk Viewer API 格式处理与URN使用说明
核心逻辑
Autodesk Viewer对文件的处理逻辑完全基于文件转换后生成的衍生资源结构:
- 若转换后仅生成单个可加载的模型/视图资源,使用单个URN就能完整显示所有内容
- 若转换后将源文件拆分为多个独立的模型/视图资源(比如多专业视图、多元素集合),则需要传入URN列表才能加载全部内容
目标格式的具体表现
单个URN即可完整显示的格式
- DWG/DXF:转换后生成单个模型资源,单个URN就能加载所有图纸/模型内容
- 3DM(Rhino):转换后为单一模型资源,无需URN列表
- 3DS:单个模型资源,单URN加载即可
- CATPART:单个零件文件转换后对应单一模型,单URN足够
- DAE:单个模型资源,单URN加载
- FBX:单个模型资源,单URN可加载全部内容
- IGES:单个模型资源,单URN即可
- OBJ:单个模型资源,单URN加载
- RVT(Revit):转换后生成整合的项目模型资源,单个URN就能加载整个项目的所有视图和元素
- SKP(SketchUp):单个模型资源,单URN加载全部内容
- STL:单个模型资源,单URN足够
- STEP:单个模型资源,单URN加载
需要URN列表加载全部内容的格式
- IFC:IFC文件通常包含多专业、多元素集合,转换后会拆分为多个独立的模型资源(比如建筑结构、机电、暖通等各自的资源),仅用单个URN只能加载其中一部分,必须传入所有衍生资源的URN列表才能显示完整内容
- NWD(Navisworks):Navisworks文件可能包含多个合并的模型或视图,转换后会生成多个衍生资源,需要URN列表才能加载全部内容
验证方法
如果不确定某个格式的处理方式,可以通过以下步骤确认:
- 调用Model Derivative API的
GET {urn}/manifest接口查询转换后的衍生资源结构 - 查看返回结果中的
derivatives数组:- 若包含多个
type为geometry或viewable的条目,则需要使用URN列表加载 - 若仅存在单个此类条目,使用单个URN即可
- 若包含多个
内容的提问来源于stack exchange,提问作者Fabio Formentini
相关产品推荐
相关产品推荐

