XRReferenceSpaceType
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
XRReferenceSpaceType
列挙型は、WebXR がサポートしている参照空間のタイプを識別する文字列を定義します。 このタイプは、requestReferenceSpace()
メソッドを呼び出して XRSession
の参照空間を取得するときに使用します。
値
XRSession.requestReferenceSpace()
によって返される参照空間は、XRReferenceSpace
または XRBoundedReferenceSpace
のいずれかです。 以下の表の「インターフェイス」列は、各参照空間タイプ定数に対して 2 つの型のどちらが返されるかを示しています。
参照空間記述子
参照空間のタイプを以下の表に示します。 それらのユースケースと、それらを実装するために使用されるインターフェイスについての簡単な情報が含まれています。
XRReferenceSpaceType | 説明 | インターフェイス |
---|---|---|
bounded-floor |
local タイプと同様ですが、返されたオブジェクトの boundsGeometry によって指定された所定の境界の外にユーザーが移動することは想定されていません。 |
XRBoundedReferenceSpace |
local |
セッションが作成されたときのネイティブの原点がビューアーの位置の近くにある追跡空間。 正確な位置は、基盤となるプラットフォームと実装によって異なります。 ユーザーは、開始位置を超えて移動することはあまり想定されておらず、この使用例に合わせて追跡が最適化されています。6 自由度(6DoF)追跡のデバイスの場合、local 参照空間は、環境に対して原点を安定させようとします。 |
XRReferenceSpace |
local-floor |
local タイプと同様ですが、開始位置は、ビューアーが立つことができる安全な場所に配置され、y 軸の値は床レベルで 0 です。 その床レベルがわからない場合、ユーザーエージェントは床レベルを推定します。 推定床レベルがゼロ以外の場合、ブラウザーはフィンガープリントを回避するような方法で丸めることが期待されます(最も近いセンチメートルまで)。 |
XRReferenceSpace |
unbounded |
おそらく原点から非常に長い距離にわたって、ユーザーが自由に移動できる追跡空間。 ビューアーはまったく追跡されません。 追跡は、ユーザーの現在位置周辺の安定性のために最適化されているため、ネイティブの原点は、そのニーズに対応するために必要に応じてドリフトする可能性があります。 | XRReferenceSpace |
viewer |
ネイティブの原点がビューアーの位置と向きを追跡する追跡空間。 これは、ユーザーが物理的に移動できる環境で使用し、没入型(immersive)とインライン(inline)の両方の XRSession のすべてのインスタンスをサポートしますが、インラインセッションで最も役立ちます。 ビューアーと入力の間の距離を決定するとき、またはオフセット空間を操作するときに特に役立ちます。 そうでない場合、通常、他の参照空間タイプの 1 つがより頻繁に使用されます。 |
XRReferenceSpace |
仕様
Specification |
---|
WebXR Device API # dom-xrsession-requestreferencespace |
ブラウザーの互換性
BCD tables only load in the browser