BIMFACE 是广联达公司旗下的一款具有完全自主知识产权的BIM轻量化引擎，建筑行业的软件开发者可在BIMFACE所提供的基础功能上进行二次开发，为终端用户提供更加丰富、更有价值的BIM应用。
在我的博客《C#二次开发BIMFACE系列》教程中详细介绍了如何注册BIMFACE、测试、封装服务器端接口并提供了丰富的Demo、视频教程等内容。目前已有70多家建筑公司、高校及个人软件开发者使用了我封装的开源 BIMFACE SDK，期间交流非常多，反馈非常不错。该SDK也在江苏省多个地区的《建设工程施工图数字化审查系统》、《建设工程施工图BIM智能审查系统》中经过多次实战检验，功能全面、性能稳定。从另一方面也说明BIMFACE产品的功能之强大、性能之稳定、服务之完善，是值得信赖的BIM轻量化引擎。
在《C# 开发 BIMFACE 系列文章》中介绍了模型转换、模型对比接口。这2个功能接口比较特殊，发起请求后，逻辑处理是在BIMFACE云端进行的，通常需要5~10分钟。当逻辑处理完成后，BIMFACE通过回调机制通知对比结果。
在之前的《C#开发BIMFACE系列》中主要介绍了BIMFACE平台提供的服务端API接口的封装开发与测试过程。
请求地址：GET https://api.bimface.com/data/v2/files/{fileId}/views
C#开发BIMFACE系列3 服务端API之获取应用访问凭证AccessToken
BIMFACE 平台是一个对外开放的平台，建筑行业的相关公司、软件公司或者有 BIM 业务需求的公司都可以注册成为开发者并使用其提供的强大功能。
BIMFACE的常规应用方式有公有云与私有化部署两种方式，并且浏览模型或者图纸需要使用ViewToken，ViewToken 有效期为12小时，过期后需要调用接口重新生成。该过程稍微有点麻烦且性能可能受到网络等环境的影响。本文介绍第三种更加便捷高效的方式。
在前一篇博客《C#开发BIMFACE系列49 Web网页集成BIMFACE应用的技术方案》中介绍了目前市场主流的Web开发技术与应用框架，其中前端脚本的应用在国内分2大派系 jQuery 与 Vue.js。
在上一篇《C#开发BIMFACE系列30 服务端API之模型对比1：发起模型对比》中发起了2个模型对比，由于模型对比是在BIMFACE云端进行的，通常需要5~10分钟。当模型对比完成后，BIMFACE通过回调机制通知对比结果。
一个三维模型中可能包含对应多张二维图纸列表，本篇主要介绍如何获取模型文件对应的图纸列表。
在我的前一篇博客《C#开发BIMFACE系列41 服务端API之模型对比》中详细介绍了BIMFACE服务端接口模型对比的功能。 BIMFACE官方文档提供的三维模型对比接口同样也适用于二维CAD图纸对比。下图中是官方提供的对比示例程序。
通过BIMFACE控制台或者调用服务接口上传文件成功后，如果不再需要该文件，则可以通过BIMFACE平台提供的“源文件删除”服务接口删除具体的文件。下面详细介绍其使用方法。
在前一篇博客《C#开发BIMFACE系列50 Web网页中使用jQuery加载模型与图纸》中详细介绍了在网页中使用jQuery加载模型与图纸
在我的博客《C#开发BIMFACE系列52 CS客户端集成BIMFACE应用的技术方案》中介绍了多种集成BIMFACE到客户端程序中的方案。最后推荐大家使用 CefSharp组件与WebView2组件。本篇文章介绍使用CefSharp组件如何集成BIMFACE到客户端程序中。
在《C#开发BIMFACE系列25 服务端API之获取模型数据9：获取楼层对应面积分区列表》一文中介绍了如何获取单个模型中单个楼层包含的面积分区列表。有了面积分区列表之后，即可查询单个面积分区的具体信息。
在前两篇博客《C#开发BIMFACE系列45 服务端API之创建离线数据包》与《C#开发BIMFACE系列46 服务端API之离线数据包下载及结构详解》中创建并下载了离线数据包，数据包中的文件结构也做了详细的说明。
随着建筑信息化模型技术的发展，越来越多的人选择在云端浏览建筑模型。现阶段的云端模型浏览大多是基于文件级别，一次只可以浏览一个模型文件中的内容。而在工程项目模型设计的过程中，通常由多个设计师协同设计，不同的设计师负责不同的专业领域（例如建筑、结构、水电等）。如果想要在云端浏览整个项目工程，就需要把这些组成部分集成起来一起展示。更近一步，如果要在集成的模型之上进行业务集成的话，就要求在集成过程中对构件按单体，楼层，专业，构件分类，系统类型等进行分类或映射。
在实际项目中，由于需求变更经常需要对模型文件进行修改。为了便于用户了解模型在修改前后发生的变化，BIMFACE提供了模型在线对比功能，可以利用在线的模型对比接口，通过简单的四个步骤实现模型在线对比。模型对比可以对两个文件/模型进行差异性分析，确定两个文件/模型之间构件的几何和属性差异，包括增加的构件、删除的构件和修改的构件。 模型对应可以用于进行文件/模型的版本对比。
BIMFACE使用了分布式对象存储来存储用户上传的模型/图纸文件。如使用普通的文件上传接口， 文件流会通过BIMFACE的服务器，再流向最终的分布式存储系统，整个上传过程会受BIMFACE服务器的带宽限制，上传速度非最优。 如使用文件直传接口，开发者应用在申请到一个Policy凭证后，可以直接上传文件跟BIMFACE后台的分布式存储系统， 这样上传速度和稳定性都会有提升，是我们推荐的上传方式。
BIMFACE最核心能力之一是工程文件格式转换。无需安装插件，支持数十种工程文件格式在云端转换，完整保留原始文件信息。开发者将告别原始文件解析烦恼，数据抽取全部自动完成。BIMFACE目前能够解析38种常见工程图纸和模型，具体包括：rvt、rfa、rte、skp、nwd、nwc、ifc、dwg、dxf、3dm、stl、dgn、stp、3ds、obj、dae、ply、fbx、dwf、gmp、gtj、gbq、gcl、ggj、gqi、gdq、gjg、igms、gpb、gpv、gsc、gbg、gsh、gtb、gzb。
在我的博客《C#二次开发BIMFACE系列61 File Management文件管理服务接口二次开发及实战详解》最后列出了 File Management 的接口，本篇主要介绍对该接口的封装及Demo程序。
在上一篇博客《C#开发BIMFACE系列42 服务端API之图纸对比》的最后留了一个问题，在常规业务场景下，一个.dwg文件中包含多个图框，如下图
在《C#开发BIMFACE系列12 服务端API之文件转换》中详细介绍了7种文件转换的方法。发起源文件/模型转换后，转换过程可能成功也可能失败。那么在这种情况下就需要查询源文件/模型的转换状态。一共有三种方式可以知道转换是否成功。
在模型成功进行转换后，模型内的BIM信息会在云端进行解析，抽取并结构化入库。这些信息包含：
在建筑施工图审查系统中，设计单位提交设计完成的模型/图纸，审查专家审查模型/图纸。审查过程中如果发现不符合规范的地方，则流程退回到设计单位，设计单位人员根据审查意见重新调整设计，调整完成后再次提交到审查专家。此时为了便于专家审查，需要知道当前轮次的模型/图纸与上一轮次的模型/图纸发生了哪些异动，针对异动情况进行审查即可。
在注册成为BIMFACE的应用开发者后，要能在浏览器里浏览你的模型或者获取你模型内的BIM数据， 首先需要把你的模型文件上传到BIMFACE。根据不同场景，BIMFACE提供了丰富的文件相关的接口。
BIMFACE 平台为开发者提供了大量的服务器端 API 与 JavaScript API，用于二次开发 BIM 的相关应用。
在BIMFACE控制台上传文件，上传过程及结束后它会自动告诉你文件的上传状态，目前有三种状态：uploading，success，failure。即上传中、上传成功、上传失败。
在《C#开发BIMFACE系列21 服务端API之获取模型数据6：获取单模型的楼层信息》中介绍获取单个模型的所有楼层信息。某些场景下根据需要也可以一次性获取多个模型的楼层信息。
在《C#开发BIMFACE系列4 服务端API之源上传文件》、《C#开发BIMFACE系列5 服务端API之文件直传》两篇文章中详细介绍了如何将本地文件上传到BIMFACE服务器及BIMFACE后台的分布式存储系统中。文件上传成功后，BIMFACE的服务会返回与该文件相关的信息，如下图：
在《C#开发BIMFACE系列22 服务端API之获取模型数据7：获取多个模型的楼层信息》中，返回的楼层信息结果中包含了楼层的具体信息，其中包含楼层ID。
通过BIMFACE控制台或者调用服务接口上传文件成功后，默认场景下需要下载该源文件，下载文件一般需要知道文件的下载链接即可。BIMACE平台提供了“获取文件下载链接”的服务接口。下面详细介绍其使用方法。
在前几篇博客中介绍了一个三维文件/模型包含多个构建，每个构建又是由多种材质组成，每个构建都有很多属性。不同的构建也有可能包含相同的属性。
在《C#开发BIMFACE系列3 服务端API之获取应用访问凭证AccessToken》中详细介绍了应用程序访问API的令牌凭证。我们知道 Access token 代表自身应用的身份，使用应用的 appkey, secret，通过调用/oauth2/token接口获取。BIMFACE所有的接口调用都需要传递 Access token 。
请求 path(示例)：https://file.bimface.com/files
在Revit等BIM设计工具中可以给模型的某个部位添加链接信息。即类似于在Office Word、Excel 中给一段文字添加本地文件链接或者网址链接等类似功能。例如下面的一个RVT模型种包含了2个链接。
请求地址：GET https://api.bimface.com/data/v2/files/{fileId}/elements/{elementId}
在运维或协同的场景中，经常需要对模型或图纸进行批注，及时记录已发现的问题并交给相关负责的人员。
在我的博客《C#开发BIMFACE系列49 Web网页集成BIMFACE应用的技术方案》、《C#开发BIMFACE系列50 Web网页中使用jQuery加载模型与图纸》、《C#开发BIMFACE系列51 Web网页中使用Vue.js加载模型与图纸》三篇文章中介绍了Web网页中集成BIMFace应用开发的技术方案与示例程序。在建筑领域中涉及的应用管理系统绝大部分都是BS架构Web形式，这是主流趋势。BIMFACE在网页中加载浏览模型图纸时用到了HTML5、CSS3、WebGL等新技术，无需安装任何插件，极速流畅的浏览体验，并且可以集成应用于App、小程序、公众号等移动端。
大厦建筑模型中，基本上包含多个楼层，每个楼层包含多个房间等信息。在《C#开发BIMFACE系列21 服务端API之获取模型数据6：获取单模型的楼层信息》中介绍了如何获取一个模型中包含的楼层信息、面积分区、房间等信息。本篇主要介绍如何获取单个模型中单个房间信息。
在前一篇博客《C#开发BIMFACE系列45 服务端API之创建离线数据包》中通过调用接口成功的创建一个离线数据包
在前一篇博客《C#开发BIMFACE系列47 IIS部署并加载离线数据包》中详细介绍了IIS部署并访问的完整步骤。本篇博客详细介绍在Nginx服务器中如何部署并访问离线数据包。
在《C#开发BIMFACE系列31 服务端API之模型对比2：获取模型对比状态》中介绍了根据对比ID，获取一笔记录的对比状态。由于模型对比是在BIMFACE云端进行的，通常需要5~10分钟，在等待对比的过程中还可以发起更多的模型对比，最后通过接口一次性批量获取模型对比状态 。
BIMFACE官方示例中，加载三维模型后，模型浏览器中左上角默认提供了“目录树”的功能，清晰地展示了模型的完整构成及上下级关系。
在《C#开发BIMFACE系列18 服务端API之获取模型数据3：获取构件属性》中介绍了获取单个文件/模型的单个构建的属性，本篇介绍如何一次性获取多个构建的属性。
源文件/模型转换完成之后，可以获取模型的具体数据。本篇介绍根据文件ID查询满足条件的构件ID列表。
在上一篇《C#开发BIMFACE系列16 服务端API之获取模型数据1：查询满足条件的构件ID列表》中介绍了获取单文件(模型)的所有构建ID列表。每个构建由多种材质组成，本文介绍获取单个构建ID的材质列表。
领取专属 10元无门槛券
手把手带您无忧上云
云服务器
ICP备案
对象存储
即时通信 IM
实时音视频
