XRBoundedReferenceSpace.boundsGeometry

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

XRBoundedReferenceSpaceboundsGeometry 読み取り専用プロパティは、ビューアーが移動できる多角形の内部を構成する点を指定する DOMPointReadOnly オブジェクトの配列です。 各点は 2 次元の点として扱われ、地面レベルに配置する必要があります(つまり、その y 座標は 0 である必要があります)。

この境界は通常、XR ハードウェアを制御するソフトウェアを使用してユーザーが構成します。 これは、使用したい空間の境界を歩くか、XR 入力デバイスを使用して部屋の形状を描くことによって行うことができます。 理論的には、より高度なシステムでは、センサーやその他の検出方法を使用して、専用の XR ルーム(それを慎重にホロデッキとは呼んでいないことに気づきましたか?)の境界を決定する場合があります。

構文

bounds = xrReferenceSpace.boundsGeometry;

boundsGeometry プロパティは、DOMPointReadOnly オブジェクトの配列であり、各オブジェクトは、ビューアーが留まる必要がある多角形(polygon、ポリゴン)内の 1 つの頂点を定義します。 各点は床レベルにあり、y 座標の値は 0 に設定されている必要があります。 さらに、w の値は、配列内のすべての点で常に 1 です。 さらに、点は時計回りにリストする必要があります

boundsGeometry の各エントリーは、部屋のネイティブの境界ジオメトリー点のリストのエントリーと同じであり、原点オフセットの逆数が事前に乗算されています。 言い換えると、境界は使用可能な空間の物理的な制限であり、参照空間の境界点がすべて XRBoundedReferenceSpace の実際の原点に対して定義されるようにシフトされます。

使用上の注意

制限付き参照空間の原点は常に地面レベルにあり、y は 0 です。 原則として、基盤となるプラットフォームまたは XR ハードウェアに応じたものとして、xz の原点は空間の中心またはその近くにあり、向きは論理的前方を向いています。

部屋の境界がフィンガープリントの目的で使用されるリスクを減らすために、boundsGeometry 配列の各点は、丸められるか、ある程度調整される場合があります。 仕様では、ブラウザーが点を最も近い 5 センチメートルにシフトすることを推奨しています(ハードウェアの物理的な制限の外側に出ないようにしながら)。

境界の大きさ

XRBoundedReferenceSpace は、非常に大きな制限付き領域に使用することを目的としていません。 それよりも、ネイティブの原点から任意の方向に使用可能な移動空間が約 15 メートル以下の 1 部屋の空間に使用することを目的としています。 とはいえ、境界は 2 次元でのみ定義されるため、境界は無限に上向きに拡張されます。

複数部屋の空間を作成する必要がある場合、または非常に大きい空間やさまざまな床レベルが必要な場合は、代わりに無制限の XRReferenceSpace を使用し、必要に応じて独自に境界を適用する必要があります。

境界の形状

boundsGeometry によって定義される形状は、正方形のように単純な場合もあれば、必要に応じて複雑な場合もあり、凹部や凸部を含む可能性があります。 ただし、XRBoundedReferenceSpace を使用して、床レベルが不均一な空間を表すことはできません。 地面は常に y = 0 にあります。

ユーザーが boundsGeometry で指定された境界から出る必要があるようにコンテンツを設計していないことが重要です。 ただし、ユーザーの周囲が定義された境界を超えるように移動することを許可している場合、コンテンツはその状況を適切に処理できる必要があり、これはエラー状態とは見なされません。

一部のサンプルは、メッシュまたはその他の形状をレンダリングしてユーザーに境界を表示しますが、実際のアプリケーションでは、これを行うべきではありません。 ただし、ブラウザーは、リスク(移動し続けると、物理的な壁にぶつかる恐れなど)についてユーザーに適切な警告を提供する必要があります。

仕様書

Specification
WebXR Device API
# dom-xrboundedreferencespace-boundsgeometry

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
boundsGeometry
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.