View and Data API の開発環境

ご注意:View and Data API は2016年6月に Viewer と  Model Derivative API に分離、及び、名称変更されました。 

View and Data API を含むオートデスクの Web サービス API は、現在、Autodesk Developer Portal サイト https://developer.autodesk.com で公開が始まっていて、今後も新しい API の追加公開が予定されています。

最も早い段階に公開された View and Data API の場合、Autodesk Developer Portal  には API リファレンスや GitHub 上のサンプルだけでなく、実装手順や機能を把握するための Live Demo も記載されています。実装手順を理解する クイック スタート サンプル  については、過去のブログ記事 View & Data API クイック スタート サンプル で紹介していますが、この時、アクセス トークンの発行で利用していた API コンソール の機能が Autodesk Developer Portal から廃止されてしまっています。

そこで、今後の View and Data API 開発も前提に、GitHub 上で公開しているワークフロー 系サンプルの利用も考慮に入れて、今回は開発環境の用意について、オートデスクがお勧めするツールや導入手順を紹介しておきたいと思います。なお、アクセス トークンについては、テスト用の取得ということで Curl を利用する前提にしておきます。

今回は、次の開発ツールを導入することをかんがて見ます。もちろん、Web 開発はオープンソースを利用するのが一般的なので、これらツールや環境でないと  View and Data API を利用できないわけではありません。ご注意ください。

WebブラウザのGoogle Chrome、HTML/JavaScriptエディタのAdobe Brackets、アクセス・トークン取得用のCurl、サーバー実装用のNode.js、リポジトリユーティリティのGitHub Desktopを紹介する画像。

各ツール、アプリケーション、サーバー環境は、それぞれ、次の項目で説明する手順で入手してインストールを完了させてください。なお、このガイドでは、管理者権限でログインした 64 ビット版 Windows を前提に説明しています。

  •  ここで記載しているバージョンは、2016年3月10日現在で最新のものです(2015年8月20日記載を2016年3月10日改訂)。今後のバージョンアップでダウンロード先の URL や、ダウンロードしたファイル名が変わる可能性があります。ご注意ください。

Google Chrome

作成した Web ページを表示してテストします。この Web ブラウザは、View and Data API で 3D モデルを表示するための必要な、HTML5、CSS3、WebGL をサポートしています。ここでは、現在、一般的に利用されている 32 ビット版を使用することとします。

  1. https://www.google.co.jp/chrome/browser/desktop/ からWindows 版(10/8.1/8/7/Vista/XP 32-bit)と表示されている Google Chrome のセットアップ プログラムである ChromeSetup.exe を任意の場所にダウンロードします。 
  2. ダウンロードした ChromeSetup.exeをダブルクリックして、セットアップ プログラムを開始し、インストールをおこなってください。
  3. インストールが完了すると、C:\Program Files (x86)\Google\Chrome フォルダに Google Chrome がインストールされているはずです。

Adobe Brackets

Adobe Systems 社が公開しているオープン ソースのソースコード エディタです。今回は、HTML ファイルや JavaScript コードを編集するために使用します。

  1. http://brackets.io/ から Download Brackets without Extract を選択してインストーラ Brackets.Release.1.6.msi をダウンロードします。 
  2. ダウンロードした Brackets.Release.1.6.msi を実行して、インストールを開始します。
  3. Brackets インストーラが起動後に [Brackets Destination Folder] 画面が表示されます。念のため、インストール先のフォルダが既定値である C:\Program Files (x86)\Brackets\ になっていることを確認します。その他、オプションも既定値のまま、[Next] ボタンをクリックします。 
  4. [Install] ボタンをクリックしてインストールを開始します。 
  5. インストールが完了したら、[Finish] ボタンをクリックしてインストーラを完了します。Windows の [スタート] ボタンから Brackets アイコンを見つけて起動出来ることを確認してください。

Node.js

