C#开发BIMFACE系列40 服务端API之模型集成

BIMFACE二次开发系列目录     【已更新最新开发文章，点击查看详细】

　　随着建筑信息化模型技术的发展，越来越多的人选择在云端浏览建筑模型。现阶段的云端模型浏览大多是基于文件级别，一次只可以浏览一个模型文件中的内容。而在工程项目模型设计的过程中，通常由多个设计师协同设计，不同的设计师负责不同的专业领域（例如建筑、结构、水电等）。如果想要在云端浏览整个项目工程，就需要把这些组成部分集成起来一起展示。更近一步，如果要在集成的模型之上进行业务集成的话，就要求在集成过程中对构件按单体，楼层，专业，构件分类，系统类型等进行分类或映射。

　　目前在实际项目中，不同专业的团队成员可能会采用不同软件进行建模，然后再将不同格式的模型导入如Navisworks等软件中，但这样的方法有如下的缺点：

• 即使仅为了满足浏览模型的需求，也需要安装用来集成不同格式模型的桌面端软件；
• 桌面端软件支持的模型文件格式有限，无法满足多种文件格式的模型集成需求；
• 在诸如Navisworks等软件中进行的模型导入只做了几何的导入集成，不支持上面提到的建筑领域各种分类信息；
• 只支持桌面端浏览模型，同时软件也对操作系统有明确要求，普遍无法支持移动端的iOS和安卓操作系统；

针对上述的限制，BIMFACE的模型集成，能完美解决上述的所有问题。

在业务方面，BIMFACE的模型集成能：

• 集成不同专业的模型，包括建筑、结构、装修、幕墙、钢构，以及机电中给排水、采暖燃气、通风空调、消防、强弱电等各专业。
• 自定义楼层映射
• 支持单体，系统类型，构件类型等其他分类维度
• 支持模型链接集成，如带标准层的集成模型
• 支持自定义文件转换矩阵（transform）

在技术方法，BIMFACE的模型集成充分运用了云端无穷的计算资源，在模型集成过程中：

• 运用图形几何算法进行了如下优化，大大提升在浏览器里能展示模型的规模以及渲染的性能:构件属性在云端进行入库索引，提供任意的属性查询能力。
  • 识别基本体
  • 实例绘制优化
  • 同材质全场景动态合并
  • 外围壳光线追踪识别
• 构件属性在云端进行入库索引，提供任意的属性查询能力

当单个模型文件转换成功以后，可以将多个单文件集成，生成一个全专业/楼层模型。由于集成不能立即完成，BIMFACE支持在模型集成完成以后，通过Callback机制通知调用方（请参考作者的博客《C#开发BIMFACE系列36 服务端API回调机制》）；另外，调用方也可以通过接口查询集成状态。目前BIMFACE支持集成的模型文件格式包括：rvt、dgn、ifc、nwd、skp、3dm、3ds、fbx、stp。

下面的截图分别是建筑模型、结构模型、集成后的模型效果图，可以直观的看出建筑与结构集成后的效果。

BIMFACE官方提供了非常丰富的模型集成接口

下面详细讲解模型集成接口如何实现上述的集成效果。

接口地址：PUT https://api.bimface.com/integrate

接口参数：

请求 header(示例)："Authorization: Bearer dc671840-bacc-4dc5-a134-97c1918d664b"

请求 body：

{
  "callback" : "https://api.glodon.com/viewing/callback?authCode=6kj0Jk0affae&signature=2ef131395fb6442eb99abd83d45c6016",
  "config" : {},
  "name" : "integrate",
  "sourceId" : "hduf2w3ho21nowr23rqwjrn2o3",
  "sources" : [ {
    "fileId" : 1656504297006400
  },
   {
    "fileId" : 1552501367034816
  }]
}

HTTP响应示例(200)：

{
  "code" : "success",
  "data" : {
    "createTime" : "2017-12-25 17:25:25",
    "integrateId" : 1248789977538784,
    "name" : "integrate-x",
    "reason" : "reason",
    "sourceId" : "123156522123",
    "status" : "success",
    "thumbnail" : [ "https://m.bimface.com/dc6aa5e35b6a269972b005b4b2aac8ce/thumbnail/96.png", "https://m.bimface.com/dc6aa5e35b6a269972b005b4b2aac8ce/thumbnail/256.png" ]
  },
  "message" : ""
}

C#实现方法：

