如何获取BIM 360云协同Revit模型为C# Autodesk.Revit.DB Document类

实现步骤 #

• 确保Revit用户已登录BIM 360账户，且有权限访问目标项目和模型
• 通过BIM 360 API获取目标模型的项目ID和模型ID（可通过项目浏览器或API接口查询）
• 使用Revit API的Application.OpenCloudModel方法直接打开云模型，返回Document实例（无需下载本地副本）

代码示例 #

using Autodesk.Revit.ApplicationServices;
using Autodesk.Revit.DB;
using Autodesk.Revit.UI;

public void AccessBIM360CloudModel(UIApplication uiApp)
{
    Application revitApp = uiApp.Application;
    // 替换为实际的BIM 360项目ID和模型ID
    string bim360ProjectId = "a1b2c3d4-5678-90ef-ghij-klmnopqrstuv";
    string cloudModelId = "wxyz-1234-5678-abcd-efghijklmnop";

    try
    {
        Document cloudDoc = revitApp.OpenCloudModel(bim360ProjectId, cloudModelId);
        // 对云模型执行操作，比如获取元素、修改参数等
        TaskDialog.Show("操作成功", $"已打开云模型：{cloudDoc.Title}");
    }
    catch (Autodesk.Revit.Exceptions.InvalidOperationException ex)
    {
        TaskDialog.Show("错误", $"打开云模型失败：{ex.Message}");
    }
    catch (Autodesk.Revit.Exceptions.ArgumentException ex)
    {
        TaskDialog.Show("错误", $"项目或模型ID无效：{ex.Message}");
    }
}

代码示例来源 #

Autodesk官方Revit SDK中的CloudModelManagement项目包含云模型操作的完整示例，涵盖模型列表获取、打开、协同操作等场景。

原因说明 #

最新版Autodesk Forge SDK（Autodesk.Forge NuGet包）已重构API结构，旧版的ForgeClient和OSSObjectsApi类被废弃，替换为更清晰的服务类结构。

替换方案 #

• ForgeClient → ForgeServiceClient：用于初始化OAuth认证和服务客户端
• OSSObjectsApi → ObjectsApi：属于Autodesk.Forge.Services.Objects命名空间，处理OSS对象操作

修正后的代码示例 #

using Autodesk.Forge;
using Autodesk.Forge.Services;
using Autodesk.Forge.Services.Objects;
using System.Collections.Generic;

public async Task UseUpdatedForgeSDK()
{
    // 配置Forge凭证和权限
    var forgeConfig = new ForgeConfiguration
    {
        ClientId = "你的Forge客户端ID",
        ClientSecret = "你的Forge客户端密钥",
        Scope = new List<string> { "data:read", "data:write", "bucket:read" } // 根据需求调整权限
    };

    // 初始化服务客户端
    var forgeClient = new ForgeServiceClient(forgeConfig);

    // 创建ObjectsApi实例
    var objectsApi = new ObjectsApi(forgeClient);

    // 示例：获取指定存储桶中的所有对象
    var bucketKey = "你的存储桶密钥";
    var objectsResponse = await objectsApi.GetObjectsAsync(bucketKey);
    
    foreach (var obj in objectsResponse.Items)
    {
        // 处理对象信息
        System.Console.WriteLine($"对象名称：{obj.ObjectKey}");
    }
}

额外注意事项 #

1. 确保已安装最新版本的Autodesk.Forge NuGet包（可通过NuGet包管理器更新）
2. 替换旧的命名空间引用，所有服务类均位于Autodesk.Forge.Services及其子命名空间下

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