日本語化された Revit 2014 API ドキュメントと Revit SDK

Autodesk Revit の API（Application Programming Interface）を利用することで、Revit 内でよくあるタスクを自動実行させたり、複雑な手順をプログラムに代替させて設計者の操作を簡素化させたりすることが出来ます。

このための実装方法が アドイン や マクロ と呼ばれるカスタマイズ モジュールです。詳細は、以前のブログ記事 AutoCAD アドオン開発者のための Revit API 入門 ～ 概説 に譲りますが、初めて実際の開発作業をおこなう場合には、やはり、開発について説明するドキュメントが必要になります。

Revit API にも、API をどのような手順で利用したり、どのようなことが出来るのかを説明する「Developers Guide」ドキュメントが存在しています。このドキュメントは、従来から Revit のオンライヘルプに含まれていましたが、製品の一般機能に関するドキュメントとは異なり、残念ながら日本語化されていませんでした。

昨年リリースされた Revit 2014 では、日本の開発者の方の利便性を改善するため、オンラインヘルプと独立した形で Developers Guide を日本語化して、 .chm 形式のドキュメントを ZIP 圧縮してダウンロード出来るようにしています。

※ ダウンロードして展開した .chm ファイルは、セキュリティ機能によってコンテンツ表示がブロックされる場合があります。コンテンツがブロックされている場合には、各ページが白く表示されて何もない状態となります。その場合には、エクスプローラから .chm ファイルを右クリックして [プロパティ] ダイアログの [全般] タブを開き、画面右下にある 「ブロックの解除」 にチェックを入れてください。

そして、Revit 2015では、 ようやく他のドキュメントと同じレベルで Revit API Developers Guide を翻訳して、公開することが出来ました。日本語化された Revit API 開発者用ガイド は、Revit 2015 ヘルプ の目次からアクセスすることが出来ます。

Revit API 開発者用ガイドをご一読いただくことで、アドインの仕組みや考え方、Revit API の利用方法等を把握していただくことが出来るようになります。

一方、 Revit API を利用する際に必要となる、クラス、メソッドやプロパティといった内容を記されているリファレンス ドキュメントは、従来通り、Revit SDK に含まれています。リファレンス ドキュメントのファイル名は、従来と同じ RevitAPI.chm です。このドキュメントは、残念ながら英語版のみでの提供となっています。

さて、肝心の Revit SDK の入手方法ですが、こちらも従来のバージョンと同様に、製品インストーラからのインストールと、ダウンロードの 2 つの方法があります。製品インストーラから入手する場合には、「ツールとユーティリティ」項から Revit SDK（Revit Software Development Kit）からインストールを指定することが出来ます。 

一点注意が必要なのは、Revit SDK がまれに更新されることがある点です。Revit 2015 でも、すでに一度 SDK が更新されています。つまり、製品インストーラに含まれる Revit SDK は、最新の SDK とは言えなくなっています。最新の Revit SDK（Update May 14, 2014）は、日本語 Revit Developer Center http://www.autodesk.co.jp/developrevit または、英語 Revit Developer Center http://www.autodesk.com/developrevit から、ダウンロードすることが出来ます。現在、どちらのページから同じものをダウンロードできます。初期バージョンの SDK との違いは、SDK に含まれる Revit Addin Manager の更新のみです。

なお、最新の Revit SDK でも、開発時に便利な Revit Lookup ツールは同梱されていません。Revit Lookup ツールの入手方法は、次のドキュメントでご案内していますので、併せてご参照ください。

By Toshiaki Isezaki