# 模型集成
# 背景
随着建筑信息化模型技术的发展，越来越多的人选择在云端浏览建筑模型。现阶段的云端模型浏览大多是基于文件级别，一次只可以浏览一个模型文件中的内容。而在工程项目的模型设计通常由多个设计师协同完成，不同的设计师负责不同的专业模型（例如建筑、结构、水电等）。如果想要在云端浏览整个项目模型，就需要把各专业的模型集成起来一起展示。如果要在集成模型上反应业务特点，可以在集成过程中进一步对构件按单体、楼层、专业、构件分类、系统类型等维度进行分类或映射。
在业务方面，BIMFACE的模型集成能够：
- 集成不同专业的模型，包括建筑、结构、装修、幕墙、钢构，以及机电中给排水、采暖燃气、通风空调、消防、强弱电等各专业
- 自定义楼层映射
- 支持单体，系统类型，构件类型等其他分类维度
- 支持模型链接集成，如带标准层的集成模型
- 支持自定义文件转换矩阵（transform）
# 说明
- 原始文件转换成功后才可参与集成；
- 发起集成的文件中不能包含同名文件；
- 目前BIMFACE支持集成的文件格式包括：rvt、igms、ifc、bmv、3ds、dgn、fbx、skp、nwd、3dm、stp、gmp、gtj、gqi、gjg、gdq、dwg、rvm；
- BIMFACE支持不同格式的文件混合集成；
- 单次被集成的文件数量上限为100个。
# 主要流程
模型上传转换成功后，即可发起模型集成。通过控制台页面进行模型集成的说明，详见模型集成配置 (opens new window)。本篇文章介绍通过服务端API发起模型集成的方法。
# 1. 配置转换参数
一般情况下，使用默认参数调用集成API即可，如果需要根据业务需求对集成模型进行特殊处理，可以在集成时添加自定义的参数，目前BIMFACE提供了以下参数：
| 字段 | 描述 | 取值 | 默认值 |
|---|---|---|---|
| floorRemap | 是否按标高进行楼层的重新分配 | true，false | true |
| positioning | 按模型共享坐标集成，或者按项目基点对齐集成 | sharedCoordinates, projectBasePoint | 空 |
| integrate-with-links | 是否使用链接集成方法 | true，false | true |
| enableOverlay | 当进行链接集成时，“覆盖”参照类型是否生效，默认为false, 即所有子文件的链接可见 | true，false | false |
| fileType | 指定文件格式 | String | 空 |
| customizedTree | 自定义构件树 | Array | 空 |
| toBimtiles | 是否采用流式加载 | true，false | true |
| bimtilesVersion | 流式加载数据版本，仅"toBimtiles"为true时生效 | V2，V3 | V3 |
# 2. 发起模型集成
调用服务端API即可发起模型集成。 API：发起模型集成 (opens new window)
# 3. 获取集成状态
由于集成不能立即完成，BIMFACE支持在模型集成完成以后，通过Callback机制通知调用方；另外，调用方也可以通过服务端接口查询集成状态。 API：查询集成状态 (opens new window)
# 4. 显示集成模型
模型集成成功后，通过服务端接口可以获取集成模型的View Token，并通过BIMFACE提供的显示组件进行加载。 API：获取模型的View Token (opens new window)
# 链接集成说明
# 功能介绍
为了简化建模步骤，在建模过程中会有很多标准层的文件，通过文件间的链接，可以避免重复的建模过程并降低硬件的压力。下图为Revit中的“管理链接”面板，关于嵌套链接模型的解释可以参考Revit的官方帮助文档 (opens new window)。
BIMFACE支持复杂链接关系的复原，并按照链接关系生成集成模型。使用链接集成时需要注意以下三点：
- 链接集成的功能只适用于rvt文件；
- 梳理文件的链接关系，保证主文件（初始打开的rvt文件）没有被项目中其他文件链接；
- 集成时添加config参数{"integrate-with-links":"true"} 。
# 关于梳理文件的链接关系的建议
由于实际建模过程中的情况非常复杂，很多用户使用链接集成的功能比较困难，所以在这里我们提供了一个简便的梳理方案。
假设你现在有一组文件，其中A.rvt文件为主文件，即当你在Revit中打开A.rvt，你可以看到整体模型。现在只需3步即可完成梳理：
- 新建一个rvt文件，名称不与该组文件其他文件重复即可，这里假设为all.rvt；
- 打开all.rvt文件，把A.rvt链接进来，“参照类型”设为“覆盖”、“附着”均可；
- 打开A.rvt文件，打开“管理链接”面板，把所有的“参照类型”设为“附着”；
最后把该组文件和all.rvt文件一起上传到BIMFACE进行链接集成即可。
