本文へスキップ

サンプルプロジェクト

Lightshipのサンプルは、SDKの各機能の使用例を具体的に示すことを目的としています。 このサンプルプロジェクトでは、複数の小さなサンプルを実行し、それぞれのコードを確認しながら各機能の使い方を学ぶことができます。 各機能の活用方法については、入門ガイドをご覧ください。

さらに、サンプルプロジェクトに加え、複数の機能を組み合わせて、充実したAR体験を提供する独立型のミニゲームの例も用意しています。 最初にリリースされたのが「Emoji Garden」です。 このミニゲームを詳しく調べることで、永続的な共有AR体験を作成するためのベストプラクティスを取り入れることができます。 詳細については、Emoji Gardenの特集ページにアクセスし、プロジェクトをダウンロードしてください。

サンプルをインストールする​

サンプルは、Github（https://github.com/niantic-lightship/ardk-samples）から入手できます。

サンプルのクローンを作成してダウンロードする方法：

git clone https://github.com/niantic-lightship/ardk-samples.git

または

Github の code/download ボタンを使用して、https://github.com/niantic-lightship/ardk-samplesからリポジトリをダウンロードしてください。

次に、 Unity Hub で Add を押し、プロジェクトを選択してUnityでサンプルプロジェクトを開きます。

すべてのサンプルが正常に動作するように、Lightshipキーを追加する必要があります。

Unity 2022でサンプルを実行する​

デフォルトでは、Lightshipのサンプルプロジェクトは、Unity 2021.3.29f1 上で実行されますが、Unity 2022を使用する場合は、バージョン 2022.3.37f1 にアップデートすることもできます。

サンプルをUnity 2022に更新するには、次の手順を行います。

  1. まだインストールしていない場合は、 Unity Hub の Installs で 2022.3.37f1 をインストールしてください。
  2. Projectsで、ARDKサンプルプロジェクトを見つけます。 Editor Version をクリックし、 2022.3.37f1 に変更します。 次に、 Open with 2022.3.37f1 ボタンをクリックします。
  3. Change Editor version? ダイアログが表示されたら、 Change Versionをクリックします。
  4. Opening Project in Non-Matching Editor Installation ダイアログが表示されたら、 Continueをクリックします。
  5. Gradleのカスタムベーステンプレートを無効にします。
    1. Unityのトップメニューで Edit をクリックし、 Project Settings をクリックします。
    2. 左側の Project Settings メニューで Player を選択し、「Android」タブをクリックします。
    3. Publishing Settings まで下にスクロールし、 Custom Base Gradle Template ボックスのチェックを外します。
  6. Window トップメニューで、 Package Manager を開きます。 パッケージリストから Visual Scripting を選択し、1.9.0未満のバージョンを使用している場合は、 Update をクリックします。
  7. エラーがある場合は、 Enter Safe Mode? ダイアログがポップアップ表示されます。 Enter Safe Mode をクリックしてエラーを修正する。

サンプル​

深度ディスプレイ​

深度シーンは、深度バッファを取得し、シーンにオーバーレイとして表示する方法を示しています。 Depth フォルダ内の DepthDisplay.unity を開いてお試しください。

オクルージョン​

このシーンでは、静止しているキューブをカメラの前で動かして、オクルージョンのデモを行います。 キューブは動かないため、周囲を歩き回ることで、オクルージョンの質を直接検査することができます。 このシーンを開くには、 Depth フォルダ内の Occlusion.unity シーンを参照してください。 このサンプルでは、Lightshipで利用可能な2つの高度なオクルージョンオプションである オクルージョン抑制 と オクルージョン安定化 のデモも行います。 これらのオプションは、セマンティックまたはメッシングからの入力を使用して、ちらつきを低減し、オクルージョンの視覚的品質を向上させる。 これらの機能の詳細については、オクルージョン抑制やオクルージョン安定化の入門ガイドセクションをご覧ください。

セマンティック​

このシーンでは、セマンティック・チャンネルの一部として、画面上で認識されたものに色をつけるシェーダーを適用するセマンティックのデモを行います。 このサンプルを開くには、 Semantics フォルダ内の SemanticsDisplay.unity を参照してください。

