Face State Analysis

Face State analysis provides additional information about detected faces, for example:

Configuration Parameter Description
Input The track that you want to process.
NumParallel The maximum number of video frames to analyze simultaneously.
SegmentDuration The maximum duration of a record in the SegmentedResult or SegmentedResultWithSource track.
Type The analysis engine to use. Set this parameter to FaceState.

Output Tracks

Output track Type Description Output1This column indicates whether the information contained in the track is included by default in the output created by an output task (when you don't set the Input parameter for the output task).
Data FaceStateResult Contains one record, describing the analysis results, for each input record. No
DataWithSource FaceStateResultAndImage The same as the Data track, but each record also includes the source frame. No
Result FaceStateResult Contains one record, describing the analysis results, for each detected face. Yes
ResultWithSource FaceStateResultAndImage The same as the Result track, but each record also includes the best source frame. No
SegmentedResult FaceStateResult (Available only when processing video). Contains one or more records, describing the analysis results, for each detected face. The maximum duration of records in this track is limited by the parameter SegmentDuration, so multiple records are created with the same ID when a face remains in the scene for longer than this duration. Yes
SegmentedResultWithSource FaceStateResultAndImage (Available only when processing video). The same as the SegmentedResult track, but each record also includes the best source frame. No

FaceStateResult

Field name Type Description
id UUIDData A universally unique identifier to identify the face
face FaceData Information about the detected face
expression String A string describing the facial expression (Happy or Neutral)
eyesopen Boolean Indicates whether the person's eyes are open (true or false or unknown)
spectacles Boolean Indicates whether the person is wearing spectacles (true or false or unknown)

FaceStateResultAndImage

The same as FaceStateResult records, with the following additional fields.

Field name Type Description
image ImageData The source frame

_FT_HTML5_bannerTitle.htm