Revit的API已经开发了近二十年。
Revit API简介
Revit在本世纪初就有了一个可访问的API,可以用来驱动软件的几乎所有方面。由于Revit应用程序非常复杂,而且是为适应多种受众(结构、MEP等)而构建的,所以它的API非常大,需要一段时间才能直观地掌握,也就不足为奇了。
我经常发现,最简单的方法是把Revit看作一个数据库,我们在使用应用程序时不断更新它。数据库存储我们的内容(它的元素ID、类别、位置等)。在此之上是一个GUI,它表示元素在3D空间中的几何/位置,并允许我们与元素交互。最后,还有一点网络魔法,允许我们通过本地网络/ Revit服务器/ BIM360建立工作共享。
以这种方式思考Revit与大多数用户体验软件的方式是完全不同的。实际上,当我们编写针对Revit API的脚本时,我们只是对数据库进行一系列调用,受API规则的约束。
版本和历史
对于Revit的每个发行版和子发行版,Autodesk Revit团队都会对其API进行细微的更新或添加。这些变化主要与软件本身的功能变化有关(例如,Revit2020的最短路径分析API)。
悠久的历史有时意味着Revit API看起来可能不一致或以意想不到的方式构造——这通常发生在较老的API上,如果不影响很多人,这些API就不能改变。
Revit API的结构
考虑到它的大小,它可以帮助我们后退一步,了解这个API通常是如何构造的。Revit API公开了大约1700个类、50个接口和500个枚举,几乎涵盖了应用程序的所有方面和功能。这些类被细分为几个名称空间,通常与特定的用法相关(例如,管道或结构钢)。绝大多数类驻留在Autodesk.Revit.DB名称空间中。
在您的计算机上,API类分为两个.dll文件:RevitAPI.dll和RevitAPIUI.dll,可以在以下位置找到:C:\Program Files\Autodesk\Revit[版本]
Revit SDK和API文档
软件开发套件(SDK)是软件供应商向开发人员分发有关其API的信息的常用方法。官方Revit SDK可以点击下面链接找到
1、https://www.autodesk.com/developer-network/platform-technologies/revit
所有API都需要技术文档,这样程序员就可以学习如何使用代码驱动应用程序。Revit SDK包含.chm文件中的官方API文档以及示例代码(用Visual Basic和C#编写)。(https://www.revitapidocs.com/)
但是,我建议阅读http://APIDocs.co(https://apidocs.co/)网站上的Revit API ,这比打开.chm文件方便得多,建议将其收藏。