XRReferenceSpace: reset-Ereignis

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

addEventListener("reset", (event) => { })

onreset = (event) => { }

Ein XRReferenceSpaceEvent. Erbt von Event.

Zusätzlich zu den unten aufgeführten Eigenschaften sind auch Eigenschaften der übergeordneten Schnittstelle Event verfügbar.

referenceSpace Schreibgeschützt

Ein XRReferenceSpace, das den Referenzraum anzeigt, der das Ereignis generiert hat.

transform Schreibgeschützt

Ein XRRigidTransform-Objekt, das die Position und Orientierung des angegebenen referenceSpace-Objekts nach dem Ereignis darstellt, relativ zum Koordinatensystem vor dem Ereignis definiert.

Das reset-Ereignis zeigt an, dass das Koordinatensystem zurückgesetzt oder neu konfiguriert wurde, indem der Ursprung des Referenzraums geändert, und es laut der transform-Eigenschaft des Ereignisses bewegt und gedreht wurde. Das Ereignis wird gesendet, bevor Animationframe-Callbacks ausgeführt werden, um den anstehenden Frame zu rendern, damit diese Callbacks das aktualisierte Koordinatensystem verwenden können.

Es gibt verschiedene Gründe, warum ein Reset auftreten kann. Die häufigsten sind die folgenden:

• Der Benutzer hat das Koordinatensystem manuell zurückgesetzt, z.B. durch eine Anfrage, das Headset neu zielen zu lassen, um sicherzustellen, dass die Blickrichtung und Handcontroller mit der tatsächlichen Position und Blickrichtung des Benutzers synchronisiert sind. Dies betrifft hauptsächlich local oder local-floor Referenzflächen.
• Für ein bounded-floor Referenzsystem kann das Koordinatensystem zurückgesetzt werden, wenn der Benutzer die Grenzen des Referenzraums verlässt und in einen neuen eintritt (wie zum Beispiel beim Überqueren eines Levels zu einem anderen in einem Spiel, wo jedes Level seine eigene Karte mit eigenem Koordinatensystem hat).
• Das Trackingsystem hat den Benutzer vorübergehend verloren und dann wieder gefunden, jedoch nicht bevor dieser sich genug bewegt hatte, um sich aus der unmittelbaren Nähe der zuletzt bekannten Position zu entfernen. Dies ist hauptsächlich ein Problem für unbounded Referenzflächen.
• Der Benutzer befindet sich in einem unbounded Referenzraum und hat sich weit genug vom Ausgangspunkt (des Referenzraums Ursprungs) entfernt, dass Gleitkomma- oder andere Formen von Fehlern oder Drift problematisch sind. Das Koordinatensystem wird dann mit seinem neuen Ursprung am oder nahe dem aktuellen Standort des Benutzers zurückgesetzt.
• Die WebXR-Infrastruktur oder die Hardwaretreiber haben festgestellt, dass das Gerät das Tracking vorübergehend verloren hat, was dazu führt, dass Hardware und Software bei Position und Orientierung nicht mehr übereinstimmen.

Wenn Sie Zeit mit der Verwendung eines VR-Headsets verbracht haben, hatten Sie Zeiten, in denen Sie es starteten und obwohl Sie geradeaus schauten, das Headset denkt, dass Sie in den Himmel oder auf den Boden blicken; oder Zeiten, in denen Sie den Handcontroller geradeaus richten, aber das Headset denkt, dass Sie irgendwo nach oben und rechts zielen. In solchen Situationen halten Sie typischerweise einen Knopf gedrückt, der die Welt dazu bringt, sich mit der aktuellen Ausrichtung des Geräts zu synchronisieren. Das funktioniert, indem ein reset-Ereignis an den oder die Referenzräume gesendet wird, die auf der Ausrichtung des Headsets basieren.

Sie können Sprünge in der Position des Betrachters überwachen, indem Sie die Boolesche XRPose Eigenschaft emulatedPosition beobachten. Wenn ein Sprung in der Position des Betrachters mit dem Umschalten von emulatedPosition von true auf false zusammenfällt, hat der Betrachter das Tracking wiedererlangt, und seine neue Position stellt eine Korrektur der zuvor emulierten Werte dar. Dies ist typischerweise das gewünschte Verhalten, wenn Ihre Seite oder Ihre App keine Bewegung im Raum simuliert, indem die Position und/oder Orientierung des Betrachters ausdrücklich geändert wird (anstatt die physischen Bewegungen des Benutzers vom XR-Gerät verwendet werden, um Bewegung einzuführen).

Wenn jedoch eine Art von "Teleportation" verwendet wird, möchten Sie tatsächlich vermeiden, die Position des Benutzers nach der Wiederherstellung des Trackings springen zu lassen, da dies zusätzliche und möglicherweise störende Sprünge einführen kann. Anstatt dies zuzulassen, können Sie die emulatedPosition in den Teleportationsversatz integrieren, der vor dem Aufruf von getOffsetReferenceSpace() berechnet wird, um einen neuen Referenzraum zu erstellen, dessen aktualisierter effektiver Ursprung durch die Entfernung angepasst wird, um die die Position des Betrachters seit dem vorherigen Frame gesprungen ist. Auf diese Weise ändert sich die Position des Benutzers nur einmal statt zweimal.

Das reset-Ereignis wird nicht ausgelöst, wenn die Diskontinuität klein genug ist, um das Tracking innerhalb desselben Trackingbereichs wiederzuerlangen. Es wird auch nicht ausgelöst bei einem unbounded Referenzraum, wenn er über die Zeit kleine Anpassungen an seinem nativen Ursprung vornimmt, um die Stabilität des Raums in der Nähe des Benutzers aufrechtzuerhalten; nur große Diskontinuitäten lösen einen Reset aus.

Um einen Handler für das reset-Ereignis hinzuzufügen, können Sie eine von zwei Ansätzen verwenden. Zuerst können Sie die Methode addEventListener() verwenden:

viewerRefSpace.addEventListener("reset", (event) => {
  /* perform reset related tasks */
});

Die zweite Option besteht darin, die onreset-Ereignishandler-Eigenschaft des XRReferenceSpace-Objekts zu setzen:

viewerRefSpace.onreset = (event) => {
  /* perform reset related tasks */
};