XRWebGLBinding: XRWebGLBinding() Konstruktor

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Der XRWebGLBinding() Konstruktor erstellt und gibt ein neues XRWebGLBinding-Objekt zurück.

Syntax

js
new XRWebGLBinding(session, context)

Parameter

session

Ein XRSession-Objekt, das die WebXR-Sitzung spezifiziert, die unter Verwendung des WebGL-Kontexts gerendert wird.

context

Ein WebGLRenderingContext oder WebGL2RenderingContext, der den WebGL-Zeichnungskontext identifiziert, der zum Rendern der Szene für die angegebene WebXR-Sitzung verwendet wird.

Rückgabewert

Ein neues XRWebGLBinding.

Ausnahmen

InvalidStateError DOMException

Wird ausgelöst, wenn das neue XRWebGLBinding aufgrund einer der folgenden Situationen nicht erstellt werden konnte:

  • Die durch session angegebene XRSession wurde bereits gestoppt.
  • Der angegebene WebGL-Kontext, context, ist verloren gegangen, etwa durch einen GPU-Wechsel oder -Reset.
  • Die angegebene session ist immersiv, aber der context ist nicht WebXR-kompatibel.

Beispiele

js
const canvasElement = document.querySelector(".output-canvas");
const gl = canvasElement.getContext("webgl");
const xrSession = await navigator.xr.requestSession("immersive-vr");
await gl.makeXRCompatible();

const glBinding = new XRWebGLBinding(xrSession, gl);

Spezifikationen

Specification
WebXR Layers API Level 1
# dom-xrwebglbinding-xrwebglbinding

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch