Face Recognition Results

The following XML shows a single record produced by face recognition.

<record>
  ...
  <trackname>facerec.Result</trackname>
  <FaceRecognitionResult>
    <id>69ff21d8-bc3b-44b1-9a47-1eabedb75dd0</id>
    <face>
      ...
    </face>
    <identity>
      <identifier>A N Example</identifier>
      <database>politicians</database>
      <confidence>50.11</confidence>
    </identity>
  </FaceRecognitionResult>
</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 recognition 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 identity element contains information about the recognized face.

    • The identifier element provides the identifier of the database entry that matched the face.
    • The database element provides the name of the database in which the match was found.
    • The confidence element provides the confidence score for the match.

    The identity element can be empty when there are no matches that meet the recognition threshold. You can configure Media Server to output only recognized faces by setting OutputIdentities=Known.