Ir al contenido principal

Eventos AFrame

Esta sección describe los eventos emitidos por los componentes A-Frame xrweb, xrface y xrhand.

Puedes escuchar estos eventos en tu aplicación web para llamar a una función que gestione el evento.

Eventos emitidos por xrconfig

Los siguientes eventos son emitidos por xrconfig (que se añade automáticamente si sólo utilizas xrweb, xrface, xrhand o xrlayers):

Evento emitidoDescripción
camerastatuschangeEste evento se emite cuando cambia el estado de la cámara. Véase onCameraStatusChange de XR8.addCameraPipelineModule() para más información sobre los posibles estados.
realityerrorEste evento se emite cuando se ha producido un error al inicializar 8th Wall Web. Esta es la hora recomendada en la que deben mostrarse los mensajes de error. La XR8.XrDevice() API puede ayudar a determinar qué tipo de mensaje de error debe mostrarse.
realityreadyEste evento se emite cuando 8th Wall Web se ha inicializado y se ha procesado correctamente al menos un fotograma. Este es el momento recomendado en el que se deben ocultar los elementos de carga.
screenshoterrorEste evento se emite en respuesta al evento screenshotrequest que resulta en un error.
screenshotreadyEste evento se emite en respuesta al evento screenshotrequest que se ha completado con éxito. Se proporcionará la imagen comprimida en JPEG del lienzo AFrame.

Eventos emitidos por xrweb

Evento emitidoDescripción
xrimageloadingEste evento se emite cuando comienza la carga de la imagen de detección.
xrimagescanningEste evento se emite cuando se han cargado todas las imágenes de detección y se ha iniciado la exploración.
xrimagefoundEste evento se emite cuando se encuentra por primera vez un objetivo de imagen.
xrimageupdatedEste evento se emite cuando un objetivo de imagen cambia de posición, rotación o escala.
xrimagelostEste evento se emite cuando un objetivo de imagen deja de ser rastreado.
xrmeshfoundEste evento es emitido cuando una malla es encontrada por primera vez ya sea después del inicio o después de un recenter().
xrmeshupdatedEste evento se emite cuando la primera malla encontrada cambia de posición o rotación.
xrmeshlostEste evento se emite cuando se llama a recenter().
xrprojectwayspotscanningEste evento se emite cuando todos los puntos de paso del proyecto se han cargado para su exploración.
xrprojectwayspotfoundEste evento se emite cuando se encuentra por primera vez un Project Wayspot.
xrprojectwayspotupdatedEste evento se emite cuando un Project Wayspot cambia de posición o rotación.
xrprojectwayspotlostEste evento se emite cuando un Project Wayspot deja de ser rastreado.
xrtrackingstatusEste evento se emite cuando XR8.XrController se inicia y en cualquier momento cambia el estado o motivo del seguimiento.

Eventos emitidos por xrface

Evento emitidoDescripción
xrfaceloadingEste evento se emite cuando comienza la carga de recursos adicionales de Face AR.
xrfacescanningEste evento se emite cuando se han cargado los recursos AR y ha comenzado la exploración.
xrfacefoundEste evento se emite cuando se encuentra una cara por primera vez.
xrfaceupdatedEste evento se emite cuando posteriormente se encuentra la cara.
xrfacelostEste evento se emite cuando se deja de seguir una cara.
xrmouthopenedEste evento se emite cuando se abre la boca de una cara rastreada.
xrmouthclosedEste evento se emite cuando se cierra la boca de una cara rastreada.
xrlefteyeopenedEste evento se emite cuando se abre el ojo izquierdo de una cara rastreada.
xrlefteyeclosedEste evento se emite cuando el ojo izquierdo de una cara rastreada se cierra.
xrrighteyeopenedEste evento se emite cuando se abre el ojo derecho de una cara rastreada.
xrrighteyeclosedEste evento se emite cuando el ojo derecho de una cara rastreada se cierra.
xrlefteyebrowraisedEste evento se emite cuando la ceja izquierda de una cara rastreada se levanta de su posición inicial cuando se encontró la cara.
xrlefteyebrowloweredEste evento se emite cuando la ceja izquierda de una cara rastreada se baja a su posición inicial cuando se encontró la cara.
xrrighteyebrowraisedEste evento se emite cuando la ceja derecha de una cara rastreada se levanta de su posición inicial cuando se encontró la cara.
xrrighteyebrowloweredEste evento se emite cuando la ceja derecha de una cara rastreada se baja a su posición inicial cuando se encontró la cara.
xrlefteyewinkedEste evento se emite cuando el ojo izquierdo de un rostro rastreado se cierra y se abre en un plazo de 750 ms mientras que el ojo derecho permanece abierto.
xrrighteyewinkedEste evento se emite cuando el ojo derecho de una cara rastreada se cierra y se abre en un intervalo de 750 ms, mientras que el ojo izquierdo permanece abierto.
xrblinkedEste evento se emite cuando los ojos de una cara rastreada parpadean.
xrinterpupillarydistanceEste evento se emite cuando se detecta por primera vez la distancia en milímetros entre los centros de cada pupila de una cara rastreada.

Eventos emitidos por xrhand

Evento emitidoDescripción
xrhandloadingEste evento se emite cuando comienza la carga de recursos manuales AR adicionales.
xrhandscanningEste evento se emite cuando se han cargado los recursos AR y ha comenzado la exploración.
xrhandfoundEste evento se emite cuando se encuentra una mano por primera vez.
xrhandupdatedEste evento se emite cuando posteriormente se encuentra la mano.
xrhandlostEste evento se emite cuando se deja de seguir una mano.