Niantic SDKの設定
ARDK 3.13.0は2025年4月23日に提供開始予定です。 ARDK 2.xを含む3.13.0より前のすべてのバージョンは、2025年5月1日から6ヶ月間のサポート期間に入り、2025年11月1日に動作を停止します。 3.13.0リリースノートをご覧ください。 お問い合わせはこちらまで support@nianticspatial.com
前提条件
Lightship ARを有効にしたUnityのプロジェクトが必要です。 詳細については、 ARプロジェクトの設定を参照してください。
Niantic Lightship SDK Settingsに移動するには、上部メニューバーからLightship > Settingsを選択します。
SDKステータスインジケーター
Settings（設定）ウィンドウの上部には、エディターでの開発、Androidへのデプロイ、iOSへのデプロイにおいて、Lightship SDKが有効かどうかを示す3つのインジケーターがあります。 特定のプラットフォームでこのプラグインが有効になっていない場合、対応するインジケーターが プロジェクト検証 ウィンドウにアクセスするためのボタンとして機能します。ここで詳細を確認し、Lightship SDKを有効にすることができます。
認証情報
Get API Key ボタンは、LightshipのWebサイトのプロジェクトページに直接リンクされています。 そこで、お持ちのアカウントから既存のキーをコピーするか、新しいキーを無料で作成できます。 Lightship設定のテキストフィールドを使用して、Lightshipの開発者アカウントからAPIキーを追加してください。
Unityプロジェクトをビルドするには、APIキーが必要です。 APIキーは、Unityエディター内の特定の機能（Lightship VPS など）を使用して開発する場合にも必要です。
機能の有効化/無効化
この設定を使用して、プロジェクト内のLightshipの各機能を有効または無効にできます。
各機能の詳細については、ドキュメントのページを参照してください。
利用可能な場合はLiDARを優先
深度設定を有効にすると、ARFoundation APIから返る深度情報は、Lightshipの深度予測アルゴリズムによって生成されます。 このオプションを選択することで、その情報は上書きされ、（利用可能な場合は）モバイルデバイスのLiDARセンサーから直接受信した深度データに置き換えられます。
プレイバック
このセクションでは、Lightshipのプレイバック機能の設定方法について説明します。 この機能の詳細については、 プレイバック機能ページ を参照してください。
Lightshipでは、開発中はプレイバックを使用し、デプロイ時にはリアルタイムのカメラフィードを使用できるように、Unityエディター用と物理デバイス用の2種類のプレイバック設定を提供しています。
データセットへのパス
コンピューター上のデータセットを選択するには、 参照 ボタンを使用します。 パスは、capture.jsonファイルを含むディレクトリでなければなりません。 ファイルシステム内の任意の場所に配置することができます。Unityプロジェクトのフォルダ内である必要はありません。
手動で実行
デバッグのためには、録画を1フレームずつステップスルーするのが便利な場合があります。 この設定を有効にすると、シミュレートされたカメラのフィードを表示する際、最初のフレームの前に空白の画面が表示されます。 そこから、スペースバーを押して、録画を1フレームずつ進めることができます。
デバイスでプレイバックを使用する場合は、スペースバーではなく、2本指タップでフレームを進めてください。
無限ループ
この設定を有効にすると、データセットが永久にループするため、録画時間を超える長さのセッションが可能になります。 最後から最初への瞬間的なテレポートを防ぐため、録音は最初に到達するまで逆再生され、その後再び順方向に再生されます。
ロギング
デバッグの際に、Lightship SDKのログの視認性を調整したいと感じることもあるでしょう。 コンソールのノイズを防ぐため、これらの設定はWarn、Error、またはOffのままにしておくことをお勧めします。
Lightship Simulation
設定ウィンドウの一番下のセクションは、Lightship Simulationが有効な場合にのみ関係します。 詳しくは、 シミュレーション機能のページ をご覧ください。
主要なSDKステータスインジケーターと同様に、シミュレーション設定の最初のセクションでは、 Niantic Lightship Simulation ローダーが有効になっているかどうかを示します。 有効になっていない場合、インジケーターは XR Plug-in Management ウィンドウにリンクされており、そこで機能を有効にすることができます。
ARDK 3.5では、シミュレーション環境の設定は、AR Foundation設定との整合性を保つため、シーンビューのXR Environmentオーバーレイに移動しました。 プレハブプロパティは、適切なビューに直接アクセスできるボタンに変更されています。
Zバッファ深度
Lightship Simulationを使用すると、シミュレートされたフレーム上ですべてのLightship予測アルゴリズムをリアルタイムで実行しながら、エディター内で開発を行うことができます。 ただし、単純な環境では深度予測がうまく機能しない場合があります。また、LiDAR搭載デバイスの動作をより正確に再現したいと考えることもあるでしょう。 Z-Buffer Depthを有効にすると、シミュレートされたデバイスに対する環境内のオブジェクトの「真の」または「完全な」深度データを扱うことができます。
永続的なアンカー
VPSでLightship Simulationを使用する場合、Simulation Persistent Anchorsを使用すると、Lightship Persistent Anchorsシステムを所定の動作をするモック・システムに置き換えることができるため、開発が容易になります。
シミュレーションの永続アンカーパラメーター を使用して、モックのローカライゼーション試行が処理される方法を指定します。 シミュレーションは、指定された時間内にローカライズしたり、ランダムなオフセットで追跡したり、実世界のシナリオをシミュレートするのに役立つ故障を表面化するように設定することができる。