|
⇤ ← Revision 1 as of 2011-01-06 07:06:41
Size: 1425
Comment:
|
← Revision 2 as of 2011-01-06 07:07:30 ⇥
Size: 1427
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 14: | Line 14: |
| i. If the .lck file exists, status {{{STARED}} is returned along with a reference to the unfinished media file if it has been created and an estimate of the completion percentage. | i. If the .lck file exists, status {{{STARTED}}} is returned along with a reference to the unfinished media file if it has been created and an estimate of the completion percentage. |
Broadcast Extraction Service (BES) API and usage
BES is a REST webservice with a single method which is called with a GET request like
http://iapetus:9311/bes/rest/bes/getobjectstatus?programpid=http://www.statsbiblioteket.dk/doms/shard/uuid:066d8172-7585-43bf-bf65-4aacb6a5f378
It responds as appropriate by
- Starting a new transcoding process for the requested broadcast,
- Reporting status information on an in-progress transcoding, or
- Returning a reference to a file created by a completed transcoding process.
For each shard-uuid requested, corresponding to a single TV or Radio broadcast, BES creates two files - a media file <uuid>.flv or <uuid>.mp3, and a lock file <uuid>.lck. On completion of transcoding, the .lck file is deleted. The status returned by BES is therefore determined as follows
If neither file exists, a new transcoding is started and the status STARTING is returned.
If the .lck file exists, status STARTED is returned along with a reference to the unfinished media file if it has been created and an estimate of the completion percentage.
If the media file exists but the .lck file does not exist, the status DONE is returned along with a reference to the media file.
On reload of the web-application, any .lck files are deleted along with their corresponding media files, thus cleaning up any partially completed transcodings.