このサンプルを使用するには、以下の手順を行います。

  1. ドロップダウンリストから、セマンティックチャンネルを選択します。
  2. スマートフォンのカメラに対応するチャンネルを探してください。

オブジェクト検出​

このシーンでは、オブジェクト検出のデモを行うために、検出されたオブジェクトの周囲に2Dバウンディングボックスを描画します。 設定メニューでは、検出されたすべてのクラスを表示するか、ドロップダウンから選択したクラスのみを表示するかを切り替えることができます。 このサンプルを開くには、 ObjectDetection フォルダ内の ObjectDetection.unity を参照してください。

メッシング​

このシーンでは、メッシングを使ってシーンに物理メッシュを生成する方法を紹介します。 これは法線シェーダーを使ったメッシュで、色は上、右、前を表しています。

このサンプルを開くには、 Meshing フォルダ内の NormalMeshes.unity を参照してください。

トライプラナーメッシュ​

このシーンは、ライトシップメッシュにテクスチャを貼る方法を示しています。 これはMeshingサンプルと同じように動作しますが、ワールド空間UV投影の1つの方法を示す3平面シェーダの例を使用します。 このサンプルでは、地面、壁、天井の3つのテクスチャをシーンにタイル状に配置しています。

このサンプルを開くには、 Meshing フォルダ内の TriplanarMesh.unity を参照してください。

ナビゲーション・メッシュ​

このシーンでは、メッシングを使用して Navigation Mesh を作成するデモを行います。 あなたが動き回るにつれて、私たちはナビゲーション・メッシュを作成し、成長させます。あなたがそれをクリックすると、AIエージェントにその位置に移動するよう指示することができます。 エージェントは角を曲がり、物体に飛び乗ることができます。 このサンプルを開くには、 NavigationMesh フォルダ内の NavigationMesh.unity を参照してください。

このデモを表示するには、以下の手順を行います。

  1. デバイスにシーンをビルドし、スマートフォンを周囲に向けて動き回ります。 しばらくするとゲームの駒が表示されるはずです。
  2. ゲームピースをタップして目的地を設定します。
  3. 選択した目的地に到達するために、 Player Cube（プレイヤーキューブ） がナビゲーション・メッシュに沿って道を探します。

リモート・オーサリング​

備考

このサンプルは、縦向きの画面でのみ動作します。

このシーンでは、VPS Anchorをターゲットにしたターゲットローカライゼーションのデモを行います。 このサンプルを開くには、 PersistentAR フォルダ内の RemoteAuthoring.unity を参照してください。

このサンプルを使用するには、以下の手順を行います。

  1. 地理空間ブラウザにアクセスします。

  2. 任意の デフォルトアンカー の Blob をコピーします。

  3. シーンの Hierarchy（階層） で、 XR Origin に移動します。 Inspector ウィンドウで、コピーしたBlobを Default Anchor Payloads To Localize（ローカライズするデフォルトのアンカーペイロード） のリストに追加します。

    Default Anchor Payloads To Localize

  4. デバイスにサンプルをビルドします。

  5. GSBで選択したロケーションに実際に訪れ、ローカライズします。

  6. Geospatial Browserで、緑色のキューブが Coordinate Axis Marker（座標軸マーカー） によって示されたメッシュの原点に表示されます。

ランタイム時にBlobを変更する​

テスト用デバイスでGeospatial Browserを開き、別のアンカーの Blob をコピーして、アプリが実行されている状態で Payload のテキストボックスに貼り付けます。

VPSローカライゼーション​

注意

このサンプルを使用するには、Lightship APIキーが必要です。

このシーンでは、半径範囲内にあるVPSロケーションのリストが表示され、Coverage APIからWaypointをローカライズターゲットとして選択できます。その後、スマートフォンのマップと連携して目的地までの道案内を行います。 このサンプルを開くには、 PersistentAR フォルダ内の VPSLocalization.unity を参照してください。

