Lightship VPS

Lightship VPSの概要

NianticのVPS（Visual Positioning System）を使えば、開発者は物理的な世界に仮想コンテンツをオーバーレイするリッチなロケーションAR体験（ ）を作成できる。 WebARコンテンツは、現実世界の の場所に固定することができ、仮想オブジェクトが物理的な環境と相互作用することを可能にする。 これにより、 AR体験は、より個人的で、有意義で、没入感があり、ユーザーが 自分の周りの世界を探索する新たな理由を与える。

**Note: VPS のローカライゼーションは、現在 Simulator ではプレビューできません。

注: * VPSとGeospatial Browser (GSB)は現在、Proプランのサブスクリプションが必要です。 これらの 機能は、ベーシック（無料）プランではご利用いただけません。

ロケーションの管理

Geospatial Browserは、プロジェクト内で左メニューの地図アイコン (下図の#1) を選択することでアクセスできます。 このページでは、マップビュー(#2) 、VPSが有効なロケーションを検索することができます。 VPSが有効な場所を選択すると、その場所の3Dメッシュが表示される (#3) ので、正しい場所を選択したことを確認し、プロジェクトに追加します (#4) 。

VPS が有効なロケーションをプロジェクトに追加すると、Geospatial Browser の "Project Locations" テーブルにそのロケーションが表示されます（下の画像では #1 と注釈されています）。 Project Locations "テーブルに Locationがあれば、"Download "ボタン（#2）を使って3DメッシュのGLBまたは OBJ（トグルは#3）をダウンロードし、サードパーティの3Dソフトウェアアプリケーション、 （Blenderなど）で開いたり、8th Wallプロジェクトに直接インポートすることができます。 、プロジェクトコードで「場所」を参照する場合、「プロジェクト場所」テーブルから「名前」フィールド（#4）をコピーする必要があります。

プロジェクトで使いたいロケーションがVPSロケーションとして利用できない場合は、 Create New Location セクションの指示に従って、 。

新しいロケーションの作成

1. 地図上の空いている場所をクリックして、新しいVPSロケーションを作成する場所を選択します。 VPSロケーションの要件を参照して、 VPSロケーションを作成するのに適した場所の選択について詳しく学んでください。

2. ProまたはEnterprise`プランのワークスペースには、Create Public Location または Create Private Location のオプションがあります。 パブリック・ロケーションは、すべての開発者とそのプロジェクト（ ）を使用している人がアクセスできます。一方、プライベート・ロケーションは、あなたのワークスペースとそのプロジェクト（ ）だけが表示され、アクセスできます。 パブリック・ロケーションの作成は、ほとんどのプロジェクトに適した選択です。プライベート・ロケーション は、特別なアクセス制御または一時的なVPS 体験を作成する必要がある開発者向けのプレミアム機能です。 Public LocationまたはCreate Private Location**ボタン（ ）のいずれかをクリックして、ロケーション作成プロセスを開始します。

3. 重複のチェック: 新しいロケーションを作成する前に、 ロケーションが既に存在しないことを確認する必要があります。 重複していないことを確認するために、希望するロケーションをマップ上の他のロケーションと比較してください。 これが重複Locationでない場合は、My Location is not duplicateボックスをチェックし、Nextボタンをクリックして続行する必要があります。

4. 位置情報の追加: 位置情報のメタデータは、 Geospatial Browser を使用している開発者が見ることができ、エンドユーザーも見ることができます。 ナイアンティックのトラスト＆セーフティチームは、 、提供された情報を使用して、ロケーションが公開される基準を満たしているかどうかを判断します。 作成しようとしているロケーションの以下の情報を追加したら、 Submitボタンをクリックしてください:

• タイトル（125文字）
• 説明文(250文字)
• カテゴリー（1つ以上）
• 画像（ある場合）

5. あなたの位置はすぐに、そのタイプ（「公開」または「非公開」）とステータス（「アクティブ化されていません」）と共に、Geospatial BrowserのLocation Submissionsタブに追加されるはずです。 数分以内に 、スキャンが可能になります。スキャンが完了したら、VPSのアクティベーションをリクエストできます。

Scaniverse for Niantic Developers (iOS Beta)

インフォメーション

**ScaniverseはiOSデバイスでベータ版をご利用いただけます。 アンドロイドのサポートはもうすぐだ。

私たちは現在、Scaniverse for Niantic Developersのベータ版を運営しており、 地理空間ブラウザ（GSB）とScaniverseの受賞歴のあるスキャン体験をシームレスに統合しています。 この 、マップの閲覧、場所の追加、そして コースのスキャンにまつわる開発者のワークフローを大幅に効率化する:

• 地理空間ブラウザ(GSB)をモバイルフレンドリーにすることで、 Scaniverse内で地図の閲覧、ロケーションの検査、ロケーションの追加、VPSアクティベーションのリクエストなどを効果的に行えるようにしました。
• WayfarerアプリのログインフローをシンプルなQRコードに置き換え、Scaniverseとあなたの 8th Wallアカウントをリンクさせました。
• Scaniverseの既存のUIを採用し、スキャンの作成とアップロードを強力にサポートします。
• ScaniverseのVPSでローカライズのテストができるようになりました。
• 地図のフィルタリングに最新の改良を加え、お探しの ロケーションをこれまで以上に簡単に検索できるようになりました。

iOSデバイスをお持ちの8th Wall開発者の方は、以下の手順でベータ版をお試しいただけます。

ScaniverseとGeospatial Browser（GSB）のリンク

**前提条件iOSのApp StoreからScaniverseをインストールしてください。 アンドロイド端末への対応は近日中。

1. デスクトップで8th Wallアカウントにログインしてください。 地理空間ブラウザ(GSB)**を開き、地図上の任意の 地点を選択し、**詳細を表示(View Details)**を選択する。 場所 詳細カードの右下隅で、**QRコードを生成**を押します。 QRコードが表示されます。

2. カメラアプリでQRコードをスキャンしてください。 携帯電話のカメラアプリを開き、QRコードに向ける。

3. 表示されたScaniverseリンクをタップする。 これでScaniverseとあなたの8th Wall 開発者アカウントがリンクされます。 これは一度だけ行えばよい。 :::info **プロンプトが表示されたら、www.8thwall.com が の現在地を使用することを許可してください。これは、GSB インターフェースの適切な操作に必要です:

スカニバース2](/images/scaniverse2.png)

4. ScaniverseとGSBの連携が完了すると、Scaniverseアプリの下部リボンにあるGSBボタンをタップすることで、いつでもGSBの画面（ ）に戻ることができるようになります。 ScaniverseとGSBのリンクは、SettingsメニューからNiantic Developer Modeオプションをオフにすることで、いつでも解除することができます。

5. GSBとScaniverseをリンク/アンリンクしても、Niantic Developer Mode以外で撮影したすべてのスキャンにアクセスできます。

ScaniverseでGSBマップを見る

1. Person**アイコンをタップすると、8番目のWall Workspaceを選択できます。

2. アップロード**ボタンをタップすると、アップロードするロケーションスキャンを選択できます。 VPS開発用にNianticにアップロードできるのは、Niantic開発者モード（Add ScansまたはTest Scanオプションを使用）から発信されたスキャンのみです。

3. Plus**ボタンをタップすると、新しいロケーションを作成し、スキャンをテストすることができます。

4. Layers**ボタンをタップすると、地図の衛星ビューが切り替わります。

5. Reticule**ボタンをタップすると、現在地を中心に地図が表示されます。

6. コンパス**ボタンをタップすると、地図がデフォルトの北上方向に戻ります。

7. コントロール**ボタンをクリックすると、マップ（ ）に表示されるロケーションに、そのサイズ、カテゴリー、またはアクティベーションステータスに基づいてフィルターを適用することができます。

8. 拡大鏡**ボタンで地図を検索できます。

9. X**ボタンをタップするとGSBが終了し、Scaniverseのホーム画面に戻ります。

10. 地図上で場所を選択するとプレビュー画面が表示され、タップすると 。

11. VPSが有効なロケーションを選択した場合は、Test VPSボタンをタップして、 ローカライゼーションが機能することを確認できます。

12. 特定の場所に追加するスキャンを作成するには、 の Add Scans ボタンをタップします。 Add Scansオプションを利用するためには、その場所の近くにいなければならないことに注意してください。

スキャンの作成とアップロード

1. 記録**ボタンはスキャン処理の開始と停止に使用します。

2. 一時停止**ボタンは、必要に応じてスキャン処理を一時的に中断するために使用することができます。

3. Time**表示は現在のスキャンの継続時間を示す。 VPS開発用にアップロード可能なスキャンには、最低15秒（ ）が必要です。 スキャンの長さは30～60秒（ ）が理想的である（60秒を超えるスキャンは、処理（ ）のために複数に分割される）。

4. X**ボタンをタップするとScaniverseのホーム画面に戻ります。

5. スキャンが完了すると、 、キャプチャしたシーンのプレビューメッシュを検査することができます。

6. スキャンに問題がなければ、Upload Scanボタンを押してすぐにアップロードすることもできます。

7. WiFi接続を使用したい場合は、後でアップロードを選択することもできます（推奨）。

8. スキャンに満足できない場合は、Deleteボタンを押してスキャンを破棄することができます。

Niantic Wayfarerのインストール

新しいVPSロケーションをスキャンしたり、すでに有効化されているロケーションにスキャンを追加したりするには、 、Niantic Wayfarerアプリを携帯電話にインストールする必要があります。 インストール方法および使用方法については、以下をご覧ください:

iOS

Niantic Wayfarer Appは、iOS 12以降とiPhone 8以降で利用可能です。 LiDAR搭載端末である必要はありません。

Niantic Wayfarerアプリのインストールは、iOS端末で Testflight for Niantic Wayfarer (8th.io/wayfarer-ios) へアクセスします。

Niantic Wayfarerの使用

Niantic Wayfarerアプリで、パブリックロケーションにスキャンを追加したり、 テストスキャンを作成することができます。

アプリをインストールしたら「Login with 8th Wall」ボタンを押して、8th Wallの認証情報でログインしてください。

複数のワークスペースにアクセスできる場合は、プロフィールページの「8th Wall Workspace」のドロップダウンを押して任意のワークスペースを選択してください。

ログインページ	プロフィールページ

Map_ページで、VPS Locationを選択して公開Locationにスキャンを追加するか(1)、_Scan_を選択してワークスペースにテストスキャンを追加します(2)。

推奨される［スキャン方法］(#scanning-technique) を用いてスキャンをしてください。

マップページ	スキャニングページ

スキャンが完了したら、公開またはテストのいずれかを選択し、アップロードする。

スキャンタイプ	スキャンアップロード

スキャンの処理には15～30分程度かかることがあります。 処理が完了するとGeospatial Browserにスキャンデータが表示されます。

スキャンや処理に関する問題は、support@lightship.devまでお問い合わせください。

Wayfarerアプリの使い方は、Lightshipドキュメントに詳しく記載されています。

スキャニング技術

スキャンされたVPSは、直径10m以下の大きさである必要があります。 例えば、典型的な彫像は、VPSで活動するロケーションとして機能する。 しかし建物全体は機能しません。 建物の正面や入り口部分などであれば有効かもしれません。 まずは、 小さなエリア（机、銅像、壁画など）から始めることをお勧めします。

スキャンする前に周囲の状況を把握し、スキャンする場所へのアクセス権があることを確認してください。

1. スキャンするエリアとスキャン対象物の周囲を確認し、 障害物があるかどうかを判断し、スキャンルートを選択します。 スキャンを開始する前に、 、スキャンに使用するルートを計画する必要がある。

2. カメラのピントが合っていることを確認してください。 手ブレは3D化に悪影響を及ぼす可能性があります。 、ブレを避けるため、携帯電話をできるだけ横に近づけてください。 一箇所に立って携帯電話を動かすのではなく、 スキャンする対象物の周りを歩く。

3. ゆっくりとした散歩のような自然なペースで歩いてください。 スキャン中はゆっくり、スムーズに動きましょう。 急な方向転換（ ）は絶対にダメだ。 地面に足をつけてゆっくり、スムーズに移動しましょう。 、暗い場所でスキャンする場合は、ゆっくりとスムーズに動くことがより重要になる。 動いている間（カニ歩きをイメージして）、携帯電話を に移動させる。

4. VPS ロケーションは常に焦点であるべきだ。 地図を作成するためには、 、VPSロケーションに焦点を当て、その360度の全軌道を捉えることが重要です。 安全でない場合、または360°をカバーすることが不可能な場合は、できる限り撮影すること。

5. 距離・角度を変える（0～10mまたは0～35ft）。 3Dマップがさまざまな シナリオでうまく機能するためには、ロケ地周辺の環境をキャプチャし、さまざまな 異なるスキャンを行うことが重要です。 距離と角度を変えながらロケハンをすることが重要だ。

推奨されるVPSロケーションスキャン技術のビデオ:

スキャンする際に避けるべきこと

1. 道路の真ん中や、 、子供のいる遊び場など、周囲が安全でない場所でのスキャンは避けること。

2. ロケ地が遠すぎる（10m以上）、または大きすぎてカメラ（ ）のピントが合わない場合は、スキャンを避ける。

3. 何気なく散歩やジョギングをしているときにスキャンするのは避けましょう。 ロケーションを常に焦点としておくことが重要である。

4. 蛍光灯や太陽など、非常に明るいものに端末を向けないようにします。

5. スキャン中に動かなかったり、速く動きすぎたりしないようにしてください。 急激な運動は、 再構成にオフセットを引き起こす。

6. 端末が熱くなるような場合はスキャンを避けてください。 デバイスの温度が上昇しすぎると、 の性能が大幅に低下し、スキャンに悪影響を及ぼす。

7. 不完全に見えるスキャンや、 スキャンしようとしているものを代表していないスキャンはアップロードしないでください。

テスト・スキャン

テスト・スキャンは、VPS の開発およびテストのために、1つのワークスペースでのみ利用可能な単一のメッシュです。 テストスキャンは、公開ロケーションの指名またはアクティベート中に、VPSの経験（ ）を開発およびテストするための優れたソリューションですが、公開された プロジェクトでの使用は許可されていません。

テスト・スキャンはNiantic Wayfarerアプリを使って作成されます。 8th Wallの認証情報を使用してWayfarerにログインし、Profileページから正しいワークスペースが選択されていることを確認します。 テスト・ スキャンは、スキャンおよび アップロード時に選択した 8th Wall ワークスペースでのみ利用可能です。 スキャンを別のワークスペースやLightshipアカウントに移動することはできません。

Wayfarerアプリで「Scan」を選択し、エリアのスキャン をします。

新しいメッシュは60秒ごとに生成されるので、 、120秒間スキャンすると2回のテストスキャンになる。 すべてのテストスキャンは unaligned です。

新しいメッシュは60秒ごとに生成されるので、 、120秒間スキャンすると2回のテストスキャンになります。

テストスキャンが処理に失敗した場合は、再スキャンが必要な場合があります。 詳しくは support@lightship.dev までお問い合わせください。

ロケーションの種類

地理空間ブラウザでは、4 つの異なるタイプの場所が表示されます:

タイプ	アイコン	説明
Public		「パブリック "ロケーションは、ナイアンティックのトラスト＆セーフティチームによって承認され、安全性と一般へのアクセスのしやすさという必要な基準を満たしています。 これらのロケ地は、出版されたプロジェクトで使用することができる。
Pending		「申請中」のロケーションは、ナイアンティックのトラスト＆セーフティチームによって、安全性と公共アクセスの必要基準を満たしているかどうか審査されます。 **審査が完了するまでの間、保留中のロケーションをスキャンして有効化することができます。
Rejected		「却下」されたロケーションは、ナイアンティックのトラスト＆セーフティ審査に落ちていたり、既存のロケーションと重複していたり、以前に却下されたロケーションと重複していたり、その他の理由でナイアンティックが許可していない可能性があります。 これらのロケーションをプロジェクトに追加することはできません。
テスト		「テスト "ロケーションは、NianticのWayfarerアプリを使ってスキャンすることで、ワークスペースにアクセスできるようになります。 テスト・ロケーションは、開発中の使用を意図したものであり、公表されたプロジェクトに含まれない場合がある。

VPSロケーションの作成に関するご質問や問題、または既存のロケーションのステータスの確認については、support@lightship.dev までお問い合わせください。

ロケーション・ステータス

地理空間ブラウザでは、VPSロケーションの5つの異なるステータスが表示されます:

ステータス	アイコン	説明
Not Activated		ステータスが "Not Activated "のロケーションは、そのロケーションに対してスキャンが提出されていません。 アクティベーションを要求する前に、その場所に対して最低10回の実行可能なスキャンが提出される必要があります。 スキャンが1回送信されると、場所のステータスは「スキャン中」に変わります。
Scanning		ステータスが「スキャン中」のロケーションは、そのロケーションに対して少なくとも1回のスキャンが提出されています。 アクティベーションを要求する前に、その場所に対して最低10回の実行可能なスキャンが提出される必要があります。
Processing		ステータスが「Processing（処理中）」となっているロケーションは、アクティベーション申請が提出されており、アクティベーション処理が完了するまで「Processing（処理中）」のステータスが表示されます。 通常、アクティベーション依頼は4時間以内に完了します。 手続きが完了するとメールが届きます。
Active		ステータスが「Active」のロケーションは、VPS for Webを使用してWebARコンテンツを作成するプロジェクトで使用できます。
Failed		ステータスが「Failed」のロケーションで、アクティベーション処理中に問題が発生しました。 これは、VPSの設置場所に適していない、スキャンが不十分、データが破損しているなど、さまざまな要因が考えられます。 残念ながら、このロケーションは、VPSを使用してWebARコンテンツを作成するために使用できないことを意味します。 第8回ウォール・プロジェクトで使用する新しいロケ地をぜひ見つけてください。

位置情報のスキャン、有効化、ステータスに関するご質問や問題については、support@lightship.dev までお問い合わせください。

ロケーション要件

VPSで使用する場所を選択する際には、以下の点を考慮してください:

• VPSが最も効果を発揮するのは、外観が明確で一貫性のある場所である（例えば、砂浜や 、移動可能な家具がある混雑したパティオスペースはうまく機能しない）。
• 反射や透明な特徴（窓や鏡など）が多い場所は、 。
• VPS体験の最大推奨サイズ（ ）は400 m^2（20 x 20 m）ですが、注意深くスキャンすれば、より大きな体験にも対応できます（ ）。

パブリック・ロケーションの要件

パブリック・ロケーションは、すべての開発者とそのプロジェクトやアプリを利用する人々がアクセスできる。 新しいパブリック・ロケーションを追加する場合は、以下のガイドラインを考慮してください:

• パブリック・ロケーションは、恒久的な物理的、具体的、識別可能な場所や物であるべきである。
• 公共の場所は、安全で、歩行者が一般に利用しやすいものでなければならない。
• タイトル、説明文、写真に正確な情報を盛り込み、ユーザー（ ）がその場所を見つけやすいようにしましょう。

プライベート・ロケーションの要件

プライベート・ロケーションは、特別な アクセス制御または一時的なVPS体験を作成する必要がある開発者向けのプレミアム機能です。 これらは、作成したワークスペース（ ）にのみ表示され、アクセスできる。 プライベート・ロケーションを新規作成する際は、以下の点を考慮してください:

• プライベート・ロケーションは、それを作成したワークスペースによってのみ発見可能であるため、そのワークスペースのプロジェクトのメンバーやユーザーによってのみ、 スキャンされ、ローカライズされます。
• プライベート・ロケーションは、特別にアクセス制御されたエクスペリエンス （例えば、あなたやあなたのクライアントの私有地に）を構築する場合に良い選択です。
• 、一時的に異なる外観を持つ公共の場所で体験を構築する場合（コンサート、博物館の展示会、その他の特別なイベントなど）には、プライベート・ロケーションも選択肢となります。

ロケーション 数量

第8の壁」プロジェクトに関連付けられる「ロケーション」の数に制限はない。 ロケーションはVPSサービスを介してサーバーサイドでローカライズされます。

場所 イベント

8th Wallは、プロジェクトロケーションのライフサイクルの様々な段階（スキャン、発見、 更新、紛失など）でイベントを発する。 Webアプリケーションでこれらのイベントを処理するための具体的な手順については、APIリファレンスを参照してください:

• AFrameイベント
• PlayCanvasイベント
• XrControllerのディスパッチイベント

ロケーション・クオリティ

ロケーションがVPSアクティベートされると、NianticはGeospatialブラウザで品質評価を提供します。 場所の詳細には、_Fair Quality_または_Good Quality_のいずれかが表示される。

ロケ品質とは、ロケがいつでもローカライズできる能力のことである。 、あらゆるタイプの照明で複数のスキャンが行われるロケ地は、品質が高くなる傾向がある。 必要最小限のスキャンしかできない場所や、 、1種類の照明でのスキャンが大半を占める場所は、品質が低くなる傾向がある。

品質格付けは自動化されたプロセスであり、ロケーションの実際のパフォーマンスを反映しない場合があります。 品質を見極めるには、自分で試してみるのが一番です。

ロケーション・アライメント

アンアライン警告は様々な理由で発生し、メッシュに対するローカライズが保証されないことを意味します。 メッシュはローカライズのためにうまく機能するかもしれませんが、この警告はメッシュが実験的なものであり、自己責任で使用されるべきものであることを示しています。

注: すべてのテストスキャンはunalighnedとなります。

Lightship VPSの有効化

WebARプロジェクトでVPSを有効にするには、enableVPSをtrueに設定する必要があります。

A-Frameプロジェクトの場合、<a-scene>のxrwebコンポーネントでenableVps: trueを設定します。

AFrame以外のプロジェクトでは、エンジンの初期化時にXR8.XrController.configure()の呼び出しでenableVps: trueを設定してください。

例 - AFrame

<a-scene
  coaching-overlay
  landing-page
  xrextras-loading
  xrextras-runtime-error
  ...
  xrweb="enableVps: true;">

例 - AFrame以外

XR8.XrController.configure({enableVps: true})
// 次に、8th Wallエンジンを起動します。

オーダーメイドのVPS体験の開発

オーダーメイドのVPSシーンは、単一のロケーション用にデザインされ、ARコンテンツを配置するためにGeospatial Browserの参照メッシュを利用します。

その1: シーンに場所を追加する

1. 地理空間ブラウザを開く（左側の地図アイコンǺ）。
2. VPSが有効なロケーションを探す(または自分で指名/有効化)
3. ロケーションをプロジェクトに追加する

パート2: カスタムARアニメーションのリファレンスとしてロケーションGLBを使用する

4. 行の右側から参考GLBをダウンロードする。
5. これを3Dモデリングソフトウェア（Blender、Maya、A-Frameなど）で使用して、ARコンテンツをメッシュの原点に対して相対的に配置します。

*重要この3Dモデルの原点はLocationの原点です。 原点をリセットしないでください。

_オプション_です: もし、Geospatial Browserからダウンロードしたメッシュが、ベイクドアニメーションや物理演算、オクルーダーのマテリアルに使用するのに十分な品質でない場合は、 、Scaniverseのようなサードパーティのアプリケーションを使ってスキャンし、その高品質メッシュと Geospatial Browserからダウンロードしたメッシュをアライメントすることを検討してください。

6. アニメーションGLBをクラウドエディタにインポートし、シーンに追加する
7. named-locationコンポーネントをアセットの<a-entity>に追加します。 name' 属性は、Geospatial Browser の Project Location の name を参照する。

ジャジャーン！ 🪄 アニメーションは、現実世界のロケ地と一直線上に表示されるはずです。

パート3: オクルージョンと影の追加

1. シーンに<a-entity named-location="name: LOCATIONNAME"><a-entity> を追加する。
2. この要素の中に、子要素として<a-entity> を3つ追加する。 これらはオクルーダー・メッシュ、シャドウ・メッシュ、VPSアニメーションとなる。
3. 最初の<a-entity>にxrextras-hider-materialとgltf-model="#vps-mesh"を追加する。 "#vps-mesh"は、 、テクスチャが削除され、ジオメトリが縮小されたリファレンスGLBのバージョンを参照する必要があります。
4. 2番目の<a-entity>に、shadow-shader、gltf-model="#vps-mesh"、shadow="cast: false"を追加する。 シャドウシェーダは、Zファイトを防ぐためにポリゴンオフセットで参照メッシュにシャドウマテリアルを適用します。 shadow="cast:true"で、vps-meshに実世界に影を落とすかどうかを選択できる。
5. 3番目の<a-entity>に、gltf-model="#vps-anim"、reflections="type: realtime"、play-vps-animation、shadow="receive:false"を追加する。 play-vps-animationは、vps-coaching-overlayが消えるまで待ってからVPSアニメーションを再生する。

*リモートデスクトップ開発セットアップ

A-Frameインスペクタを使って、デスクトップ上のコンテンツをリモートで配置すると便利なことがよくあります。 このプロジェクトのシーンをリモートデスクトップ開発用に設定するには、 、先頭に文字を追加して、以下のコンポーネントを無効にしてください（例: "Znamed-location"）:

• xrweb -> Zxrweb
• xrextras-loading -> Zxrextras-loading.
• named-location -> Znamed-location
• xrextras-hider-material -> Zxrextras-hider-material。

これで、A-Frame Inspector （Mac: ctrl + opt + i、PC: ctrl + alt + i）を開き、Geospatial BrowserからインポートしたVPSメッシュに対してコンテンツを相対的に配置することができます。 覚えておいてほしいのは、これは_検査官_だということだ。 トランスフォームの値をコードにコピーし直す必要がある。

オプションとして、<a-entity named-location>を一時的にシーンの中心に再配置することができます。 注: VPS のコンテンツが正しく配置されるように、<a-entity named-location>をposition="0 0"\ にリセットする。

*リモート・モバイル開発セットアップ

A-Frameインスペクタを使用して、モバイルデバイスでVPSをリモートシミュレートすると便利です。 リモート・モバイル開発用にこのプロジェクトのシーンをセットアップするには、 、以下のコンポーネントの先頭にアルファベットを追加して無効にする（例: "Znamed-location"）:

• named-location->Znamed-location`
• xrextras-hider-material -> Zxrextras-hider-material\。

次に、VPSを無効にし、絶対スケールを有効にする必要があります。 これにより、正確なシミュレーションのために参照メッシュ のサイズが正しく設定されます:

xrweb="enableVps: false; scale: absolute;".

<a-entity named-location> を一時的にシーンの中央に再配置する必要があります。 反復速度を支援します。 リファレンスメッシュの底辺をy="0"（地面）に合わせるようにします。 注: VPSプロジェクトをデプロイする前に、<a-entity named-location>をposition="0 0"\ にリセットして、VPSコンテンツが正しく配置されていることを確認してください。

手続き的なVPS体験の開発

プロシージャルVPSシーンは、（特定のプロジェクト・ロケーションではなく）検出されたロケーションを使用するように設計されています。 一度検出されると、ロケーションのメッシュ 、プロシージャル生成されたVPS体験を生成することができます。

8th Wallエンジンが発するプロシージャル関連のイベントは2つある:

• xrmeshfound:開始後またはrecenter()後にメッシュが最初に見つかったときに発行されます。
• xrmeshlost: recenter()が呼び出されたときに表示されます。

メッシュが検出されると、8th Wallエンジンはrecenter()が呼ばれるまでそのメッシュに対してトラッキングを続ける。

VPS FAQ

Lightship VPSとは？

Lightship VPS（Visual Positioning System）は、アプリケーションが 、ユーザーのデバイスを実世界の場所にローカライズすることを可能にするクラウドサービスであり、ユーザーが永続的なARコンテンツと対話することを可能にし、 、新たな没入体験を提供する。 VPSは、ナイアンティックのクラウド上に存在する地図データを参照（ ）することで、デバイスの位置と向き（ポーズ）を決定する。

VPSの仕組みは？

デバイスがVPSサービスを呼び出すと、サービスはユーザーの デバイスからクエリー画像と（GPSからの）大まかな位置を入力として受け取り、その場所に存在する マップを使用してローカライズを試みる。 ローカライゼーションが成功した場合、 送信された画像のタイムスタンプに対応する デバイスの位置と向き（ポーズ）を返す。 VPSのクエリ画像がキャプチャされてから、VPSサービスから レスポンスが受信されるまでの間には時間遅れがあるため、移動中に正確な位置情報を維持するためには、デバイスにモーショントラッキングシステム（ ）が必要である。 VPSサービスが デバイスにポーズ推定値を返すとき、デバイスのトラッキングシステムからのポーズの差は、VPSがVPSクエリに対するサーバーのレスポンス を待っている間、デバイスがどのように動いたかを「追跡」できるように、ローカライゼーション レスポンスに追加される。

スキャンとは何ですか？

プレイヤー、開発者、測量士からのARスキャンは、 Niantic Mapを作成するために使用される基本的な材料です: Nianticの3D世界地図。 ARスキャンは、ポケモンGO、Ingress、Wayfarerアプリで使用されているモジュールであるNianticのAR スキャンフレームワークを使用して記録され、アップロードされる。 各AR スキャンは、加速度計とGPSセンサー からのサポートデータを含む一連のビデオフレームで構成され、複数の2D画像から世界の3Dモデルを構築する。 ARスキャンは、ナイアンティックが 、現実世界の場所のマップとメッシュを構築するために使用される。

マップとは何ですか？

VPSの用語では、マップは、VPS APIが 、デバイスをローカライズするために使用されるデータアーティファクトです。 マップは、クエリー画像を入力とし、 位置と向き（ポーズ）を出力として返す関数と考えることができる。 ある場所に対応する地図は、その場所でアップロードされたスキャンから 。 VPSのマップは人間が読めるものではありません。

メッシュとは何ですか？

VPSの用語では、メッシュは実世界の場所やオブジェクトの3Dモデルです。 メッシュは、物理的な空間やオブジェクトの詳細な表現（ ）を提供し、その場所がどのように見えるかを理解するのに役立ちます。 、ARコンテンツをオーサリングする際のリファレンスとして、また物理効果やオクルージョン効果を作成するのに役立ちます。 マップのように、ある場所に対応するメッシュは、 その場所にアップロードされたスキャンから作成される。 メッシュは人間にも機械にも読める。

VPSはどこで使えるのですか？

VPSは150,000以上の実際の場所で利用可能で、毎日さらに多くの場所が追加されている。 VPSでロケーションを利用できるようにするには、 そのロケーションで十分な量のARスキャンデータがアップロードされ、VPSのアクティベーションプロセスが完了している必要があります。 開発者は、地図を 、地理空間ブラウザを使用して完全にスキャンされた場所のVPSアクティベーションを要求するために新しい場所を追加することができます。

VPSのアクティベーションはどのように行われるのですか？

ロケーションがVPSアクティベーションの対象となるには、 の最低品質チェックに合格したスキャンが10件以上アップロードされている必要があります。また、 、最も古いスキャンと最新のスキャンの時間差が5時間以上ある必要があります。 これらの要件は、結果として得られるマップとメッシュが、 十分な品質であり、ユーザーが確実にローカライズできるような十分なバリエーションを捉えていることを保証する。 VPSのアクティベーション・プロセスはナイアンティックのARマッピング・インフラ上で実行され、多くの複雑な ステップが含まれる。 その場所での適格なスキャンのプールから、アルゴリズムがほとんどのスキャンを選択し、 、マップとメッシュの構築に使用し、残りの一握りは検証用と 、ローカライゼーションの品質を測定する。 ロケーションのアクティベーション・プロセスはナイアンティックのサーバーで実行され、通常 、完了までに1～2時間かかります。

VPSのアクティベーションが完了した後、自分のスキャンデータを見ることはできますか？

アクティベーションの過程で、アップロードされたスキャンから作成されたマップとメッシュは、可能な限り多くの情報を取り込むために、 、融合される。 開発者がコンテンツを作成するために、またユーザーがローカライズするために 、最終的に使用されるこの製品は、多くの異なる ソースからのスキャンで構成されている。 スキャンデータは、その場所のより包括的な表現を作成するために混合される。 そのため、その場所でアップロードされるスキャンと、VPSが有効化された後に作成される マップやメッシュの間には一対一の関係はない。

すでにアクティベートしているロケーションに、さらにスキャンを追加することは可能ですか？

場合によっては、開発者は、場所のマップとメッシュの品質とカバレッジを向上させるために、以前に 、アクティブ化された場所に追加のスキャンを追加したいと思うかもしれません。 ロケーションが「再アクティブ化」の対象となるためには、前回アクティブ化されたときから、少なくとも5回の追加スキャン がアップロードされていなければならない。 重要なのは、 、既存の融合マップに新しいスキャンを追加することはまだできない。むしろ、再活性化のプロセスでは、新しいスキャンを既存のスキャンのコンテキストに組み込んだ、 、新しい融合マップを構築する必要がある。

新しい拠点のVPSアクティベーションを依頼するにはどうすればよいですか？

VPS の有効化要件を満たすだけのスキャンがアップロードされると（ 最低 10 回、最も古いスキャンと最新のスキャンの時間差が 5 時間以上）、開発者は、 Wayfarer アプリまたは地理空間ブラウザで場所を選択し、 "activate"（有効化）ボタンを押すことで、VPS の有効化をリクエストできます。 これで、その場所がアクティベーション・キューに追加される。 通常、 のアクティベーション申請は2時間以内に完了する。 開発者はまた、5つの追加スキャンがアップロードされると、 既存の場所の再アクティベーションを要求するオプションがあります。

VPSは夜間や悪天候でも動作しますか？

VPSは視界が良好なときに効果を発揮します。 VPSを利用した体験を成功させる可能性を最大化するためには、 の様々な条件（例えば、異なる時間帯、異なる天候など）を幅広くカバーする多くのARスキャンをアップロードするのが最善である。 例えば、 、雨の多い場所で経験を積むのであれば、雨の日のスキャンがあると非常に役に立つ。

ARスキャンやVPSには、LiDARセンサーを搭載したスマホが必要なのでしょうか？

ARスキャンやVPSではLiDARは必要ありません。