WebXR アンカー・モジュール

1. はじめに

1.1. 用語

この文書で理解される Pose は、3D 空間内の位置および向きを意味する。

この文書で理解される Anchor は、現実世界に対して固定されたポーズを追跡し、 アプリケーションによって作成されるエンティティである。

2. 初期化

2.1. 機能記述子

アプリケーションがセッション中にアンカーを使用する関心を示すには、適切な 機能記述子を用いてセッションを要求しなければならない。 文字列 anchors は、このモジュールによって、アンカー機能の 新しい有効な機能記述子として導入される。

デバイスの追跡システムがネイティブアンカー機能を公開する場合、そのデバイスは アンカー機能をサポート可能である。インライン XR デバイスは、アンカー機能をサポート可能として 扱ってはならない。ユーザーエージェントは、mode が "immersive-ar" に等しい セッションについて、アンカー機能のサポートを試みるべきである。

注記: アンカー機能のサポートは必須ではないが、 アンカーは、AR 対応アプリケーションが良好なユーザー 体験を提供するために必要な基本機能の 1 つである。したがって、ユーザーエージェントが "immersive-ar" セッションでアンカーをサポートすることが *強く* 推奨される。

3. アンカー

3.1. XRAnchor

[SecureContext, Exposed=Window]
interface XRAnchor {
  readonly attribute XRSpace anchorSpace;

  Promise<DOMString> requestPersistentHandle();

  undefined delete();
};

XRAnchor は、 他の XRSpaces に対して相対的にアンカーを特定するために使用できる anchorSpace を含む。この属性が、deleted が true に設定されているときにアクセスされた場合、ユーザーエージェントは InvalidStateError を投げなければならない。

各 XRAnchor には、初期値が false に設定される、関連付けられた deleted ブール値がある。

各 XRAnchor には、関連付けられた native origin がある。

各 XRAnchor には、関連付けられた session がある。

注記: XRSystem が一意な ID を作成する場合、それは一意であり、現在のオリジンにのみ知られていなければならない。

4. アンカーの作成

XRSession は、関連付けられた set of tracked anchors を含むように拡張される。

XRSession は、XRAnchor オブジェクトをキーとし、 Promise<XRAnchor> オブジェクトにマップする、関連付けられた map of new anchors を含むように拡張される。

partial interface XRFrame {
  Promise<XRAnchor> createAnchor(XRRigidTransform pose, XRSpace space);
};

partial interface XRSession {
  readonly attribute FrozenArray<DOMString> persistentAnchors;

  Promise<XRAnchor> restorePersistentAnchor(DOMString uuid);
  Promise<undefined> deletePersistentAnchor(DOMString uuid);
};

partial interface XRHitTestResult {
  Promise<XRAnchor> createAnchor();
};

XRHitTestResult は、関連付けられた native entity を含むように拡張される。 結果を計算することになった native entity に関する情報を基盤となるシステムが提供しない場合、 native entity は null に設定されていると仮定される。

アプリケーションは、次の 2 つの方法のいずれかでアンカーを作成できる:

• フレームからアンカーを作成することによって - 作成されたアンカーは、 特定の現実世界のオブジェクトには付加されない。

• ヒットテスト結果からアンカーを作成することによって - 基盤となる XR device がそれをサポートしている場合、 作成されたアンカーは現実世界のオブジェクトに付加される。

フレームからアンカーを作成するには、アプリケーションは XRFrame の createAnchor(pose, space) メソッドを呼び出すことができる。

注記: 各 createAnchor(pose, space) 呼び出しによって返されるアンカーが追跡する物理的な原点が、メソッドが呼び出されたフレームによって表される時点で、 space 内の pose の物理的位置と可能な限り近く整合することを確実にするのは、ユーザーエージェントの責任である。 具体的には、これは、動的に変化する空間について、ユーザーエージェントがアプリの指定した時刻におけるそのような空間の native origin を 捕捉しようとするべきであることを意味する。このテキストは非規範的であるが、仕様の著者および コントリビューターの意図を表しているため、異なるベンダー間で一貫した動作を確保するために、 実装が従うことが強く推奨される。

