获取实况预览播放地址

接口调用说明

请求地址 : /v1/api/device/video/get_realtime_url
请求方式 : POST

请求头

参数名	参数值	是否必须
Content-Type	application/json	是
X-Token	实际accessToken	是

请求报文体

名称	类型	是否必须	备注
deviceSn	String	是	设备序列号
channelId	int	是	视频通道号
streamId	int	是	码流 0<=streamId < streamCount(设备详情接口有返回) ； 0为主码流非0值为次码流
streamUUID	String	否	本次流ID , 长度限制42字符 , 不传或传空平台自动生成(该字段建议开发者自行设定,后面可根据streamUUID进行断流)
userIp	String	否	终端用户公网ip，用于就近选择策略
maxPlayDuration	number	否	拉流时长限定单位(s) 1<=maxPlayDuration<=2592000；服务端根据输入maxPlayDuration值会通知客户端进行断流操作，如客户端未主动断开，服务端会在maxPlayDuration值后延迟10s被动断开，具体可参考SDK错误码
extensions	String	否	协议拓展字段, 可以传递用户自定义参数, 长度限制300字符

//示例数据
{
    "deviceSn" : "**********",//设备序列号
    "channelId" : 0,//视频通道号
    "streamId":0,//码流 0<=streamId < streamCount(设备详情接口有返回) ； 0为主码流 非0值为次码流
    "streamUUID":"1234567890956789uytrewqwerty23",
    "userIp":"1.1.1.1",
    "maxPlayDuration": 120,
    "extensions":"e4e36ab460f24e64af6c13747794d094"
}

响应报文

名称	类型	是否必须	备注
code	int	是	状态码
msg	String	是	状态码解释信息
data	Object	否	返回内容(详情见下表)

data内容如下:

名称	类型	是否必须	备注
url	object	是	p2p连接列表(详情见下表)
jvmpUrl	String	是	直播转发地址，有效期180S，超时后无法拉流，需要重新获取播放地址
streamUUID	String	否	本次流ID , 长度限制42字符 , 不传或传空平台自动生成(该字段建议开发者自行设定,后面可根据streamUUID进行断流)

url内容如下:

名称	类型	是否必须	备注
token	object	是	会话token
addrs	String[]	是	P2P地址
deviceId	String	是	设备ID

//示例数据
{
    "code": 1000,
    "msg": "OK",
    "data": {
        "streamUUID":"1234567890956789uytrewqwerty23",
        "jvmpUrl": "jvmp://xxx.xx.xxx.xxx:7070/live/12421SXXXXXX?token=XXXXXXXXXXXXXXXXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXXXX",
        "url": {
            "token": "XXXXXXXXXXXXXXXXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXXXX",
            "deviceId": "**********",
            "addrs": ["p2p://xxx.xx.xxx.xxx:7050/index=0/node_type=1/addr_type=2"]
        }
    }
}

错误码

状态码	状态描述
1000	成功
1001	参数错误
1002	请求异常
1006	AccessToken异常
2002	设备不在线
2008	设备不存在
2009	视频通道号不合法
2017	通道未启用
4001	获取视频链接地址异常
4004	码流id不合法

获取实况预览播放地址

获取实况预览播放地址

results matching ""

No results matching ""