アイリアSDKを試す<第23回> Unity上でアイリアSDKを動かす

Unityインストール

Unityのインストーラは、公式ウェブ・サイト（https://unity.com/ja）からダウンロードしてインストールします。Unityを利用するにはライセンスが必要ですが、商用利用を行わない場合は無料のPersonalライセンスを使用できます。ライセンス条件を確認のうえ、ご自身の利用目的に合ったものを選択してください。

インストールが完了すると、プロジェクト管理ツールであるUnity Hubが利用可能になります。Unity Hubの表示言語は、「Settings」→「Appearance」→「Language」で変更できます（図1）。日本語にも設定できますが、インターネット上の解説記事やドキュメントの多くは英語表記なので、参考資料と併せて確認する場合は英語表示に戻すと分かりやすい場合があります。

ailia-models-unityのインストールと初期設定

リポジトリの取得

Unity用アイリアSDKモデル集であるailia-models-unityは、GitHub上で公開されています。次のコマンドでローカル環境にクローンします。

git clone https://github.com/axinc-ai/ailia-models-unity

このリポジトリには、物体検出/姿勢推定/顔認識など、複数のAIモデルがUnity上で動作可能な形で収録されています。

UnityへのAILIA-MODELS-UNITYの登録

GitHubからクローンしたフォルダailia-models-unityを、Unity Hubのメニューから登録します。手順を次に示します。

1. Unity Hubを起動
2. 「プロジェクト」タブを開く
3. 「追加」→「ディスクから加える」を選択
4. 展開したailia-models-unityフォルダを指定

これで、ailia-models-unityがUnityのプロジェクトとして利用できるようになります。

追加するモジュール選択

プロジェクトを追加すると、Unity Hub上で必要な追加モジュールの選択画面が表示されます。

主なモジュールには次があります。

• Microsoft Visual Studio Community 2019（または最新のVisual Studio）
  → 既に新しいバージョンをインストール済みの場合は、追加不要
• Android/iOS向けビルド・サポート
• 日本語言語パック

必要なモジュールを選択し、「インストール」をクリックします。

ワーク・ロードのインストール

次に、Microsoft Visual Studioのワークロード選択画面が表示されます（図4）。ここでは「Unityによるゲーム開発」を選択し、必要なワーク・ロードを追加してインストールします。

プロジェクトの登録

プロジェクトを登録すると、Unityエディタのバージョンによってはセキュリティ警告が表示されることがあります（図5）。ailia-models-unityは特定のバージョンでの動作が確認されているので、今回はそのまま進めます。

なお、注意点としてセキュリティ上の理由から、この検証用バージョンで作成したアプリケーションを公開することは避けてください。

初回起動時には、必要なファイルをダウンロードするため時間がかかる場合があります。ダウンロード完了後、プロジェクトのメイン画面が表示されます（図6）。

パッケージの確認

メニューの「Window」→「Package Manager」を開くと、アイリアSDKがインストールされていることを確認できます（図7）。

言語選択

Unityの表示言語は、「Edit」→「Preferences…」→「Languages」から変更できます（図8）。一般的には英語表示のまま利用する方が学習資料と一致して理解しやすいといわれていますが、ここでは日本語化して操作を説明します。

デモ・プログラムの実行

ailia-models-unityには、動作確認や学習用に利用できるデモ・プログラムが多数用意されています（図9）。Unityエディタを起動したら、メニューの「プロジェクト」→「Assets」→「AXIP」→「AILIA-MODELS」を開き、一覧から任意のデモを選択します。

選択したフォルダ内には、モデルごとのサンプル・シーンやスクリプトが格納されています。実行したいプログラムを選択し、Unityエディタ上部の再生ボタンをクリックすると、デモを起動できます（図10）。

実行すると、AIモデルが推論を開始し、カメラ画像や入力データに応じた結果がリアルタイムで表示されます（図11）。物体検出モデルであれば、検出結果のバウンディング・ボックスやラベルが画面上に重ねて表示されることを確認できます。

まとめ

今回は、Unity＋アイリアSDK（ailia-models-unity）を用いて、プロジェクトの読み込みからデモ・プログラムを実行し、Unityエディタ上で動作を確認するところまでを紹介しました。Unityエディタのバージョンが古い場合、最新のSDKや依存ライブラリとの互換性に問題が生じることがあります。次回は、アプリケーションのビルド手順や、セキュリティ的に安全なバージョン環境での試用方法について詳しく解説します。

コラム　ライセンス更新のトラブル対応方法

Unity Hubでライセンスの更新に失敗し、次のようなメッセージが表示されることがあります。

Licenses Unable to refresh license. Please try again.

このエラーが表示され、再インストールやアカウントの削除を行っても解決しない場合は、ライセンス関連ファイルの破損やキャッシュ不整合が原因である可能性があります。

対処方法を次に示します。

1. Unity HubまたはUnity Editorを終了
2. 次のフォルダを削除、または一時的に名前を変更（Rename）
   C:\Program Files\Unity Hub
   C:\Program Files\Unity
3. 再度Unity Hubを起動し、サインインしてライセンスを再取得

この現象は、UnityをCドライブ以外にインストールした場合にも発生することがあります。その際は、インストール先ドライブ配下にも同様のフォルダが存在しないか確認してください。