ヒットテスト結果からアンカーを作成するには、アプリケーションは XRHitTestResult の createAnchor() メソッドを呼び出すことができる。

注記: createAnchor(pose, space) メソッドに存在する同じ注意事項が、ここにも同様に適用される。

Session の "list of frame updates" には順序を指定する方法が必要になる可能性がある - 一部のアルゴリズムは他のものに依存する場合がある。

5. アンカーの更新

[Exposed=Window]
interface XRAnchorSet {
  readonly setlike<XRAnchor>;
};

partial interface XRFrame {
  [SameObject] readonly attribute XRAnchorSet trackedAnchors;
};

XRAnchorSet インターフェイスは、アンカーのコレクションを公開する方法として導入される。

XRFrame は、フレーム内でまだ追跡されているすべてのアンカーを含む trackedAnchors 属性を含むように拡張される。XRFrame の作成時、その集合は最初は空であり、update anchors アルゴリズムによって設定される。

6. アンカーの削除

アプリケーションがアンカーへの更新を受け取ることにもはや関心がない場合、delete() を呼び出すことで、 アンカーを削除できる。

7. ネイティブデバイスの概念

7.1. ネイティブアンカー

基盤となる XR device は、アンカーに関連する次の機能をサポートしている場合、 サポート可能な anchors 機能を持つ:

• ネイティブアンカーの作成が可能であり、次の要件を満たす:

  • ネイティブアンカー API は、アンカーのポーズを現実世界に対して固定されているかのように 維持しようとする。

  • ある特定の時刻 t における、新しく作成されるアンカーのポーズを受け入れる。

  • 新しく作成されるアンカーを与えられたエンティティに付加する意図を表現するために、 任意で native entity 情報を受け入れる。基盤となる XR システムがアンカーを native entity に付加することをサポートしない場合（すなわち native entity を受け入れない場合）、 新しく作成されたアンカーは自由浮遊になる。

  • ユーザーエージェントによって native origin として扱うことができる 結果を返す。

• ネイティブアンカーは、基盤となる XR システムによって継続的に追跡され、通常はその最新状態を問い合わせることができる。ただし、その位置が不明な フレームが存在する場合があり、そのためユーザーエージェントは、一時的にポーズが特定不能であると報告してもよい。 基盤となるシステムが、ネイティブアンカーの位置が二度と知られることはないと判断した場合、 ネイティブアンカーはもはや追跡されていないと報告するべきである。

• 任意で、ネイティブアンカーは native entity に付加できる。native entity に付加されたネイティブアンカーは、 付加されているエンティティに対してその位置を固定したまま維持しようとする（自由浮遊アンカーの場合の 現実世界に対する固定とは対照的である）。デバイスが、アンカーが付加されているオブジェクトのポーズが 変化したことを検出すると、アンカーはそれに応じて更新される。これは、オブジェクト自体が移動したことを 意味しない - その位置に対するシステムの理解が変化した可能性がある。基盤となるシステムが移動する オブジェクトを追跡できる場合、移動するオブジェクトに付加されたネイティブアンカーも更新されるべきである。

基盤となるデバイスがネイティブアンカーをサポートしない場合、ユーザーエージェントは エミュレートされたネイティブアンカーを通じて anchors API を実装することを決定してもよい。 このアプローチでは、アンカーは作成されると、そのポーズは決して変化せず、そのポーズは、XRFrame の createAnchor(pose, space) や XRHitTestResult の createAnchor() などのアンカー作成メソッドにアプリケーションが渡したポーズであると仮定する。

注記: エミュレートされたネイティブアンカー のアプローチは、アプリケーションが anchors 機能を自分自身でエミュレートすることと等価であり、 アプリケーションが処理する必要のあるさまざまな場合の数を減らすのに役立つ場合がある。また、 アプリケーションが "immersive-ar" および "immersive-vr" セッションで同じコードを再利用できるようにする可能性もある。

8. プライバシーとセキュリティに関する考慮事項

一般的な移動するオブジェクトの追跡を サポートするデバイスを認識していない - それらは仕様でまったく考慮されるべきだろうか？そのようなデバイスの 例はあるだろうか？

9. 謝辞

次の個人が WebXR Anchors 仕様の設計に貢献した: