XRRenderState: layers-Eigenschaft

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.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die schreibgeschützte layers-Eigenschaft der XRRenderState-Schnittstelle ist ein geordnetes Array, das XRLayer-Objekte enthält, die vom XR-Kompositor angezeigt werden.

Wert

Ein geordnetes Array, das XRLayer-Objekte enthält. Die Reihenfolge der Ebenen ist "von hinten nach vorne".

Beispiele

Renderzustands-Ebenen abrufen

Um das WebXR-Ebenen-Array zu lesen, verwenden Sie die layers-Eigenschaft auf XRRenderState. Ebenen können mit der Methode XRSession.updateRenderState() gesetzt werden.

js
const xrSession = navigator.xr.requestSession("immersive-ar", {
  optionalFeatures: ["layers"],
});

function onXRSessionStarted(xrSession) {
  const glCanvas = document.createElement("canvas");
  const gl = glCanvas.getContext("webgl", { xrCompatible: true });
  const xrGlBinding = new XRWebGLBinding(xrSession, gl);
  const projectionLayer = new XRWebGLLayer(xrSession, gl);
  const quadLayer = xrGlBinding.createQuadLayer({
    pixelWidth: 1024,
    pixelHeight: 1024,
  });

  xrSession.updateRenderState({
    layers: [projectionLayer, quadLayer],
  });

  xrSession.renderState.layers; // [projectionLayer, quadLayer]
}

Spezifikationen

Specification
WebXR Layers API Level 1
# dom-xrrenderstate-layers

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch