XRWebGLBinding: getDepthInformation() Methode
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.
Die getDepthInformation()
Methode des XRWebGLBinding
Interfaces gibt ein XRWebGLDepthInformation
Objekt zurück, das WebGL-Tiefeninformationen enthält.
Syntax
getDepthInformation(view)
Parameter
Rückgabewert
Ein XRWebGLDepthInformation
Objekt.
Ausnahmen
NotSupportedError
DOMException
-
Wird ausgelöst, wenn
"depth-sensing"
nicht in der Liste der aktivierten Funktionen für dieseXRSession
enthalten ist. InvalidStateError
DOMException
-
Wird ausgelöst, wenn das
XRFrame
nicht aktiv oder animiert ist. Das Abrufen von Tiefeninformationen ist nur innerhalb desrequestAnimationFrame()
Rückrufs gültig. InvalidStateError
DOMException
-
Wird ausgelöst, wenn die
depthUsage
der Sitzung nicht"gpu-optimized"
ist.
Beispiele
Abrufen von WebGL-Tiefeninformationen
const canvasElement = document.querySelector(".output-canvas");
const gl = canvasElement.getContext("webgl");
await gl.makeXRCompatible();
// Make sure to request a session with depth-sensing enabled
const session = navigator.xr.requestSession("immersive-ar", {
requiredFeatures: ["depth-sensing"],
depthSensing: {
usagePreference: ["gpu-optimized"],
formatPreference: ["luminance-alpha"],
},
});
const glBinding = new XRWebGLBinding(session, gl);
// …
// Obtain depth information in an active and animated frame
function rafCallback(time, frame) {
session.requestAnimationFrame(rafCallback);
const pose = frame.getViewerPose(referenceSpace);
if (pose) {
for (const view of pose.views) {
const depthInformation = glBinding.getDepthInformation(view);
if (depthInformation) {
// Do something with the depth information
// gl.bindTexture(gl.TEXTURE_2D, depthInformation.texture);
// …
}
}
}
}
Spezifikationen
Specification |
---|
WebXR Depth Sensing Module # dom-xrwebglbinding-getdepthinformation |
Browser-Kompatibilität
BCD tables only load in the browser