文档中心 > 启动设备录像回放视频流
启动设备录像回放视频流

最近更新时间:2022-08-31

1、功能介绍

请求设备端的录像回放视频,返回播放url。该接口适用于国标NVR设备、带TF卡的IPC设备。

2、请求参数

参数

是否必选

参数类型

描述

Action是StringStartDeviceVodStream

DeviceId

是

String

设备ID

StartTime是String开始时间,格式如:yyyy-MM-ddTHH:mm:ssZ,UTC时间
EndTime是String结束时间,格式如:yyyy-MM-ddTHH:mm:ssZ,UTC时间
PlayProtocol否String

播放协议,多值用逗号分隔。取值:rtmp,flv,hls,mp4。默认hls

PrivateFlag否Integer是否内网地址。取值:0(否),1(是)。默认值为0
TlsFlag否Integer是否使用TLS URL。取值:0:不使用,1:使用。默认1,对PrivateFlag为1无效

3、响应参数

参数

是否必选

参数类型

描述

RequestId

否

String

该条接口请求ID

Code是String错误码 0:表示成功
Message否String提示信息
Data否object返回数据
├─DeviceId否String设备ID
├─AppName是String应用名称
├─StreamName是String流名称
├─HlsUrl否Stringhls播放地址(请求参数play_protocol设置了hls)
├─HttpFlvUrl否Stringhttp flv播放地址(请求参数play_protocol设置flv方式)
├─RtmpUrl否Stringrtmp播放地址(请求参数play_protocol设置rtmp方式)
├─Mp4Url否Stringmp4播放地址(请求参数play_protocol设置了mp4)

4、示例

GET https://api.unicloud.com/univms?

Action=StartDeviceVodStream

&DeviceID=gb763487hfdk8a

&StartTime=2021-02-10T11:12:08

&EndTime=2021-02-10T22:12:08

&PlayProtocol=hls,flv,rtmp

&公共请求参数

返回示例:

{
	"RequestId": "b9de1a62-d09e-4d34-9a61-38f0f56564b6",
	"Code": "0",
	"Data": {
		"AppName": "live",
		"StreamName": "gb763487hfdk8a_20210510111208_20210510221208_8765",
		"RtmpUrl": "rtmp://112.3.6.10:1935/live/gb763487hfdk8a_20210510111208_20210510221208_8765?token=dbkwe98jhehbc",
		"HttpFlvUrl": "http://112.3.6.10:8080/live/gb763487hfdk8a_20210510111208_20210510221208_8765.flv?token=dbkwe98jhehbc",
		"HlsUrl": "http://112.3.6.10:8080/live/gb763487hfdk8a_20210510111208_20210510221208_8765/hls.m3u8?token=dbkwe98jhehbc"
	}
}