Face Detection

Face Detection detects faces in media. After detecting faces you can send the information to other tasks to perform further analysis, such as face recognition.

Configuration Parameter Description
ColorAnalysis Whether to perform color analysis on detected faces to reduce false detections.
DetectionThreshold The minimum confidence score required to detect a face.
DetectTilted Whether to detect faces that are tilted to either side when facing the camera.
FaceDirection Face views to restrict detection to.
Input The image track to process.
MaxInputQueueLength Can be used to place a limit on latency.
MinSize The minimum size of a face.
NumParallel The maximum number of video frames to analyze simultaneously.
Orientation The orientation of faces in the video.
Region A region of the frame to restrict processing to.
SampleInterval The interval at which frames are selected to be analyzed.
SegmentDuration The maximum duration of a record in the SegmentedResult or SegmentedResultWithSource track. (Available only when processing video).
Type The analysis engine to use. Set this parameter to FaceDetect.

Output Tracks

Output track Description Output1
AlignedImageResult Contains one record for each detected face. The records in this track include the identifier of the detected face and an image. The image is rotated so that the face is upright and is cropped around the person's head. You can pass this track to an image encoder to produce images of the detected faces. No
Data Contains one record, describing the analysis results, per detected face, per video frame. No
DataWithSource The same as the Data track, but each record also includes the source frame. This information can be passed to other analysis engines to run tasks such as face recognition or demographic analysis. No
Result Contains one record, describing the analysis results, for each detected face. When the same face appears in many consecutive frames, Media Server produces a single result. Yes
ResultWithSource

The same as the Result track, but each record also includes the best source frame.

No
SegmentedResult

(Available only when processing video). The same as the Result track, except the duration of each record is limited by the parameter SegmentDuration. If a result exceeds the specified duration, Media Server begins a new record with the same ID.

Yes
SegmentedResultWithSource

(Available only when processing video). The same as the ResultWithSource track, except the duration of each record is limited by the parameter SegmentDuration. If a result exceeds the specified duration, Media Server begins a new record with the same ID.

No
Start

The same as the Data track, except it contains only the first record of each event.

No
End

The same as the Data track, except it contains only the last record of each event.

No

For more information see Face Detection Results or use the action GetExampleRecord.