developer documentation r17362
Media
Introduction
Media is lies at the heart of the Media Factory. This section describes how media is consumed, stored and transcoded.
The following diagram displays a high-level overview on the flow of intake of files:
Intake
New files are submitted to the Media Factory in a variety of ways. The most common one is by a straight HTTP upload to the upload api. Additionally it is possible to add video to the Media Factory through a flash-based webcam recorder, email or through our developer API (webservice). These files are referenced as 'originals'.
Filetypes
The Media Factory has 4 major categories for filetypes:
- Image
- Video
- Audio
- Text
These number associated to these filetypes are used in a lot of places, such as the Media components, widgets and API's.
Transcoding process
After a file is uploaded, it is not instantly ready for usage. Every media-file with the exception of text-files are placed in a transcoder queue. Depending on the size and type of the file and how busy the transcoder is, it can take from a second up to a few minutes for files to be ready. A file's status is indicated by a status number.
| Status code | Name | Description |
|---|---|---|
| 0 | Uploading | Uploading means the file is currently being uploaded, or processed right after uploading. In most cases this status is never seen, as it is only set to uploader for a split setting. Occasionally files that are cancelled or failed during uploading will stay on this status. |
| 1 | Queue | When a file is set to status 1, it means it is currently queued for transcoding. |
| 2 | Converting | The file is being transcoded as you're looking at it. |
| 3 | Converted | The file is transcoded, and ready to be used. |
| 4 | Failed | Sometimes a file could not be transcoded, because we don't support the format or we couldn't recognize what format the file was in. In these cases the statuscode '4' will be assigned. |