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：
1 {
2 "callback" : "https://api.glodon.com/viewing/callback?authCode=6kj0Jk0affae&signature=2ef131395fb6442eb99abd83d45c6016",
3 "config" : {},
4 "name" : "integrate",
5 "sourceId" : "hduf2w3ho21nowr23rqwjrn2o3",
6 "sources" : [ {
7 "fileId" : 1656504297006400
8 },
9 {
10 "fileId" : 1552501367034816
11 }]
12 }
HTTP响应示例(200)：
1 {
2 "code" : "success",
3 "data" : {
4 "createTime" : "2017-12-25 17:25:25",
5 "integrateId" : 1248789977538784,
6 "name" : "integrate-x",
7 "reason" : "reason",
8 "sourceId" : "123156522123",
9 "status" : "success",
10 "thumbnail" : [ "https://m.bimface.com/dc6aa5e35b6a269972b005b4b2aac8ce/thumbnail/96.png", "https://m.bimface.com/dc6aa5e35b6a269972b005b4b2aac8ce/thumbnail/256.png" ]
11 },
12 "message" : ""
13 }
C#实现方法：
1 /// <summary>
2 /// 发起2个模型集成。
3 /// 由于集成不能立即完成，BIMFACE支持在模型集成完成以后，通过Callback机制通知调用方；另外，调用方也可以通过接口查询集成状态。
4 /// </summary>
5 /// <param name="accessToken">【必填】令牌</param>
6 /// <param name="fileId1">集成时的请求参数</param>
7 /// <param name="fileId2">集成时的请求参数</param>
8 /// <param name="callBack">集成时的请求参数</param>
9 /// <returns></returns>
10 public virtual ModelIntegrateResponse Integrate(string accessToken, long fileId1, long fileId2, string callBack = "")
11 {
12 //PUT https://api.bimface.com/integrate
13 string url = BIMFaceConstants.API_HOST + "/integrate";
14
15 FileIntegrateRequest request = new FileIntegrateRequest();
16
17 IntegrateSource source1 = new IntegrateSource(fileId1);
18 IntegrateSource source2 = new IntegrateSource(fileId2);
19 request.Sources = new IntegrateSource[] { source1, source2 };
20 request.CallBack = callBack;
21
22 string data = request.SerializeToJson();
23
24 BIMFaceHttpHeaders headers = new BIMFaceHttpHeaders();
25 headers.AddOAuth2Header(accessToken);
26
27 try
28 {
29 ModelIntegrateResponse response;
30
31 HttpManager httpManager = new HttpManager(headers);
32 HttpResult httpResult = httpManager.Put(url, data);
33 if (httpResult.Status == HttpResult.STATUS_SUCCESS)
34 {
35 response = httpResult.Text.DeserializeJsonToObject<ModelIntegrateResponse>();
36 }
37 else
38 {
39 response = new ModelIntegrateResponse
40 {
41 Message = httpResult.RefText
42 };
43 }
44
45 return response;
46 }
47 catch (Exception ex)
48 {
49 throw new BIMFaceException("[发起模型集成]发生异常！", ex);
50 }
51 }
代码中使用的 HttpManager 类请参考我的博客文章《C# HTTP系列 HttpWebRequest 与 HttpWebResponse》。
返回类型 ModelIntegrateResponse 类如下：
1 public class ModelIntegrateResponse : GeneralResponse<FileIntegrateBean>
2 {
3
4 }
1 public class FileIntegrateBean
2 {
3 /// <summary>
4 /// 对比开始时间，格式：yyyy-MM-dd hh:mm:ss
5 /// </summary>
6 [JsonProperty("createTime", NullValueHandling = NullValueHandling.Ignore)]
7 public string CreateTime { get; set; }
8
9 /// <summary>
10 /// 集成成功后返回的ID，用于获取对比状态或者结果等信息
11 /// </summary>
12 [JsonProperty("integrateId", NullValueHandling = NullValueHandling.Ignore)]
13 public long? IntegrateId { get; set; }
14
15 /// <summary>
16 /// 用户指定集成后的模型的名字
17 /// </summary>
18 [JsonProperty("name", NullValueHandling = NullValueHandling.Ignore)]
19 public string Name { get; set; }
20
21 /// <summary>
22 /// 对比优先级。取值 1、2、3。数字越大，优先级越低。默认为2
23 /// </summary>
24 [JsonProperty("priority", NullValueHandling = NullValueHandling.Ignore)]
25 public int? Priority { get; set; }
26
27 /// <summary>
28 /// 若对比失败，返回失败原因
29 /// </summary>
30 [JsonProperty("reason", NullValueHandling = NullValueHandling.Ignore)]
31 public string Reason { get; set; }
32
33 /// <summary>
34 /// 第三方应用自己的ID
35 /// </summary>
36 [JsonProperty("sourceId", NullValueHandling = NullValueHandling.Ignore)]
37 public string SourceId { get; set; }
38
39 /// <summary>
40 /// 对比状态:prepare（待对比）、processing（对比中）、success（对比成功）、failed（对比失败）
41 /// </summary>
42 [JsonProperty("status", NullValueHandling = NullValueHandling.Ignore)]
43 public string Status { get; set; }
44
45 [JsonProperty("thumbnail", NullValueHandling = NullValueHandling.Ignore)]
46 public string[] Thumbnails { get; set; }
47
48 /// <summary>
49 /// 模型集成的类型 rvt(或者igms…)
50 /// </summary>
51 [JsonProperty("type", NullValueHandling = NullValueHandling.Ignore)]
52 public string Type { get; set; }
53 }
测试程序：
BIMFACE控制台中查询到的集成结果如下：
集成成功后，等待一段时间，查看集成结果如下图：
上述测试程序使用了 《BIMFace.SDK.CSharp》开源SDK。欢迎大家下载使用。
BIMFACE二次开发系列目录 【已更新最新开发文章，点击查看详细】