/// <summary>
/// 发起2个模型集成。
/// 由于集成不能立即完成，BIMFACE支持在模型集成完成以后，通过Callback机制通知调用方；另外，调用方也可以通过接口查询集成状态。
/// </summary>
/// <param name="accessToken">【必填】令牌</param>
/// <param name="fileId1">集成时的请求参数</param>
/// <param name="fileId2">集成时的请求参数</param>
/// <param name="callBack">集成时的请求参数</param>
/// <returns></returns>
public virtual ModelIntegrateResponse Integrate(string accessToken, long fileId1, long fileId2, string callBack = "")
{
    //PUT https://api.bimface.com/integrate
    string url = BIMFaceConstants.API_HOST + "/integrate";

    FileIntegrateRequest request = new FileIntegrateRequest();

    IntegrateSource source1 = new IntegrateSource(fileId1);
    IntegrateSource source2 = new IntegrateSource(fileId2);
    request.Sources = new IntegrateSource[] { source1, source2 };
    request.CallBack = callBack;

    string data = request.SerializeToJson();

    BIMFaceHttpHeaders headers = new BIMFaceHttpHeaders();
    headers.AddOAuth2Header(accessToken);

    try
    {
        ModelIntegrateResponse response;

        HttpManager httpManager = new HttpManager(headers);
        HttpResult httpResult = httpManager.Put(url, data);
        if (httpResult.Status == HttpResult.STATUS_SUCCESS)
        {
            response = httpResult.Text.DeserializeJsonToObject<ModelIntegrateResponse>();
        }
        else
        {
            response = new ModelIntegrateResponse
            {
                Message = httpResult.RefText
            };
        }

        return response;
    }
    catch (Exception ex)
    {
        throw new BIMFaceException("[发起模型集成]发生异常！", ex);
    }
}

代码中使用的 HttpManager 类请参考我的博客文章《C# HTTP系列 HttpWebRequest 与 HttpWebResponse》。

返回类型 ModelIntegrateResponse 类如下：

 public class ModelIntegrateResponse : GeneralResponse<FileIntegrateBean>
 {

 }

    public class FileIntegrateBean
    {
    /// <summary>
    /// 对比开始时间，格式：yyyy-MM-dd hh:mm:ss
    /// </summary>
    [JsonProperty("createTime", NullValueHandling = NullValueHandling.Ignore)]
    public string CreateTime { get; set; }

    /// <summary>
    /// 集成成功后返回的ID，用于获取对比状态或者结果等信息
    /// </summary>
    [JsonProperty("integrateId", NullValueHandling = NullValueHandling.Ignore)]
    public long? IntegrateId { get; set; }

    /// <summary>
    /// 用户指定集成后的模型的名字
    /// </summary>
    [JsonProperty("name", NullValueHandling = NullValueHandling.Ignore)]
    public string Name { get; set; }

    /// <summary>
    /// 对比优先级。取值 1、2、3。数字越大，优先级越低。默认为2
    /// </summary>
    [JsonProperty("priority", NullValueHandling = NullValueHandling.Ignore)]
    public int? Priority { get; set; }

    /// <summary>
    ///  若对比失败，返回失败原因
    /// </summary>
    [JsonProperty("reason", NullValueHandling = NullValueHandling.Ignore)]
    public string Reason { get; set; }

    /// <summary>
    ///  第三方应用自己的ID
    /// </summary>
    [JsonProperty("sourceId", NullValueHandling = NullValueHandling.Ignore)]
    public string SourceId { get; set; }

    /// <summary>
    ///  对比状态:prepare（待对比）、processing（对比中）、success（对比成功）、failed（对比失败）
    /// </summary>
    [JsonProperty("status", NullValueHandling = NullValueHandling.Ignore)]
    public string Status { get; set; }

    [JsonProperty("thumbnail", NullValueHandling = NullValueHandling.Ignore)]
    public string[] Thumbnails { get; set; }

    /// <summary>
    /// 模型集成的类型 rvt(或者igms…​)
    /// </summary>
    [JsonProperty("type", NullValueHandling = NullValueHandling.Ignore)]
    public string Type { get; set; }
    }

测试程序：

BIMFACE控制台中查询到的集成结果如下：

集成成功后，等待一段时间，查看集成结果如下图：

上述测试程序使用了 《BIMFace.SDK.CSharp》开源SDK。欢迎大家下载使用。

BIMFACE二次开发系列目录     【已更新最新开发文章，点击查看详细】