Trains Media Server to recognize any faces that exist in its database and have incomplete or out-of-date training (any faces that have one or more images with a status of untrained
). For example, you must re-train a face if you add new face images.
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: asynchronous
Parameter | Description | Required |
---|---|---|
database
|
The name of a database to process. Set this parameter to train Media Server to recognize faces in the specified database only. By default, this action trains Media Server to recognize faces in all databases. | No |
numparallel
|
The maximum number of threads that the action can use (default 1). | No |
/action=BuildAllFaces
/action=BuildAllFaces&numparallel=2
This action is asynchronous, so Media Server always returns success accompanied by a token:
<autnresponse> <action>BUILDALLFACES</action> <response>SUCCESS</response> <responsedata> <token>MTYuMjguOTQuMTcyOjE4MDAwOkJVSUxEQUxMRkFDRVM6MTQ0ODkwMjM3MDM4MjAxMTM1Mzg4MTc1</token> </responsedata> </autnresponse>
You can use this token with the QueueInfo action to retrieve the status of the action:
<autnresponse> <action>QUEUEINFO</action> <response>SUCCESS</response> <responsedata> <actions> <action> <status>Finished</status> <queued_time>2015-Nov-30 16:52:51</queued_time> <time_in_queue>0</time_in_queue> <process_start_time>2015-Nov-30 16:52:51</process_start_time> <time_processing>1</time_processing> <process_end_time>2015-Nov-30 16:52:52</process_end_time> <entry> <build> <image> <index>1</index> <label>expression_neutral</label> <status>trained</status> </image> </build> <database>politicians</database> <identifier>president</identifier> <numimages>1</numimages> <numtrained>1</numtrained> </entry> <token>MTYuMjguOTQuMTcyOjE4MDAwOkJVSUxEQUxMRkFDRVM6MTQ0ODkwMjM3MDM4MjAxMTM1Mzg4MTc1</token> </action> </actions> </responsedata> </autnresponse>
|