Get Live Streaming Address

Last Updated on : 2021-12-29 06:08:50Copy for LLMView as MarkdownDownload PDF

Get the live streaming address by device ID and the video type. The available live streaming video protocols include RTSP and HLS.

API address

POST: /v1.0/devices/{device_id}/stream/actions/allocate

Request parameter

Parameter name	Type	IN	Required	Description
device_id	String	uri	true	The device ID.

Description of body

Parameter name	Type	IN	Required	Description
type	String	body	true	The available live streaming video protocols. Valid values: `RTSP` and `HLS`.

Return parameter

Parameter name	Type	Description
result	StreamVO	The returned result.

Description of result

Parameter name	Type	Description
url	String	The address of live streaming.

Request example

POST: /v1.0/users/ay156402688****voY5W/devices/6c08578d894****11afye1/stream/actions/allocate

{
  "type": "hls"
}

Return example

{
    "result": {
        "url": "https://wework1.****.com:554/hls/6c08578d89****411afye1/c146ioh525qd7j2l1590315x7E7xNu6PW3kXSfQL.m3u8?signInfo=PnwWBVmaoNSubTJ7Fb1cjsJNXZeuXn%2F2k2FFwNS6EuYlD5f3UtciKvNxIyYUHsKvODeI6nmDP3y51sWbXVfqbFu6q9PDNDG005cRkSWnfzA%2BxYuq1JMeJoJvWb8uJd5YNtMlbGcsQ81knGoMXCDtJC9fyY%2FPkEyXQyGntlHzVd0%3D"
    },
    "t": 1615358306701,
    "success": true
}

Error code

For more information, see error code.

Prev DocRequest RTSP/HLS Live Stream URL

Next DocGet Configs of Creating WebRTC Connection