liveList: Get live broadcast list
liveList: Get live broadcast list
Function details
Get the live broadcast details list created under the developer's current account, including the live broadcast address, live broadcast status, and live broadcast schedule.
Note: You need to create a live broadcast address through [bindDeviceLive] (bindDeviceLive.md) first, otherwise the live broadcast information cannot be obtained.
Request address
https://openapi-[DataCenter].easy4ip.com/openapi/liveList
Incoming parameter description
| Parameter name | Parameter type | Required or not | Default value | Legal value | Parameter description |
|---|---|---|---|---|---|
| token | String | Yes | Administrator accessToken | ||
| queryRange | String | 是 | Query Range The number value range is: [1, N] (N is a positive integer, and N>1); the difference range is: [0,99] |
Sample input
{
"system":{
"ver":"1.0",
"appId":"lcdxxxxxxxxx",
"sign":"cb9c12cc9c9a11e013afe6599ac1216f",
"time":1603367402,
"nonce":"10ba3958-b861-4284-acfe-28cf5f3955dd"
},
"id":"1cd43fdb-810b-44f4-8652-9d232dd95f1b",
"params":{
"token":"At_00000ad9e6e87f0142eb92e207aec46a",
"queryRange":"1-10"
}
}
Return data field description
| Field name | Field type | Field description | ||
|---|---|---|---|---|
| count | Integer | Current total number of extraction devices | ||
| lives | liveToken | String | Live token | |
| liveStatus | Integer | Live broadcast status (1: open; 2: pause; 3: insufficient traffic) | ||
| liveType | Integer | Type of live source (1: device; 2: stream address) | ||
| deviceId | String | [Optional] Device serial number | ||
| channelId | Integer | Channel number | ||
| coverUpdate | Integer | Video cover update frequency (unit: s) | ||
| streams | hls | String | Live stream hls access address | |
| coverUrl | String | Video cover url | ||
| streamId | Integer | Stream type (0: HD main stream; 1: SD secondary stream) (when the live broadcast address is generated by the rtsp source, this field is not available) | ||
| job | status | Boolean | Live broadcast plan status (true: on; false: off) | |
| period | String | Duty cycle | ||
| beginTime | String | Start time | ||
| endTime | String | End time | ||
Sample output
{
"result":{
"msg":"successful operation。",
"code":"0",
"data":{
"lives":[
{
"liveType":2,
"coverUpdate":90,
"streams":[
{
"coverUrl":"http://alhlscdn.lechange.com/LCO/3f35d2d41758dc707e614c2999f8b922/20190429155036/stream_20190429155036_71e53mz34pcaprgb.jpg",
"hls":"http://alhlsgw.lechange.com:9001/LCO/3f35d2d41758dc707e614c2999f8b922/20190429155036/stream_20190429155036_71e53mz34pcaprgb.m3u8"
}
],
"liveToken":"stream_20190429155036_71e53mz34pcaprgb",
"job":[
{
"period":"always",
"status":true
}
],
"liveStatus":1
},
{
"liveType":2,
"coverUpdate":90,
"streams":[
{
"coverUrl":"http://alhlscdn.lechange.com/LCO/aaf71e228f1da90232c0ac87803ce4b6/20191023171615/stream_20191023171615_qahzm4ml2bk93l72.jpg",
"hls":"http://alhlsgw.lechange.com:9001/LCO/aaf71e228f1da90232c0ac87803ce4b6/20191023171615/stream_20191023171615_qahzm4ml2bk93l72.m3u8"
}
],
"liveToken":"stream_20191023171615_qahzm4ml2bk93l72",
"job":[
{
"period":"always",
"status":true
}
],
"liveStatus":1
},
{
"liveType":1,
"coverUpdate":90,
"streams":[
{
"coverUrl":"http://livecloudpic.lechange.com/LCO/TESTQWERXXXX/0/0/20200907T032254/dev_TESTQWERXXXX_20200907T032254.jpg",
"streamId":0,
"hls":"https://cmgw-vpc.lechange.com:8890/LCO/TESTQWERXXXX/0/0/20200907T032254/dev_TESTQWERXXXX_20200907T032254.m3u8?proto=https"
},
{
"coverUrl":"http://livecloudpic.lechange.com/LCO/TESTQWERXXXX/0/0/20200907T032254/dev_TESTQWERXXXX_20200907T032254.jpg",
"streamId":1,
"hls":"https://cmgw-vpc.lechange.com:8890/LCO/TESTQWERXXXX/0/1/20200907T032254/dev_TESTQWERXXXX_20200907T032254.m3u8?proto=https"
},
{
"coverUrl":"http://livecloudpic.lechange.com/LCO/TESTQWERXXXX/0/0/20200907T032254/dev_TESTQWERXXXX_20200907T032254.jpg",
"streamId":0,
"hls":"http://cmgw-vpc.lechange.com:8888/LCO/TESTQWERXXXX/0/0/20200907T032254/dev_TESTQWERXXXX_20200907T032254.m3u8"
},
{
"coverUrl":"http://livecloudpic.lechange.com/LCO/TESTQWERXXXX/0/0/20200907T032254/dev_TESTQWERXXXX_20200907T032254.jpg",
"streamId":1,
"hls":"http://cmgw-vpc.lechange.com:8888/LCO/TESTQWERXXXX/0/1/20200907T032254/dev_TESTQWERXXXX_20200907T032254.m3u8"
}
],
"liveToken":"63813c4aa4b442069748437c1bd0b749",
"job":[
{
"period":"always",
"status":true
}
],
"deviceId":"TESTQWERXXXX",
"liveStatus":1,
"channelId":"0"
},
{
"liveType":1,
"coverUpdate":90,
"streams":[
{
"coverUrl":"http://livecloudpic.lechange.com/LCO/TESTQWERXXXX/0/1/20201022T113914/dev_TESTQWERXXXX_20201022T113914.jpg",
"streamId":1,
"hls":"http://cmgw-vpc.lechange.com:8888/LCO/TESTQWERXXXX/0/1/20201022T113914/dev_TESTQWERXXXX_20201022T113914.m3u8"
},
{
"coverUrl":"http://livecloudpic.lechange.com/LCO/TESTQWERXXXX/0/1/20201022T113914/dev_TESTQWERXXXX_20201022T113914.jpg",
"streamId":0,
"hls":"http://cmgw-vpc.lechange.com:8888/LCO/TESTQWERXXXX/0/0/20201022T113914/dev_TESTQWERXXXX_20201022T113914.m3u8"
},
{
"coverUrl":"http://livecloudpic.lechange.com/LCO/TESTQWERXXXX/0/1/20201022T113914/dev_TESTQWERXXXX_20201022T113914.jpg",
"streamId":1,
"hls":"https://cmgw-vpc.lechange.com:8890/LCO/TESTQWERXXXX/0/1/20201022T113914/dev_TESTQWERXXXX_20201022T113914.m3u8?proto=https"
},
{
"coverUrl":"http://livecloudpic.lechange.com/LCO/TESTQWERXXXX/0/1/20201022T113914/dev_TESTQWERXXXX_20201022T113914.jpg",
"streamId":0,
"hls":"https://cmgw-vpc.lechange.com:8890/LCO/TESTQWERXXXX/0/0/20201022T113914/dev_TESTQWERXXXX_20201022T113914.m3u8?proto=https"
}
],
"liveToken":"57877dd6774f4cbeb657568be0b7a621",
"job":[
{
"period":"always",
"status":true
}
],
"deviceId":"TESTQWERXXXX",
"liveStatus":1,
"channelId":"0"
}
],
"count":4
}
},
"id":"1cd43fdb-810b-44f4-8652-9d232dd95f1b"
}