最近更新时间：2022-09-07
请求实时视频，获取播放URL；
获取URL后尽快请求播放视频（建议1分钟以内），否则流无人使用，系统会超时自动关闭流，释放流占用的系统资源。
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 系统指定参数。取值：StartLiveStream |
DeviceId | 是 | String | 设备ID |
| PlayProtocol | 否 | String | 播放协议，多值用逗号分隔。取值：rtmp,flv,hls,mp4。默认hls |
| PrivateFlag | 否 | Integer | 是否内网地址。取值：0（否），1（是）。默认值为0 |
| TlsFlag | 否 | Integer | 是否使用TLS URL，仅对flv,hls,mp4有效，对PrivateFlag为1无效。取值：0:不使用，1:使用。默认1 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
RequestId | 是 | String | 该条接口请求ID |
| Code | 是 | String | 错误码 0:表示成功 |
| Data | 否 | Object | 返回数据 |
---DeviceId | 是 | String | 设备ID |
| ---AppName | 是 | String | 应用名称 |
| ---StreamName | 是 | String | 流名称 |
| ---RtmpUrl | 否 | String | rtmp播放地址（请求参数play_protocol设置rtmp方式） |
| ---HttpFlvUrl | 否 | String | http flv播放地址（请求参数play_protocol设置flv方式） |
| ---HlsUrl | 否 | String | hls播放地址（请求参数play_protocol设置了hls） |
| ---Mp4Url | 否 | String | mp4播放地址（请求参数play_protocol设置了mp4） |
请求示例:
GET https://api.unicloud.com/univms?
Action=StartLiveStream
&DeviceID=gb763487hfdk8a
&PlayProtocol=flv
&公共请求参数
返回示例:
{
"Data": {
"DeviceId": "2c48c26baf6641d793db324def578c29",
"HttpFlvUrl": "https://c22g1005.ply.univms.unicloudcdn.com.cn:10443/10001/0e71fcb957114755b720440008b0fb45/2c48c26baf6641d793db324def578c29.flv?group_id=0e71fcb957114755b720440008b0fb45"
},
"RequestId": "62165ca9-0ee9-44cb-a7dc-aa0c0e07bbf8",
"Code": "0"
} |
5、状态码
状态码 | 描述 |
|---|---|
200 | OK |
400 | Bad Request |
