XRSystem: devicechange イベント

このイベント名を addEventListener() などのメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。

addEventListener("devicechange", (event) => {});

ondevicechange = (event) => {};

WebXR の使用が xr-spatial-tracking 権限ポリシーによってブロックされている場合、 devicechange イベントは発行されません。

一般的な Event で、追加のプロパティはありません。

没入型 XR 端末の利用できる状況が変化したときに発生します。例えば、 VR ヘッドセットや AR ゴーグルが接続されたり切断されたりした場合です。

このイベントを使用して、例えば WebXR 互換端末が利用できるかどうかを監視し、ユーザーが没入モードを有効にするために使用する UI 要素を有効にすることができます。この例を下記の例で示します。

この例では、「Enter XR」ボタンが利用できるかどうかを、現在利用できる没入型機器があるかどうかに基づいて切り替えることで、devicechangeイベントを処理しています。

if (navigator.xr) {
  navigator.xr.addEventListener("devicechange", (event) => {
    navigator.xr.isSessionSupported("immersive-vr").then((immersiveOK) => {
      enableXRButton.disabled = !immersiveOK;
    });
  });
}

devicechange を受信すると、このコードで設定したハンドラーは XR の isSessionSupported() メソッドを呼び出して、没入型 VR プレゼンテーションを処理できる端末があるかどうかを調べます。ある場合は XR モードに入るボタンが有効になり、ない場合は無効になります。

また、 ondevicechange イベントハンドラープロパティを使用して、 devicechange イベントに単一のハンドラーを設定することもできます。

if (navigator.xr) {
  navigator.xr.ondevicechange = (event) => {
    // …
  };
}