VRDisplayEvent.reason

非推奨: この機能は非推奨になりました。まだ対応しているブラウザーがあるかもしれませんが、すでに関連するウェブ標準から削除されているか、削除の手続き中であるか、互換性のためだけに残されている可能性があります。使用を避け、できれば既存のコードは更新してください。このページの下部にある互換性一覧表を見て判断してください。この機能は突然動作しなくなる可能性があることに注意してください。

非標準: この機能は標準ではなく、標準化の予定もありません。公開されているウェブサイトには使用しないでください。ユーザーによっては使用できないことがあります。実装ごとに大きな差があることもあり、将来は振る舞いが変わるかもしれません。

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

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

値

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

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

例

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-Frame、Babylon.js、Three.js などのフレームワークを使用するか、ポリフィルを使用することが、すべてのブラウザーで動作する WebXR アプリを開発する上で推奨されます。[1]

ブラウザーの互換性

BCD tables only load in the browser

関連情報