このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

VRDisplayEvent.reason

Deprecated

Avoid using this feature in new projects. Development of the WebVR API halted in favor of WebXR. This feature may be a candidate for removal from web standards or browsers.

Consider using the following features instead: WebXR.

非標準: この機能は標準化されていません。非標準の機能はブラウザーの対応が限られ、将来的に変更または削除される可能性があるため、本番環境での使用は推奨されません。ただし、標準の選択肢が存在しない特定のケースでは、有効な代替手段となる場合があります。

reasonVRDisplayEvent インターフェイスの読み取り専用プロパティで、イベントが発生した理由を人間可読な形で返します。

メモ: このプロパティは古い WebVR API の一部でした。これは WebXR 機器 API に置き換えられました。

文字列で、このイベントが発生した理由を表します。利用可能な理由は VRDisplayEventReason 列挙型で次のように定義されています。

  • mountedVRDisplay は、ユーザーがそれを装着した(または他の方法でアクティブになった)ことを検知しました。
  • navigation — このページは、すでに VR 表示モードになっている他のサイトなど、このページをすぐに表示し始めることができるコンテキストから移動されたものです。
  • requested — ユーザーエージェントは、 VR表示モードの開始をリクエストされました。これにより、ユーザーエージェントは様々な形で VR に入るための一貫した UI を持つことができます。
  • unmountedVRDisplay は、ユーザーがそれを外した(または、それ以外のスリープ/スタンバイ状態になった)ことを検知しました。

js
window.addEventListener("vrdisplaypresentchange", (e) => {
  console.log(
    `Display ${e.display.displayId} presentation has changed. Reason given: ${e.reason}.`,
  );
});

仕様書

このプロパティは古い WebVR API の一部であり、これは WebXR 機器 API で置き枯れられました。標準規格になる見込みはありません。

すべてのブラウザーが新しい WebXR API を実装するまで、 A-FrameBabylon.jsThree.js などのフレームワークを使用するか、ポリフィルを使用することが、すべてのブラウザーで動作する WebXR アプリを開発する上で推奨されます。[1]

ブラウザーの互換性

関連情報