查询全景合流回放列表
更新时间:2023-02-07
接口描述
通过该接口可以分页获取全景回放列表信息
说明:直播结束后预计10-15分后可生成回放
请求地址
https://ccapi.csslcloud.net/openapi/recorder/replay_info
请求方式
GET
请求参数
接口统一权限认证请参考THQS认证方式。
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
roomid | String | 是 | 直播间ID |
account_id | String | 是 | 开发者账号 |
pagenum | Integer | 否 | 每页记录条数,默认50。取值范围:1~500之前的任意整数 |
pageindex | Integer | 否 | 第几页,默认1。取值范围:大于1的整数 |
starttime | String | 否 | 查询开始时间(按开始录制时间查询),如果填写该参数则endtime参数必填,示例:"2022-12-01 12:30" |
endtime | String | 否 | 查询结束时间(按开始录制时间查询),如果填写该参数则starttime参数必填,示例:"2022-12-02 12:30" |
liveid | String | 否 | 直播ID,填写该参数后只查询该直播下的回放 |
recordType | Integer | 否 | 回放类型,取值说明:1为普通回放,2为极速回放,默认为1,取值范围:[1,2] |
请求示例
GET https://ccapi.csslcloud.net/openapi/recorder/replay_info?account_id=6D758EEDBFD5FC873&roomid=F05392A0BC8E88F99C33DC5901307461&pagenum=50&pageindex=1&time=1669877322&hash={hash}
返回数据
公共返回数据结构请参考 公共返回数据说明。
名称 | 类型 | 描述 |
---|---|---|
count | Integer | 回放总条数 |
pageIndex | Integer | 页码 |
records | Array | 回放列表信息 |
records说明
名称 | 类型 | 描述 |
---|---|---|
id | String | 回放ID |
liveId | String | 直播ID |
startTime | String | 录制开始时间 |
stopTime | String | 录制结束时间 |
recordStatus | Integer | 录制状态:0为录制未结束,1为录制完成 |
fullViewReplayUrl | String | 全景回放地址,如果recordStatus返回0则该值返回空字符传("") |
sourceType | Integer | 回放来源:0为录制, 1为合并, 2为迁移, 3为上传 |
videoId | String | 视频ID |
返回示例
{
"result": "OK",
"data": {
"count": 1,
"records": [
{
"id": "66CDD51A0005C2F39C33DC5901307461",
"liveId": "26758CD5FD2E3AE79C33DC5901307461",
"startTime": "2022-12-01 13:30:04",
"stopTime": "2022-12-01 13:57:38",
"recordStatus": 1,
"fullViewReplayUrl": "https://class.csslcloud.net/flashback/index.html#/?roomid=F05392A0BC8E88F99C33DC5901307461&userid=6D758EEDBFD5FC87&liveid=26758CD5FD2E3AE79C33DC5901307461&recordid=66CDD51A0005C2F39C33DC5901307461",
"sourceType": 0,
"videoId":"26758CD5FD2E3AE79C33DC5901307461"
}
],
"pageIndex": 1
},
"errorMsg": ""
}