Skip to main content

Événements à effets de visage

Types

TransformObject

PropriétéTypeDescription
position{x, y, z}La position 3D de la face située.
rotation{w, x, y, z}L'orientation locale en 3D de la face localisée.
échelleNombreFacteur d'échelle à appliquer aux objets attachés à cette face.
largeur mise à l'échelleNombreLargeur approximative de la tête dans la scène, multipliée par l'échelle.
hauteur mise à l'échelleNombreHauteur approximative de la tête dans la scène, multipliée par l'échelle.
profondeur mise à l'échelleNombreProfondeur approximative de la tête dans la scène, multipliée par l'échelle.

Evénements

facefound

Cet événement est émis par Face Effects lorsqu'un visage est trouvé pour la première fois.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée
transformerTransformObjectInformations sur la transformation de la face localisée.
sommets[{x, y, z}]Position des points du visage par rapport à la transformation.
normales[{x, y, z}]Direction normale des sommets, par rapport à la transformation.
points d'attachement{ nom, position : {x,y,z} }Voir XR8.FaceController.AttachmentPoints pour la liste des points d'attache disponibles. position est relative à la transformation.
uvsInCameraFrame[{u, v}]La liste des positions uv dans l'image de la caméra correspondant aux points de vertex renvoyés.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.facefound', (e) => {
console.log(e)
})

Faceloading

Cet événement est émis par Face Effects lorsque le chargement commence pour des ressources AR supplémentaires.

Propriétés

PropriétéTypeDescription
maxDetectionsNombreNombre maximal de visages pouvant être traités simultanément.
pointsParDetectionNombreNombre de sommets qui seront extraits par face.
indices[{a, b, c}]Index dans le tableau des sommets qui forment les triangles du maillage demandé, comme spécifié avec meshGeometry on configure.
uvs[{u, v}]les positions uv dans une carte de texture correspondant aux points de vertex renvoyés.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.faceloading', (e) => {
console.log(e)
})

facelost

Cet événement est émis par Face Effects lorsqu'un visage n'est plus suivi.

Propriétés

PropriétéTypeDescription
idNombreIdentifiant numérique de la face perdue.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.facelost', (e) => {
console.log(e)
})

numérisation des visages

Cet événement est émis par Face Effects lorsque toutes les ressources AR du visage ont été chargées et que le balayage a commencé.

Propriétés

PropriétéTypeDescription
maxDetectionsNombreNombre maximal de visages pouvant être traités simultanément.
pointsParDetectionNombreNombre de sommets qui seront extraits par face.
indices[{a, b, c}]Index dans le tableau des sommets qui forment les triangles du maillage demandé, comme spécifié avec meshGeometry on configure.
uvs[{u, v}]les positions uv dans une carte de texture correspondant aux points de vertex renvoyés.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.facescanning', (e) => {
console.log(e)
})

faceupdated

Cet événement est émis par Face Effects lorsque des visages sont trouvés par la suite.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée
transformerTransformObjectInformations sur la transformation de la face localisée.
sommets[{x, y, z}]Position des points du visage par rapport à la transformation.
normales[{x, y, z}]Direction normale des sommets, par rapport à la transformation.
points d'attachement{ nom, position : {x,y,z} }Voir XR8.FaceController.AttachmentPoints pour la liste des points d'attache disponibles. position est relative à la transformation.
uvsInCameraFrame[{u, v}]La liste des positions uv dans l'image de la caméra correspondant aux points de vertex renvoyés.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.faceupdated', (e) => {
console.log(e)
})

a clignoté

Cet événement est émis par Face Effects lorsque les yeux d'un visage suivi clignotent.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.blinked', (e) => {
console.log(e)
})

distance interpupillaire

Cet événement est émis par Face Effects lorsque la distance en millimètres entre les centres de chaque pupille d'un visage suivi est détectée pour la première fois.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée.
distance interpupillaireNombreDistance approximative en millimètres entre les centres de chaque pupille.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.interpupillarydistance', (e) => {
console.log(e)
})

lefteyebrowlowered

Cet événement est émis par Face Effects lorsque la distance en millimètres entre les centres de chaque pupille d'un visage suivi est détectée pour la première fois.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.lefteyebrowlowered', (e) => {
console.log(e)
})

lefteyebrowraised

Cet événement est émis par Face Effects lorsque le sourcil gauche d'un visage suivi est relevé par rapport à sa position initiale lorsque le visage a été trouvé.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.lefteyebrowraised', (e) => {
console.log(e)
})

lefteyeclosed

Cet événement est émis par Face Effects lorsque l'œil gauche d'un visage suivi se ferme.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.lefteyeclosed', (e) => {
console.log(e)
})

lefteye a ouvert

Cet événement est émis par Face Effects lorsque l'œil gauche d'un visage suivi s'ouvre.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.lefteyeopened', (e) => {
console.log(e)
})

lefteyewinked

Cet événement est émis par Face Effects lorsque l'œil gauche d'un visage suivi se ferme et s'ouvre dans un délai de 750 ms alors que l'œil droit reste ouvert.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.lefteyewinked', (e) => {
console.log(e)
})

bouche divulguée

Cet événement est émis par Face Effects lorsque la bouche d'un visage suivi se ferme.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.mouthclosed', (e) => {
console.log(e)
})

embouchure ouverte

Cet événement est émis par Face Effects lorsque la bouche d'un visage suivi s'ouvre.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.mouthopened', (e) => {
console.log(e)
})

righteyebrowlowered

Cet événement est émis par Face Effects lorsque le sourcil droit d'un visage suivi est abaissé à sa position initiale lorsque le visage a été trouvé.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.righteyebrowlowered', (e) => {
console.log(e)
})

righteyebrowraised

Cet événement est émis par Face Effects lorsque le sourcil droit d'un visage suivi est relevé par rapport à sa position initiale lorsque le visage a été trouvé.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.righteyebrowraised', (e) => {
console.log(e)
})

righteyeclosed

Cet événement est émis par Face Effects lorsque l'œil droit d'un visage suivi se ferme.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.righteyeclosed', (e) => {
console.log(e)
})

righteyeopened

Cet événement est émis par Face Effects lorsque l'œil droit d'un visage suivi s'ouvre.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.righteyeopened', (e) => {
console.log(e)
})

righteyewinked

Cet événement est émis par Face Effects lorsque l'œil droit d'un visage suivi se ferme et s'ouvre dans un délai de 750 ms alors que l'œil gauche reste ouvert.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.righteyewinked', (e) => {
console.log(e)
})

earpointfound

Cet événement est émis par Face Effects lorsqu'un point d'oreille est trouvé.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée
pointChaîneNom du point d'oreille. L'un des éléments suivants : Lobe gauche, Canal gauche, Hélix gauche, Lobe droit, Canal droit, Hélix droit.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.earpointfound', (e) => {
console.log(e)
})

earpointlost

Cet événement est émis par Face Effects lorsqu'un point d'oreille est perdu.

Propriétés

PropriétéTypeDescription
idNombreUn identifiant numérique de la face localisée
pointChaîneNom du point d'oreille. L'un des éléments suivants : Lobe gauche, Canal gauche, Hélix gauche, Lobe droit, Canal droit, Hélix droit.

Exemple

world.events.addListener(world.events.globalId, 'facecontroller.earpointlost', (e) => {
console.log(e)
})