uploadMedia

Creates an acceptor which receives an HTTP POST binary upload. The acceptor will be opened on a specified port and the uploaded media file will be written on a specified directory. The acceptor then waits for an HTTP POST from a client with the media file as payload. The media file is then written on the specified location in the server.

This function has the following parameters:

The sending client must conform to the following:

• It must send the data by way of HTTP POST
• The POST request must be in http/1.1 format
• A StreamName must be provided in the POST line. This will then be the filename of the media file (mp4) when written. (e.g., POST /mystreamname HTTP/1.1\r\n)
• Content-type must be set to video/mp4 or application/octet-stream
• Content-length must be used. This function is intended for uploading VOD MP4 so the EMS will expect that the size of the file is already known

Example:

API Call:

uploadMedia port=3333 targetFolder=/MyMediaFolder

JSON Response:

{
"data":{
    "ip":"0.0.0.0",
    "port":3333,
    "targetFolder":"..\/media"
},
"description":"Media upload acceptor configuration.",
"status":"SUCCESS"
}

The JSON response contains the following details:

• data – The data to parse.
  • ip – The IP referring to the EMS, normally 0.0.0.0
  • port – The specified port number where the acceptor will wait for HTTP POSTs
  • targetFolder – The specified folder where the media file will be written
• description – Describes the result of parsing/executing the command
• status – SUCCES if the command was parsed and executed successfully, FAIL if not