XRFrame: createAnchor()-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.

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

Die createAnchor()-Methode des XRFrame-Interfaces erstellt einen freischwebenden XRAnchor, der relativ zur realen Welt fixiert wird.

Siehe XRHitTestResult.createAnchor() für die Erstellung eines Ankers aus einem Hit-Test-Ergebnis, das an ein reales Objekt gebunden ist.

Syntax

js
createAnchor(pose, space)

Parameter

pose

Ein XRRigidTransform-Objekt mit der initialen Pose, an der der Anker erstellt werden soll. Das System stellt sicher, dass die Beziehung zur physischen Welt, die zu diesem Zeitpunkt hergestellt wird, erhalten bleibt, während sich das Verständnis des Trackingsystems von der Welt weiterentwickelt.

space

Ein XRSpace-Objekt, relativ zu dem die Pose ist.

Rückgabewert

Ein Promise, das zu einem XRAnchor-Objekt aufgelöst wird.

Beispiele

Erstellen eines Ankers

js
frame.createAnchor(anchorPose, referenceSpace).then(
  (anchor) => {
    // Do stuff with the anchor (assign objects that will be relative to this anchor)
  },
  (error) => {
    console.error(`Could not create anchor: ${error}`);
  },
);

Spezifikationen

Specification
WebXR Anchors Module
# dom-xrframe-createanchor

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch