Revit API简介——Dynamo Python系列教程（九）

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

2、https://knowledge.autodesk.com/zh-hans/search-result/caas/sfdcarticles/sfdcarticles/kA23A000000ZZ1z.html。

所有API都需要技术文档，这样程序员就可以学习如何使用代码驱动应用程序。Revit SDK包含.chm文件中的官方API文档以及示例代码（用Visual Basic和C＃编写）。（https://www.revitapidocs.com/）

但是，我建议阅读http://APIDocs.co（https://apidocs.co/）网站上的Revit API ，这比打开.chm文件方便得多，建议将其收藏。