Node.js は、JavaScript をサーバー上で実行するための環境です。JavaScript は、もともとクライアント コンピュータ上の Web ブラウザで実行することを目的の作成されたものですが、サーバー側の処理を実行するために用意されたものです。実行には、Google V8 JavaScript Engine が使用されています。Node.js は、3rd party が用意したパッケージをインストールして、機能を拡張することが出来ます。パッケージのインストール等の管理には、パッケージ管理ツール Node Package Manager (npm) を利用します。ここでは、express、request、serve-favicon の 3 つのパッケージ モジュールを利用するものと仮定してセットアップをおこないます。開発時には、Webサイトをクライアント コンピュータ上で実現する目的で利用出来ます。

  1. https://nodejs.org/ から画面中央の [V4.4.0 LTS] をクリックして、64ビット版 Windows 用インストーラ node-v4.4.0-x64.msi をダウンロードします。
  2. ダウンロードした node-v4.4.0-x64.msi を実行して、インストールを開始します。[Welcome to the Node.js Setup Wizard] 画面が表示されたら、画面右下の [Next] ボタンをクリックします。
  3. [End-User License Agreement] 画面のライセンス規約を一読の上、「I Accept the terms in the License Agreement」にチェックを入れて、[Next] ボタンをクリックします。

  4. [Destination Folder] 画面でインストール先フォルダを既定値の C:\Program Files\nodejs\ まま、[Next] ボタンをクリックします。

  5. [Custom Setup] 画面では、すべてのオプションをインストールする既定値まま、[Next] ボタンをクリックします。
  6. [Install] ボタンをクリックしてインストールを開始します。
  7. インストールが完了したら、[Finish] ボタンをクリックしてインストーラを完了します。

Curl

Curl は、さまざまなプロトコルを用いてデータを転送するライブラリとコマンドラインツールを提供するものです。一般に cURL と表記されることが多いようです。スタートアップ時には、Consumer Key と Consumer Secret からアクセス トークンを取得する目的で利用します。なお、アクセス トークンの取得は、通常、サーバー サイド実装でプログラムを介しておこなわれるべきものです。

  1. http://curl.haxx.se/download.html のページ下部から Win64 x86_64 CAB と書かれたリンクを見つけてください。
  2. バージョン番号である 7.47.1 をクリックして、curl-7.47.1.cab を任意の場所にダウンロードしてください。
  3. Windows エクスプローラを使って、C ドライブのルート フォルダに CURL フォルダを作成します。
  4. ダウンロードした curl-7.47.1.cab をブルクリックして、Windows エクスプローラで表示させます。この時、パス名を表示して、AMD64 フォルダにある CURL.EXELIBCURL.DLLLIBCURL.EXELIBCURL.LIB を選択して、C:\CURL フォルダにコピーしてください。  

GitHub Desktop

GitHub Desktop の利用は必須ではありませんが、GitHub 上のサンプル プログラムを入手したり、今後の開発作業でソース コードを共有する計画がある場合には有用です。今回は、前者の目的で利用します。GitHub Desktop は、プラットフォーム別に、それぞれ次のリンクから入手することが出来ます。

ここでは、Windows プラットフォーム用の GitHub Desktop ユーティリティ、別名、GitHub for Windows をインストールしておきます。

  1. https://windows.github.com/ ページを表示後に [Download GitHub Desktop] をクリックして、GitHubSetup.exe をダウンロードします。
  2. ダウンロードした GitHubSetup.exe を実行して、GitHub Desktop のインストールを開始します。
  3. インストールが自動的に終了すると、GitHub のセットアップ画面が表示されます。GitHub アカウントの情報を入力して、セットアップを完了してください。もし、GitHub アカウントをお持ちでない場合には、4.を参照してください。
  4. 無償版の GitHub アカウントを登録します。https://github.com/ ページを表示させて、User Name、Email アドレス、パスワードを入力後に [Sign up for GitHub] をクリックします。
  5. 次の画面が表示されたら、Free プランを選択して [Finish sign up] をクリックします。
  6. 登録したメール アドレスに確認用のメールが届きます。[Verify email address] ボタンをクリックしてアカウント作成を完了します。後は、3. に戻って、アカウント情報を入力してください。

以上で環境セットアップは終了です。

次回以降、View and Data API を利用するために必要となるキーの取得手順と、GitHub から利用できる Live Demo を使った View and Data API の利用手順の確認について、2 回に分けてご紹介します。

By Toshiaki Isezaki

 


Comments

Leave a Reply

Discover more from Autodesk Developer Blog

Subscribe now to keep reading and get access to the full archive.

Continue reading