RoscoLive API v1.0

start live streaming

GET/partners/live/{device_id}/{channel}

Starts a live streaming for a device. To save the cellular data plan of the device, the live streaming link must be open in 5s, and the m3au list needs to be refreshed every 5s, or it will be regarded as not playing and the connection will close and expire.

Channel can be 1, 2, 3, 4. Please check a device to see the available live streaming channels. If a channel is not available, it can not be played.

Once a link is opened and being played back, it will not stop itself as long as any player is playing it. So it is the developer's duty to set up automatic-stop mechanism, such as a timer, to stop a player that opens and opens too long.

Request

Path Params

device_id

integer

required

Device ID to live stream

>= 0

Example:

1234567890

channel

integer

required

channel to live stream. Channel must be active on device to live stream

>= 1<= 4

Example:

Body Params text/plain

Request samples

Responses

Success(200)

Forbidden(403)

HTTP Code: 200

Content Type : JSONapplication/json

meta

object

required

Request metadata object

code

integer

required

HTTP status code returned by server

response

object

required

Contains response data

result

string

required

"OK" if request successful, otherwise "Failed"

{
  "meta": {
    "code": 200
  },
  "response": {
    "modem_rssi": "-63",
    "token": "w3m3u86r.m3u8",
    "url": "https://fleet.roscolive.com:8080/live/3299582673/1/w3m3u86r.m3u8"
  },
  "result": "OK"
}

Last modified: 5 months ago