Autodesk View and Data API 二次开发学习指南

View and Data API 已停止新功能开发，由 Forge Viewer 接替。​ 本指南针对其技术核心，助你快速上手。

1. 🌐 基础准备与环境搭建

• 理解核心概念：API 核心是 “模型转换 (Translate)”​ 和 “查看器 (Viewer)”。先将用户上传的 DWG/Revit 等文件在云端转换为 SVF 格式，再通过 JS 库在网页中加载。
• 获取凭证：在 Autodesk Forge注册，创建应用，获取 Client ID和 Client Secret。
• 搭建本地服务器：由于涉及跨域，需本地 HTTP 服务器。推荐使用 Node.js的 http-server或 VS Code的 Live Server插件。

2. 📤 核心流程一：文件转换

• 上传文件：使用 POST /oss/v2/buckets/{bucketKey}/objects/{objectName}将本地模型文件上传到 OSS (对象存储)。
• 发起转换任务：使用 POST /modelderivative/v2/designdata/job提交转换任务，指定输出格式为 svf。
• 轮询检查状态：使用 GET /modelderivative/v2/designdata/{urn}/manifest检查转换状态，直到 status变为 success。

3. 🖼️ 核心流程二：网页嵌入查看器

• 引入 Viewer JS：在 HTML 中引入 https://developer.api.autodesk.com/modelderivative/v2/viewers/7.*/viewer3D.min.js。
• 初始化 Viewer： 用 Autodesk.Viewing.Initializer初始化环境，传入 Client ID。 用 Autodesk.Viewing.Document.load加载已转换模型的 urn。 调用 doc.getRoot().getDefaultGeometry()获取模型，并通过 viewerApp.bootstrap将其加载到 div容器中。

4. 🎨 核心流程三：基础交互与扩展

• 基础操作：学习 viewer.setTheme(), viewer.fitToView()等 API 控制视图。
• 事件监听：使用 viewer.addEventListener(Autodesk.Viewing.SELECTION_CHANGED_EVENT, callback)响应用户选择。
• 自定义扩展 (Extension)：这是二次开发的关键。创建 JS 类继承 Autodesk.Viewing.Extension，在 load()和 unload()方法中实现自定义 UI 按钮、面板和模型操作（如高亮构件、获取属性）。

5. 🔍 学习资源与工具

• 官方文档：Forge Learning是核心，含 API 参考和教程。
• 官方示例：GitHub 上的 view-and-data-api-samples和 learn.forge仓库，是学习最佳起点。
• 调试工具：熟练使用浏览器开发者工具 (F12) 的 Network 面板，观察 API 请求和返回数据。

免责声明：本文系网络转载或改编，未找到原创作者，版权归原作者所有。如涉及版权，请联系删