Zum Hauptinhalt springen

PlayCanvas-Ereignisse

Dieser Abschnitt beschreibt die Ereignisse, die von 8th Wall in einer PlayCanvas-Umgebung ausgelöst werden.

Sie können auf diese Ereignisse in Ihrer Webanwendung warten.

Ereignisse Emittiert

Emittiertes EreignisBeschreibung
xr:camerastatuschangeDieses Ereignis wird ausgelöst, wenn sich der Status der Kamera ändert. Siehe onCameraStatusChange von XR8.addCameraPipelineModule() für weitere Informationen über den möglichen Status.
xr:realityerrorDieses Ereignis wird ausgelöst, wenn bei der Initialisierung von 8th Wall Web ein Fehler aufgetreten ist. Dies ist der empfohlene Zeitpunkt, zu dem eventuelle Fehlermeldungen angezeigt werden sollten. Die [XR8.XrDevice()API] (/legacy/api/xrdevice) kann dabei helfen, die Art der Fehlermeldung zu bestimmen, die angezeigt werden soll.
xr:realityreadyDieses Ereignis wird ausgelöst, wenn 8th Wall Web initialisiert wurde und mindestens ein Frame erfolgreich verarbeitet wurde. Dies ist der empfohlene Zeitpunkt, zu dem alle Ladeelemente ausgeblendet werden sollten.
xr:screenshoterrorDieses Ereignis wird als Reaktion auf die Screenshotrequest ausgegeben, die zu einem Fehler führt.
xr:screenshotreadyDieses Ereignis wird als Reaktion auf die erfolgreiche Beendigung des Ereignisses Screenshotrequest ausgegeben. Das JPEG-komprimierte Bild der AFrame-Leinwand wird zur Verfügung gestellt.

XR8.XrController Ausgelöste Ereignisse

Wenn XR8.XrController.pipelineModule() hinzugefügt wird, indem es in extraModules an XR8.PlayCanvas.run() übergeben wird, werden diese Ereignisse ausgelöst:

Emittiertes EreignisBeschreibung
xr:imageloadingDieses Ereignis wird ausgelöst, wenn das Laden des Erkennungsbildes beginnt.
xr:imagescanningDieses Ereignis wird ausgelöst, wenn alle Erkennungsbilder geladen wurden und der Scanvorgang begonnen hat.
xr:imagefoundDieses Ereignis wird ausgelöst, wenn ein Bildziel zum ersten Mal gefunden wird.
xr:imageupdatedDieses Ereignis wird ausgelöst, wenn ein Bildziel seine Position, Drehung oder Skalierung ändert.
xr:imagelostDieses Ereignis wird ausgelöst, wenn ein Bildziel nicht mehr verfolgt wird.
xr:meshfoundDieses Ereignis wird ausgelöst, wenn ein Mesh zum ersten Mal entweder nach dem Start oder nach einem recenter() gefunden wird.
xr:meshupdatedDieses Ereignis wird ausgelöst, wenn das erste gefundene Netz seine Position oder Drehung ändert.
xr:meshlostDieses Ereignis wird ausgelöst, wenn "recenter()" aufgerufen wird.
xr:projectwayspotscanningDieses Ereignis wird ausgelöst, wenn alle Projektstandorte zum Scannen geladen wurden.
xr:projectwayspotfoundDieses Ereignis wird ausgelöst, wenn ein Projektstandort zum ersten Mal gefunden wird.
xr:projectwayspotupdatedDieses Ereignis wird ausgelöst, wenn ein Projektstandort seine Position oder Drehung ändert.
xr:projectwayspotlostDieses Ereignis wird ausgelöst, wenn ein Projektstandort nicht mehr verfolgt wird.

XR8.LayersController Ausgelöste Ereignisse

Wenn XR8.LayersController.pipelineModule() hinzugefügt wird, indem es in extraModules an XR8.PlayCanvas.run() übergeben wird, werden diese Ereignisse ausgelöst:

Emittiertes EreignisBeschreibung
xr:layerloadingWird ausgelöst, wenn der Ladevorgang für zusätzliche Ebenensegmentierungsressourcen beginnt.
xr:layerscanningWird ausgelöst, wenn alle Ebenensegmentierungsressourcen geladen wurden und der Scanvorgang begonnen hat. Pro gescannter Ebene wird ein Ereignis ausgelöst.
xr:layerfoundWird ausgelöst, wenn eine Ebene zum ersten Mal gefunden wird.

XR8.FaceController-Ereignisse, die ausgegeben werden

Wenn XR8.FaceController.pipelineModule() hinzugefügt wird, indem es in extraModules an XR8.PlayCanvas.run() übergeben wird, werden diese Ereignisse ausgelöst:

Emittiertes EreignisBeschreibung
xr:faceloadingWird ausgelöst, wenn der Ladevorgang für zusätzliche Face-AR-Ressourcen beginnt.
xr:facescanningWird ausgelöst, wenn alle Face-AR-Ressourcen geladen wurden und der Scanvorgang begonnen hat.
xr:facefoundWird ausgelöst, wenn ein Gesicht zum ersten Mal gefunden wird.
xr:faceupdatedWird ausgelöst, wenn anschließend ein Gesicht gefunden wird.
xr:facelostWird ausgelöst, wenn ein Gesicht nicht mehr verfolgt wird.

XR8.HandController Ausgelöste Ereignisse

Wenn XR8.HandController.pipelineModule() hinzugefügt wird, indem es in extraModules an XR8.PlayCanvas.run() übergeben wird, werden diese Ereignisse ausgelöst:

Emittiertes EreignisBeschreibung
xr:handloadingWird ausgelöst, wenn der Ladevorgang für zusätzliche Hand-AR-Ressourcen beginnt.
xr:handscanningWird ausgelöst, wenn alle Hand-AR-Ressourcen geladen wurden und der Scanvorgang begonnen hat.
xr:handfoundWird ausgelöst, wenn eine Hand zum ersten Mal gefunden wird.
xr:handupdatedWird ausgelöst, wenn anschließend eine Hand gefunden wird.
xr:handlostWird ausgelöst, wenn eine Hand nicht mehr verfolgt wird.