---
title: XRReferenceSpaceType
slug: Web/API/XRSession/requestReferenceSpace
tags:
  - API
  - AR
  - Enumerated
  - Enumerated Type
  - Reality
  - Reference
  - Type
  - VR
  - Virtual
  - WebXR
  - WebXR API
  - WebXR Device API
  - XR
  - XRReferenceSpace
  - XRReferenceSpaceType
  - augmented
  - space
  - tracking
translation_of: Web/API/XRReferenceSpaceType
original_slug: Web/API/XRReferenceSpaceType
---
<p>{{APIRef("WebXR Device API")}}</p>

<p><span class="seoSummary"><strong><code>XRReferenceSpaceType</code></strong> 列挙型は、WebXR がサポートしている参照空間のタイプを識別する文字列を定義します。</span> このタイプは、{{domxref("XRSession.requestReferenceSpace", "requestReferenceSpace()")}} メソッドを呼び出して {{domxref("XRSession")}} の参照空間を取得するときに使用します。<br>
  </p>

<h2 id="Values" name="Values">値</h2>

<p>{{domxref("XRSession.requestReferenceSpace()")}} によって返される参照空間は、{{domxref("XRReferenceSpace")}} または {{domxref("XRBoundedReferenceSpace")}} のいずれかです。 以下の表の「インターフェイス」列は、各参照空間タイプ定数に対して2つの型のどちらが返されるかを示しています。</p>

<h3 id="Reference_space_descriptors" name="Reference_space_descriptors">参照空間記述子</h3>

<p>参照空間のタイプを以下の表に示します。 それらのユースケースと、それらを実装するために使用されるインターフェイスについての簡単な情報が含まれています。</p>

<div id="foo">
<table class="standard-table" id="value-list">
 <thead>
  <tr>
   <th scope="col">XRReferenceSpaceType</th>
   <th scope="col">説明</th>
   <th scope="col">インターフェイス</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td><a id="bounded-floor" name="bounded-floor"><code>bounded-floor</code></a></td>
   <td><code>local</code> タイプと同様ですが、返されたオブジェクトの {{domxref("XRBoundedReferenceSpace.boundsGeometry", "boundsGeometry")}} によって指定された所定の境界の外にユーザーが移動することは想定されていません。</td>
   <td>{{domxref("XRBoundedReferenceSpace")}}</td>
  </tr>
  <tr>
   <td><a id="local" name="local"><code>local</code></a></td>
   <td>
    <p>セッションが作成されたときのネイティブの原点がビューアーの位置の近くにある追跡空間。 正確な位置は、基盤となるプラットフォームと実装によって異なります。 ユーザーは、開始位置を超えて移動することはあまり想定されておらず、この使用例に合わせて追跡が最適化されています。</p>

    <p>6 自由度（6DoF）追跡のデバイスの場合、<code>local</code> 参照空間は、環境に対して原点を安定させようとします。</p>
   </td>
   <td>{{domxref("XRReferenceSpace")}}</td>
  </tr>
  <tr>
   <td><a id="local-floor" name="local-floor"><code>local-floor</code></a></td>
   <td><code>local</code> タイプと同様ですが、開始位置は、ビューアーが立つことができる安全な場所に配置され、y 軸の値は床レベルで 0 です。 その床レベルがわからない場合、{{Glossary("user agent","ユーザーエージェント")}}は床レベルを推定します。 推定床レベルがゼロ以外の場合、ブラウザーはフィンガープリントを回避するような方法で丸めることが期待されます（最も近いセンチメートルまで）。</td>
   <td>{{domxref("XRReferenceSpace")}}</td>
  </tr>
  <tr>
   <td><a id="unbounded" name="unbounded"><code>unbounded</code></a></td>
   <td>おそらく原点から非常に長い距離にわたって、ユーザーが自由に移動できる追跡空間。 ビューアーはまったく追跡されません。 追跡は、ユーザーの現在位置周辺の安定性のために最適化されているため、ネイティブの原点は、そのニーズに対応するために必要に応じてドリフトする可能性があります。</td>
   <td>{{domxref("XRReferenceSpace")}}</td>
  </tr>
  <tr>
   <td><a id="viewer" name="viewer"><code>viewer</code></a></td>
   <td>ネイティブの原点がビューアーの位置と向きを追跡する追跡空間。 これは、ユーザーが物理的に移動できる環境で使用し、没入型（immersive）とインライン（inline）の両方の {{domxref("XRSession")}} のすべてのインスタンスをサポートしますが、インラインセッションで最も役立ちます。 ビューアーと入力の間の距離を決定するとき、またはオフセット空間を操作するときに特に役立ちます。 そうでない場合、通常、他の参照空間タイプの1つがより頻繁に使用されます。</td>
   <td>{{domxref("XRReferenceSpace")}}</td>
  </tr>
 </tbody>
</table>
</div>

<h2 id="Specifications" name="Specifications">仕様</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">仕様</th>
   <th scope="col">状態</th>
   <th scope="col">コメント</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('WebXR','#enumdef-xrreferencespacetype','XRReferenceSpaceType')}}</td>
   <td>{{Spec2('WebXR')}}</td>
   <td>初期定義</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>

<p>{{Compat("api.XRReferenceSpaceType")}}</p>