如何开始使用Autodesk Forge？求助Revit BIM导入入门步骤

一、前置准备 #

• 保留创建Forge应用时生成的Client ID和Client Secret
• 本地Revit软件可正常打开目标.rvt模型文件
• 明确Forge核心依赖服务：
  • Data Management API：负责文件的上传、存储与管理
  • Model Derivative API：负责将Revit格式转换为在线可查看的轻量化格式

二、上传模型至Forge云存储 #

1. 获取访问令牌
   • 用Client ID和Secret调用认证接口，申请包含data:read和data:write权限的access_token
   • 命令行示例（curl）：

     curl -v "https://developer.api.autodesk.com/authentication/v1/authenticate" \
       -X POST \
       -H "Content-Type: application/x-www-form-urlencoded" \
       -d "client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=client_credentials&scope=data:read data:write"
     

2. 创建存储桶
   • 调用Data Management API创建全局唯一的存储桶，指定权限策略（如transient临时存储）
   • 命令行示例：

     curl -v "https://developer.api.autodesk.com/oss/v2/buckets" \
       -X POST \
       -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
       -H "Content-Type: application/json" \
       -d '{"bucketKey":"your-unique-bucket-name","policyKey":"transient"}'
     

3. 上传Revit模型
   • 将本地.rvt文件上传至已创建的存储桶
   • 命令行示例：

     curl -v "https://developer.api.autodesk.com/oss/v2/buckets/your-unique-bucket-name/objects/your-model-name.rvt" \
       -X PUT \
       -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
       -H "Content-Type: application/octet-stream" \
       --data-binary "@/local/path/to/your/model.rvt"
     

三、转换模型为可查看格式 #

1. 获取文件URN
   • 上传成功后，接口返回的objectId经Base64编码（去除末尾=）即为模型URN
2. 提交转换任务
   • 调用Model Derivative API，指定输出格式为svf2（推荐轻量化格式），包含2D/3D视图
   • 命令行示例：

     curl -v "https://developer.api.autodesk.com/modelderivative/v2/designdata/job" \
       -X POST \
       -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
       -H "Content-Type: application/json" \
       -d '{"input":{"urn":"YOUR_BASE64_URN"},"output":{"formats":[{"type":"svf2","views":["2d","3d"]}]}}'
     

3. 检查转换进度
   • 调用接口查询任务状态，直到返回success
   • 命令行示例：

     curl -v "https://developer.api.autodesk.com/modelderivative/v2/designdata/YOUR_BASE64_URN/manifest" \
       -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
     

四、在线查看模型 #

转换完成后，通过Forge Viewer组件加载模型：

• 在网页中引入Viewer的官方脚本与样式
• 初始化Viewer实例，传入模型URN和有效访问令牌，即可启动在线查看

可用参考资源 #

• Forge官方文档中「Data Management API入门」「Model Derivative API入门」章节
• Forge Viewer官方示例代码集
• Revit与Forge集成官方分步教程

内容的提问来源于stack exchange，提问作者Pegah