XRInputSourceEvent: frame-Eigenschaft

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

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

Die schreibgeschützte XRInputSourceEvent-Eigenschaft frame spezifiziert ein XRFrame-Objekt, das den Ereignisrahmen darstellt, in dem eine WebXR-Benutzereingabe aufgetreten ist. Somit kann es sich um ein Ereignis handeln, das in der Vergangenheit aufgetreten ist und nicht um ein aktuelles oder bevorstehendes Ereignis.

In diesem Artikel

Wert

Ein XRFrame, der den Ereignisrahmen angibt, bei dem das durch das Objekt beschriebene Benutzereingabeereignis stattgefunden hat.

Verwendungshinweise

Der Ereignisrahmen entspricht nicht einem visuellen Frame, wie er an die Frame-Rendering-Callback-Funktion geliefert wird (siehe Rendering und der WebXR-Frame-Rendering-Callback für Details zum Callback). Stattdessen ist der durch die frame-Eigenschaft angegebene XRFrame eine Methode, um Zugang zur getPose()-Methode zu bieten, die verwendet werden kann, um die relativen Positionen der Objekte in der Szene zu dem Zeitpunkt zu erhalten, als das Ereignis aufgetreten ist.

Da es sich beim Ereignisrahmen jedoch nicht um einen Animationsrahmen handelt, gibt es keine Betrachterposition, die den aktuellen Blickwinkel des Betrachters darstellt; die Ergebnisse des Aufrufs von getViewerPose() werden eine XRViewerPose mit einer leeren views-Liste sein.

Beispiele

Dieser Code zeigt einen Handler für das selectstart-Ereignis, das die Pose des Zielstrahls aus dem Frame erhält und die Pose, die den Strahl darstellt (event.inputSource.targetRaySpace), auf den gesamten Referenzraum myRefSpace abbildet.

Wenn das Ergebnis nicht null ist, wird die Transformation der Zielstrahlpose an eine Funktion namens myCheckAndHandleHit() übergeben, um zu überprüfen, ob der Strahl auf etwas zeigte, als das "Select" ausgelöst wurde.

js
xrSession.onselectstart = (event) => {
  let targetRayPose = event.frame.getPose(
    event.inputSource.targetRaySpace,
    myRefSpace,
  );
  if (targetRayPose) {
    checkAndHandleHit(targetRayPose.transform);
  }
};

Spezifikationen

Spezifikation

WebXR Device API
# dom-xrinputsourceevent-frame

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

WebXR Device API
XRInputSourceEvent
Konstruktor
1. XRInputSourceEvent()
Instanzeigenschaften
1. frame
2. inputSource
Vererbung
1. Event
Verwandte Seiten für WebXR Device API
Anleitungen
1. Grundlagen von WebXR
2. Lebenszyklus einer WebXR-Anwendung
3. Starten und Beenden einer WebXR-Sitzung
4. Geometrie und Referenzräume im WebXR
5. Räume und Referenzräume: Räumliches Tracking in WebXR
6. Rendering und der WebXR-Frame-Animationsrückruf
7. Blickpunkte und Betrachter: Kamerasimulation in WebXR
8. Eine perspektivische Rückschau für WebXR-Entwickler
9. Beleuchtung einer WebXR-Umgebung
10. Verwendung von begrenzten Referenzräumen
11. Bewegung, Orientierung und Bewegung: Ein WebXR-Beispiel
12. Eingaben und Eingabequellen
13. Targeting und Treffererkennung
14. WebXR-Leitfaden zur Leistungsoptimierung
15. WebXR-Berechtigungen und Sicherheit