VRDisplay

プロパティ

VRDisplay.capabilities 読取専用

VRDisplay の備える機能を示す VRDisplayCapabilities オブジェクトを返します。

VRDisplay.depthFar

視錐台 (ビューフラスタム；つまりシーンの可視領域の境界) の far 平面を定義している z-depth の取得と設定を行います。

VRDisplay.depthNear

視錐台 (ビューフラスタム；つまりシーンの可視領域の境界) の near 平面を定義している z-depth の取得と設定を行います。

VRDisplay.displayId 読取専用

この VRDisplay 固有のIDを返します。この ID は Gamepad API (参照 Gamepad.displayId) の関連付けのために使用されます。

VRDisplay.displayName 読取専用

VRDisplay を識別するための人間が読める形式の名前を返します。

VRDisplay.isConnected 読取専用

VRDisplay がコンピュータに接続されているか否かを示す論理値を返します。

VRDisplay.isPresenting 読取専用

VRDisplay が現在コンテンツを表示中であるか否かを示す論理値を返します。

VRDisplay.stageParameters 読取専用

VRDisplay がルームスケール体験をサポートしている場合に、ルームスケールパラメーターを含んだ VRStageParameters オブジェクトを返します。

メソッド

VRDisplay.getEyeParameters()

指定した側の視線パラメーターを含む VREyeParameters オブジェクトを返します。

VRDisplay.getFrameData()

VRFrameData オブジェクトを受け取り、現在のフレームをレンダリングするために必要な情報を入力します。

VRDisplay.getImmediatePose()

VRDisplay の現在のポーズを定義した VRPose オブジェクトを、予測を適用せずに返します。これはもはや必要ないため、仕様から削除されました。

VRDisplay.getLayers()

VRDisplay によって現在表示されているレイヤーを返します。

VRDisplay.getPose()

現在のフレームが実際に表示されるときの VRDisplay の予測ポーズを定義した VRPose オブジェクトを返します。このメソッドは非推奨です。代わりに VRDisplay.getFrameData() を使用する必要があり、これも VRPose オブジェクトを提供します。

VRDisplay.resetPose()

現在の VRPose.position と VRPose.orientation を"原点/ゼロ"位置の値として扱うように、VRDisplay のポーズをリセットします。

VRDisplay.cancelAnimationFrame()

Window.cancelAnimationFrame の特別な実装で、VRDisplay.requestAnimationFrame() を未登録状態にすることをコールバック可能にしています。

VRDisplay.requestAnimationFrame()

Window.requestAnimationFrame の特別な実装で、VRDisplayの新しいフレームが描画される際に毎回呼出されるコールバック関数を持っています。

VRDisplay.requestPresent()

VRDisplay へのシーン描画を開始します。

VRDisplay.exitPresent()

VRDisplay のシーン描画を停止します。

VRDisplay.submitFrame()

現在表示されている VRLayerInit の状態を取得し、VRDisplay に表示します。

例

if (navigator.getVRDisplays) {
  console.log("WebVR 1.1 supported");
  // Then get the displays attached to the computer
  navigator.getVRDisplays().then(function (displays) {
    // If a display is available, use it to present the scene
    if (displays.length > 0) {
      vrDisplay = displays[0];
      // Now we have our VRDisplay object and can do what we want with it
    }
  });
}

仕様書

このインターフェイスは、古い WebVR API の一部でしたが、 WebXR Device API に置き換えられました。標準化される予定はありません。

すべてのブラウザーが新しい WebXR API を実装するまで、すべてのブラウザーで動作する WebXR アプリケーションを開発するには、A-Frame や Babylon.js や Three.js などのフレームワークを利用したり、ポリフィルを利用したりすると良いでしょう [1]。

ブラウザーの互換性

関連情報

• WebVR API