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

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

1、功能介绍

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

2、请求参数

参数

是否必选

参数类型

描述

ActionStringStartDeviceVodStream

DeviceId

String

设备ID

StartTimeString开始时间,格式如:yyyy-MM-ddTHH:mm:ssZ,UTC时间
EndTimeString结束时间,格式如:yyyy-MM-ddTHH:mm:ssZ,UTC时间
PlayProtocolString

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

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

3、响应参数

参数

是否必选

参数类型

描述

RequestId

String

该条接口请求ID

CodeString错误码 0:表示成功
MessageString提示信息
Dataobject返回数据
├─DeviceIdString设备ID
├─AppNameString应用名称
├─StreamNameString流名称
├─HlsUrlStringhls播放地址(请求参数play_protocol设置了hls)
├─HttpFlvUrlStringhttp flv播放地址(请求参数play_protocol设置flv方式)
├─RtmpUrlStringrtmp播放地址(请求参数play_protocol设置rtmp方式)
├─Mp4UrlStringmp4播放地址(请求参数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"
	}
}