このサンプルを使用するには、以下の手順を行います。

  1. デバイスにビルドし、アプリを開きます。 位置情報へのアクセスを許可していることを確認します。
  2. 現在地から検索するには、半径を設定し、 Request Areas（エリアをリクエスト） をタップします。 別の場所から検索するには、緯度と経度の座標を入力します。
  3. 実際にそのロケーションを訪れ、 Localize ボタンをタップします。
  4. ステータスが Tracking に変わると、メッシュの原点にキューブが表示されます。

共有AR VPS (Shared AR VPS)​

注意

このサンプルを使用するには、Lightship APIキーが必要です。

このシーンでは、Coverage APIからWaypointを選択し、その周囲で共有AR体験を作成することができます。 このサンプルを開くには、 SharedAR フォルダ内の SharedARVPS.unity を参照してください。

モバイルデバイスでこのサンプルを使用するには、以下の手順を行います。

  1. VPSLocalization の手順に従い、利用可能なロケーションでローカライズを行います。
  2. 実際にそのロケーションを訪れ、手順1のローカライズに使用したデバイスとは別の2～10台のスマートフォンで Localize ボタンをタップします。 このプロセスにより、全員が同じ場所にローカライズされ、同じルームに自動的に参加します。
  3. ステータスが Tracking に変わると、セッション内のすべてのプレイヤーに名前タグが表示されます。 名前タグが赤くなると、そのプレイヤーのトラッキングが失われたことを示します。 Stats UIはタップして非表示にできますが、そのセッション中に再表示されることはありません。

Unityエディターのプレイバック機能を使用してこのサンプルを使用するには、以下の手順を行います。

  1. 特定のロケーションでシーンのプレイバックを設定します。 再生設定方法を参照してください。
  2. Geospatial Browserから、プレイバック時に使用するデフォルトのアンカーペイロード文字列を提供する。 地理空間ブラウザの使い方を参照してください。
  3. デフォルトのアンカーペイロード文字列を、 VPS Colocalization Demo コンポーネントの In Editor Payload フィールドにコピーします。
  4. VPSコロカライゼーション・シーン （VPS Colocalization scene）を開始する。 ペイロード文字列を使って自動的にトラッキングを開始します。
  5. ネットワークUIが表示されたら、ホストとして参加するか、クライアントとして参加するかを選択します。

共有AR画像追跡コロカライゼーション（Shared AR Image Tracking Colocalization）​

注意

このサンプルを使用するには、Lightship APIキーが必要です。

このシーンでは、VPSロケーションを使用せずに、複数のユーザーが共有ルームに参加することができます。そのためには、静止画像を原点として使用します。 このサンプルを開くには、 SharedAR フォルダ内の ImageTrackingColocalization.unity を参照してください。

このサンプルを使用するには、以下の手順を行います。

  1. Assets/Samples/SharedAR/IMG-2689.png にある画像を印刷し、幅を9cmに調整します。
  2. 画像を表面に置きます。
  3. デバイスのカメラを画像に向けます。 Create New Room を選択します。

ワールドポーズ​

このサンプルでは、デバイスのGPSコンパスとワールドポーズのコンパスを比較して、ワールドポジショニングシステムによってカメラの精度が高くなる様子を示します。 ワールドポーズを使用したコンパスは、ユーザーが歩くにつれて徐々に安定し、正確性も向上します。

On Device Persistence​

このサンプルは、ローカルでVPSマップを作成する方法を示しています。 これはデバイス上に作成・保存され、コンテンツの整列や永続化に使用できます。 サンプルは、キューブのマップと位置をデバイスのファイルシステムに保存します。

Cloud Persistence​

このサンプルはOn-Device Persistenceサンプルのバリエーションで、データストアを使用してマップデータをクラウドに保存するように設計されています。 これにより、他のユーザーがマップをダウンロードして同じスペースに整列することができ、シームレスなアドホック・マルチプレイヤー体験が可能となります。 複数のプレーヤーがキューブを置くことができ、キューブはルーム内の参加者全員に自動的に同期され、その位置が維持されます。

Recording​

このシーンでは、エディターで再生するために実際の場所をスキャンすることができます。 このサンプルを開くには、 Scanning フォルダの Recording.unity を参照してください。 このサンプルの使用方法については、プレイバック用データセットを作成するを参照してください。