サンプルとチュートリアル
以下に示すサンプルを見ると、Wikitude SDKによって提供される機能の概要がわかります。各サンプルは、サポートされているすべてのプラットフォームで変更せずに実行できます。
付属するそれぞれのサンプルは以下のように構成されています。
index.html: AR体験の入口。js/*: 必要なJavaScriptファイルが含まれます。css/*: 必要なCSSスタイルシートが含まれます。assets/*: 画像、3Dモデル、ターゲットコレクションが含まれます。
js/フォルダーでは、メインのJavaScriptファイルはそのサンプルにちなんだ名前になっています（たとえば、Image RecognitionサンプルのJavaScriptコードはjs/clientrecognition.jsファイルに含まれています）。サンプルの説明で言及されているコードは、特に指定のないかぎり、このファイルにあります。
ARCHITECT.JSライブラリのインクルード
Wikitude SDKのJavaScript APIを使用するにはarchitect.jsというWikitudeのJavaScriptライブラリを追加する必要があります。Include ステートメントは提供されたサンプルのすべてのindex.htmlに含まれ、次のようになります。実際のファイルは実行時にWikitude SDKによって渡すので、ファイルをダウンロードするときに404 - Not foundというエラーを表示してもかまいません。Wikitude SDKがリモートでこのファイルをロードしている場合でも、インターネットに接続せずにローカルのみで置き換えられます。
<script src="https://www.wikitude.com/libs/architect.js"></script>
Wikitude SDK 5.3以前のバージョンでのarchitect.js
Wikitude SDK 5.3以前のバージョンではInclude ステートメントはarchitect://というカスタムプロトコルハンドラで構成されましたが、これはiOSのATS (App Transport Security)に対応していませんでした。ATSの仕様に準拠したいのなら、Wikitude SDK 5.3以降のバージョンを使用する必要があります。詳細については、このセクションを参照してください。
<script src="architect://architect.js"></script>GitHub上のサンプル
AR体験のコードにざっと目を通したい方のために、サンプルのソースコード全体がGitHubに公開されています。
サンプルアプリケーション
このセクションではSDK Examplesアプリケーションについて詳しく説明し、Wikitude SDKの主要な機能とその使用方法を紹介します。
使い方
このアプリケーションを実行するには、Xcodeプロジェクトを開いて［Run］をクリックします。
サンプル
SDK Examplesアプリケーションはテーブルビューの構造になっており、テーブルの各セルをクリックすると、SDKの具体的な機能が実装された個々のARchitect Worldが起動します。
このアプリケーションはUINavigationViewControllerを使用し、各サンプルをWT*ARViewControllerとしてプッシュします。ほとんどの場合、WTStandardARViewControllerという汎用的なUIViewControllerを使用しています。より高機能のWT*ARViewControllerが必要なサンプルでは、そのサンプル用の特定の機能が実装されたカスタムのWT*ARViewControllerがロードされます。