Face Expression Analysis Results

The following XML shows a single record produced by face expression analysis.

<record>
  ...
  <trackname>FaceExpression.Result</trackname>
  <FaceStateResult>
    <id>ca444959-3609-4e06-a633-1bd95e7b3440</id>
    <face>
      ...
    </face>
    <expression>Neutral</expression>
    <eyesopen>true</eyesopen>
    <spectacles>false</spectacles>
  </FaceStateResult>
</record>

The record contains the following information:

  • The id element contains a unique identifier for the detected face. The face detection engine issues an ID for each detected appearance of a face, and the records output from the face state analysis engine use the same IDs as the input records.

  • The face element contains the location of the detected face. For more information about this data, see Face Detection Results.

  • The expression element describes the facial expression (Happy or Neutral).
  • The eyesopen element specifies whether the person's eyes are open (true) or closed (false). If the person has only one eye open (for example, if they are winking), Media Server reports that their eyes are open. The value might be unknown if the face is only partially visible or the person is not looking at the camera.
  • The spectacles element specifies whether the person is wearing spectacles. The possible results are true, false, or unknown. The value might be unknown if the face is only partially visible or the person is not looking at the camera.