32 lines
1.8 KiB
Markdown
32 lines
1.8 KiB
Markdown
|
---
|
||
|
|
uid: arfoundation-face-manager
|
||
|
|
---
|
||
|
|
# AR face manager
|
||
|
|
|
||
|
|
The face manager is a type of [trackable manager](trackable-managers.md).
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
The face manager creates `GameObject`s for each face detected in the environment. The system only detects human faces.
|
||
|
|
|
||
|
|
In some implementations, face tracking requires a different camera (for example, front-facing vs. rear-facing) and might be incompatible with other features, such as plane or image tracking. Consider disabling other AR managers which manage trackables. These include:
|
||
|
|
|
||
|
|
* [Plane tracking](plane-manager.md)
|
||
|
|
* [Image tracking](tracked-image-manager.md)
|
||
|
|
* [Object tracking](tracked-object-manager.md)
|
||
|
|
* [Environment probes](environment-probe-manager.md)
|
||
|
|
|
||
|
|
## Responding to faces
|
||
|
|
|
||
|
|
Faces can be added, updated, and removed. Once per frame, if the application detects a face, the AR face manager invokes the `facesChanged` event. This event contains three `List`s of faces that have been added, updated, and removed since the last frame.
|
||
|
|
|
||
|
|
When a face is detected, the AR face manager instantiates the Face Prefab to represent the face. The Face Prefab can be left `null`, but the face manager ensures the instantiated `GameObject` has an `ARFace` component on it. The `ARFace` component only contains data about the detected face.
|
||
|
|
|
||
|
|
## Visualizing faces
|
||
|
|
|
||
|
|
The face provider might provide a mesh that represents the face. The `ARFace` component exposes `vertices`, `normals`, `indices`, and `uvs` (texture coordinates). Some or all of these can be available.
|
||
|
|
|
||
|
|
The `ARFaceMeshVisualizer` component generates a `UnityEngine.Mesh` and updates the `MeshFilter` on the same `GameObject` based on the data that the `ARFace` provides.
|
||
|
|
|
||
|
|
Check the face subsystem's `SubsystemDescriptor` (`ARFaceManager.descriptor`) for provider-specific features.
|