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 vor der Verwendung auf produktiven Webseiten.

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
createAnchor
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.

Siehe auch