KeepLatestRecords
Instructs Media Server to keep records generated by a processing session in memory, so that they can be retrieved using the action GetLatestRecords. These actions can be used by front-end applications to provide a preview of what Media Server has processed.
NOTE: Media Server only generates records in tracks that are used. For example, if you run face detection but do not use the face detection data track as the input for another task, Media Server does not generate records in that track.
NOTE: You should not use this action to retrieve results from Media Server. If you need to retrieve results through ACI, Media Server provides an ACI response output engine.
Type: synchronous
Parameter | Description | Required |
---|---|---|
Size
|
The number of records to keep in memory for each specified track. The default is a single record per track. | No |
Token
|
The session to keep records for. Specify the action token returned by the Process action. | Yes |
Tracks
|
A comma-separated list of tracks to keep records for. | Yes |
Example
The following example keeps five records for each of the specified tracks:
/action=KeepLatestRecords &Token=... &Tracks=FaceDetect.DataWithSource,ObjectRecognition.DataWithSource &Size=5
To change the selection, run the action again. For example, to stop keeping records from the ObjectRecognition
task, but still keep five records from the FaceDetect
task, specify the ObjectRecognition.DataWithSource
track and set the size
to zero:
/action=KeepLatestRecords &Token=...(same as before) &Tracks=ObjectRecognition.DataWithSource &Size=0
Response
<autnresponse> <action>KEEPLATESTRECORDS</action> <response>SUCCESS</response> <responsedata> </responsedata> </autnresponse>