GetLatestRecord
DEPRECATED: The GetLatestRecord
action is deprecated in Media Server 12.5.0 and later. Micro Focus recommends that you use the actions KeepLatestRecords and GetLatestRecords instead.
This action is still available for existing implementations, but it might be incompatible with new functionality. The action might be removed in future.
Retrieves the latest record that has been added to a track, or the latest records for all tracks.
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: This action only returns records from requests that have a status of processing
. Media Server does not return records from requests that have a status of finished
. You can use this action to confirm that Media Server is processing video correctly. 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 |
---|---|---|
Compress
|
A Boolean value (default true ) that specifies whether the action returns image data in compressed JPEG format, rather than PNG format. |
No |
Token
|
The asynchronous action token, returned by the process action, that specifies the processing request to return records from. If you do not set this parameter, Media Server returns records for all processing requests. |
No |
Tracks
|
A comma-separated list of tracks to return the latest records from. If you do not set this parameter, Media Server returns the latest record from each output track. To return the latest records from all tracks, set this parameter to an asterisk (* ). |
No |
Example
/action=GetLatestRecord &Token=... &Tracks=Keyframe.Result,OCR.Result
Response
A sample response appears below.
<autnresponse> <action>GETLATESTRECORD</action> <response>SUCCESS</response> <responsedata> <result> <session token="..."> <track name="Keyframe.Result" inUse="true"> <KeyFrameData> <id>392a3c2b-013f-440e-93e6-b3efb5088810</id> </KeyFrameData> </track> <track name="OCR.Result" inUse="true"> <OCRResult> <id>4e999dbf-b142-4624-a2e2-47ce5ccdf85a</id> <text>...</text> <region> <left>119</left> <top>501</top> <width>426</width> <height>24</height> </region> <confidence>97</confidence> </OCRResult> </track> </session> </result> </responsedata> </autnresponse>
If a track is not used, the inUse
attribute has a value of false
, and Media Server does not return any records for that track:
<track name="Keyframe.Result" inUse="false" />