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>