根据序列号获取直播地址和直播状态
# getLiveStreamInfo:查询设备通道下创建的直播信息
# 功能详情
根据设备序列号和通道号获取直播地址和直播状态。
备注:
需先通过bindDeviceLive创建直播地址,否则无法获取直播信息。
可以获取到高清主码流、标清辅码流、HTTP、HTTPS 四类直播地址。
# 请求地址
https://openapi.lechange.cn/openapi/getLiveStreamInfo
# 传入参数说明
参数名 | 参数类型 | 是否必填 | 默认值 | 合法值 | 参数说明 |
---|---|---|---|---|---|
token | String | 是 | 管理员 accessToken | ||
deviceId | String | 是 | 设备序列号 | ||
channelId | String | 是 | 通道号 |
# 样例输入
{
"system": {
"ver": "1.0",
"appId": "lcdxxxxxxxxx",
"sign": "469e57e01dcbd786f961d79bc231dd52",
"time": 1603366946,
"nonce": "2e84717c-0f22-4424-8afe-19bab0d6d606"
},
"id": "051824b1-9655-4755-9cc2-adcc9ab5fef1",
"params": {
"deviceId": "XXXXX000000XXXX",
"channelId": "0",
"token": "At_00000ad9e6e87f0142eb92e207aexxxx"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 返回 data 字段说明
字段名 | 字段类型 | 字段说明 | |
---|---|---|---|
liveType | Integer | 直播源类型,1:设备 | |
coverUpdate | Integer | 视频封面更新频率(单位:s) | |
streams | hls | String | 直播流hls访问地址 |
streamId | Integer | 码流类型(0:高清主码流;1:标清辅码流) | |
status | String | 状态,0:正在直播中,1:正在直播中,但是视频封面异常,2:视频源异常,3:码流转换异常,4:云存储访问异常,10:直播暂停中 | |
liveToken | String | 直播token,设备通道直播的唯一标识 | |
coverUrl | String | 视频封面url | |
job | status | Boolean | 直播计划状态(true:开;false:关) |
period | String | 直播计划周期,通过modifyLivePlan或batchModifyLivePlan进行设置 | |
beginTime | String | 直播计划开始时间,通过modifyLivePlan或batchModifyLivePlan进行设置 | |
endTime | String | 直播计划结束时间,通过modifyLivePlan或batchModifyLivePlan进行设置 |
# 样例输出
{
"result": {
"msg": "操作成功。",
"code": "0",
"data": {
"liveType": 1,
"coverUpdate": 90,
"streams": [
{
"streamId": 1,
"liveToken": "57877dd6774f4cbeb657568bxxxxxxx",
"hls": "http://cmgw-vpc.lechange.com:8888/LCO/XXXXX000000XXXX/0/1/20201022T113914/dev_TESTQWERXXXX_20201022T113914.m3u8",
"status": "0",
"coverUrl": "http://livecloudpic.lechange.cn/LCO/XXXXX000000XXXX/0/0/20230621T062525/XXXXXXXXXXXXXXXXXXX.jpg"
},
{
"streamId": 0,
"liveToken": "57877dd6774f4cbeb657568bxxxxxxx",
"hls": "http://cmgw-vpc.lechange.com:8888/LCO/XXXXX000000XXXX/0/0/20201022T113914/dev_TESTQWERXXXX_20201022T113914.m3u8",
"status": "0",
"coverUrl": "http://livecloudpic.lechange.cn/LCO/XXXXX000000XXXX/0/0/20230621T062525/XXXXXXXXXXXXXXXXXXX.jpg"
},
{
"streamId": 1,
"liveToken": "57877dd6774f4cbeb657568bxxxxxxx",
"hls": "https://cmgw-vpc.lechange.com:8890/LCO/XXXXX000000XXXX/0/1/20201022T113914/dev_TESTQWERXXXX_20201022T113914.m3u8?proto=https",
"status": "0",
"coverUrl": "http://livecloudpic.lechange.cn/LCO/XXXXX000000XXXX/0/0/20230621T062525/XXXXXXXXXXXXXXXXXXX.jpg"
},
{
"streamId": 0,
"liveToken": "57877dd6774f4cbeb657568bxxxxxxx",
"hls": "https://cmgw-vpc.lechange.com:8890/LCO/XXXXX000000XXXX/0/0/20201022T113914/dev_TESTQWERXXXX_20201022T113914.m3u8?proto=https",
"status": "0",
"coverUrl": "http://livecloudpic.lechange.cn/LCO/XXXXX000000XXXX/0/0/20230621T062525/XXXXXXXXXXXXXXXXXXX.jpg"
}
],
"job": [
{
"period": "monday,tuesday",
"beginTime": "10:00:00",
"endTime": "23:59:00",
"status": true
},
{
"period": "friday,saturday",
"beginTime": "12:00:00",
"endTime": "23:59:00",
"status": true
}
]
}
},
"id": "051824b1-9655-4755-9cc2-adcc9ab5fef1"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55