From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/xrsystem/index.html | 114 +++++++++++++++++++++++++++++++++++ 1 file changed, 114 insertions(+) create mode 100644 files/ja/web/api/xrsystem/index.html (limited to 'files/ja/web/api/xrsystem/index.html') diff --git a/files/ja/web/api/xrsystem/index.html b/files/ja/web/api/xrsystem/index.html new file mode 100644 index 0000000000..242d729317 --- /dev/null +++ b/files/ja/web/api/xrsystem/index.html @@ -0,0 +1,114 @@ +--- +title: XRSystem +slug: Web/API/XRSystem +tags: + - API + - AR + - Augmented Reality + - Experimental + - Interface + - Reference + - VR + - Virtual Reality + - WebXR + - WebXR Device API + - XR + - XRSystem +translation_of: Web/API/XRSystem +--- +

{{APIRef("WebXR Device API")}}{{SecureContext_Header}}

+ +

WebXR Device API の XRSystem インターフェイスは、WebXR セッションを表す {{domxref("XRSession")}} オブジェクトにアクセスできるようにするメソッドを提供します。 その XRSession が手元にあれば、それを使用して拡張現実（AR）または仮想現実（VR）デバイスと対話できます。

+ +

プロパティ

+ +

XRSystem はプロパティを直接提供しませんが、親インターフェイスである {{domxref("EventTarget")}} からプロパティを継承します。

+ +

メソッド

+ +

XRSystem インターフェイスには、親インターフェイスである {{domxref("EventTarget")}} からメソッドを継承することに加えて、次のメソッドが含まれています。

+ +
+
{{DOMxRef("XRSystem.isSessionSupported", "isSessionSupported()")}} {{Experimental_Inline}}
+
ブラウザーが指定された {{domxref("XRSessionMode")}} をサポートしている場合、true に解決される promise を返します。 指定されたモードをサポートしていない場合、false に解決されます。
+
{{DOMxRef("XRSystem.requestSession", "requestSession()")}} {{Experimental_Inline}}
+
指定された {{DOMxRef("XRSessionMode")}} を持つ新しい {{DOMxRef("XRSession")}} に解決される promise を返します。
+
+ +

イベント

+ +
+
{{domxref("XRSystem.devicechange_event", "devicechange")}} {{experimental_inline}}
+
使用可能な XR デバイスのセットが変更されたときに送信されます。
+ {{domxref("XRSystem.ondevicechange", "ondevicechange")}} イベントハンドラーを使用することもできます。
+
+ +

使用上の注意

+ +

このインターフェイスは、以前のバージョンの仕様では単に XR と呼ばれていました。 コードや文書に XR への参照がある場合は、それを XRSystem に置き換えてください。

+ +

例

+ +

次の例は、{{domxref("XRSystem.isSessionSupported", "isSessionSupported()")}} と {{domxref("XRSystem.requestSession", "requestSession()")}} の両方を使用する方法を示しています。

+ +
if (navigator.xr) {
+  immersiveButton.addEventListener("click", onButtonClicked);
+  navigator.xr.isSessionSupported('immersive-vr')
+  .then((isSupported) => {
+    if (isSupported) {
+      immersiveButton.disabled = false;
+    } else {
+      immersiveButton.disabled = true;
+    }
+  });
+}
+
+function onButtonClicked() {
+  if (!xrSession) {
+    navigator.xr.requestSession('immersive-vr')
+    .then((session) => {
+      // onSessionStarted() not shown for reasons of brevity and clarity.
+      onSessionStarted(session);
+    });
+  } else {
+    // Shut down the already running XRSession
+    xrSession.end()
+    .then(() => {
+      // Since there are cases where the end event is not sent, call the handler here as well.
+      onSessionEnded();
+    });
+  }
+}
+ +

このコードは、{{domxref("navigator.xr")}} プロパティを探して、WebXR が使用可能かどうかを確認することから始まります。 見つかった場合は、WebXR が存在することがわかっているので、ユーザーがクリックして没入型 VR モードのオンとオフを切り替えることができるボタンのハンドラーを確立します。

+ +

ただし、目的の没入型モードが利用可能かどうかはまだわかりません。 これを決定するために、ボタン immersiveButton を有効にする前に、必要なセッションオプションを渡して isSessionSupported() を呼び出します。 これにより、ユーザーは、没入型 VR モードが使用可能な場合にのみ没入型モードに切り替えることができます。 没入型 VR が利用できない場合、ボタンを使用できないように無効しています。

+ +

onButtonClicked() 関数は、実行中のセッションがすでに存在するかどうかを確認します。 存在しない場合は、requestSession() を使用して開始し、返された promise が解決したら、関数 onSessionStarted() を呼び出して、レンダリングなどのためにセッションを設定します。

+ +

一方、進行中の XR セッションがすでに存在する場合は、代わりに {{domxref("XRSession.end", "end()")}} を呼び出して現在のセッションを終了します。 現在のセッションが終了すると、{{domxref("XRSession.end_event", "end")}} イベントが送信されるので、そのハンドラーで xrSession を null に設定して、進行中のセッションがなくなったことを記録します。 そうすれば、ユーザーがボタンをもう一度クリックすることで、新しいセッションが開始されます。

+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName("WebXR", "#xrsystem-interface", "XRSystem")}}{{Spec2("WebXR")}}初期定義
+ +

ブラウザーの互換性

+ + + +
{{Compat("api.XRSystem")}}
-- cgit v1.2.3-54-g00ecf