Setting up Live Stream Configurations

The first step towards enabling live encoding under yospaceCDS is to set-up a Live Stream Configuration.  You define which Profile that you want, and supply parameters specific to that Profile. A Profile is designed with a specific use case in mind, and generally involves taking a live feed under a specific protocol (such as RTMP, MMS or RTSP), encoding it into one or more different formats, frame sizes, and bit-rates and pushing these streams out to different CDN publish points.

If what you require doesn't appear on our list of registered Live Stream Profiles, you can request a new profile tailored to your needs from Yospace Support.

Invocation

http://lsm.cds1.yospace.com/lsm/create?profile=p&name=n&[&param1=d1[&param2=d2..]]

Where:

  • p - is the name of the Profile under which the Live Stream Configuration is to be set-up.  The list of permitted Profile IDs is provided below.
  • n - is a name that you must supply to identify your stream.  If the Profile you have specified requires the Live Stream Manager to set-up CDN publish points, this name may be used during the set-up of these publish points.  You should consult the documentation on the Profile you are using on the use effects of this parameter. 
  • d1,d2.. - is a list of arbitrary additional parameters as required by the Profile you are instantiating. 

Returns

Calls return {"ID": xxxx, "ERRORS" : []} where xxx is the ID of the Live Stream Configuraiton that was created if the call was successful.  If the command was not successful, [] is an array of error strings. The following HTTP result codes also apply:

  • HTTP status 200: Command Successful
  • HTTP status 400: Invalid Request
  • HTTP status 401: Must Authenticate (basic authentication is required in HTTP headers)
  • HTTP status 500: Unexpected Error