XRBoundedReferenceSpace.boundsGeometry

bounds = xrReferenceSpace.boundsGeometry;

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

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

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

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

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

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

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

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

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