Inserts a new, empty, face into a database of faces.
Note: After adding a new face, you must add images of the face using the action AddFaceImages. You must train Media Server to recognize the face using the action BuildFace.
Note: This is an administrative action that can be sent only from AdminClients (which are set in the [Server]
section of the configuration file).
Type: synchronous
Parameter | Description | Required |
---|---|---|
database
|
The name of the database to add the face to. The database must already exist. | Yes |
identifier
|
A unique identifier for the face (maximum 254 bytes). If you do not set this parameter, Media Server generates an identifier automatically. | No |
The following example adds a face to the politicians
database:
/action=NewFace&database=politicians
You can use the person's name as the identifier, but all identifiers must be unique within the database:
/action=NewFace&database=politicians&identifier=JohnSmith
The action returns the identifier assigned to the face:
<autnresponse> <action>NEWFACE</action> <response>SUCCESS</response> <responsedata> <identifier>6600dc0f9dd72d0cb55589e8f1d28b62</identifier> </responsedata> </autnresponse>
|