查询云端录制任务
更新时间：2025-05-07
接口描述
录制任务有效期内，可以通过调用查询录制任务接口来查询录制状态，和生成的录制文件列表。
请求（Request）
请求URI
JSON
1GET /v1/cloudrecording/{appId}/{taskId}/query HTTP/1.1| 参数名 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| appId | String | 是 | 应用ID |
| taskId | String | 是 | 录制任务ID |
请求头域
除公共头域外，无其它特殊头域。
请求体
无
响应（Response）
响应头域
除公共头域外，无其它特殊头域。
响应体
| 字段名 | 类型 | 描述 |
|---|---|---|
| appId | String | 应用ID |
| taskId | String | 录制任务ID |
| status | String | 任务状态。 STARTED：录制已开启，但是可能用户没有推流所以未进行； IN_PROGRESS：录制任务进行中； STOPPED：录制已停止。 |
| createdTime | Long | 任务创建时间，为毫秒级别 Unix 时间戳 |
| stopTime | Long | 任务停止时间，为毫秒级别 Unix 时间戳 |
| expiredTime | Long | 任务过期时间，为毫秒级别 Unix 时间戳 |
| fileList | List | 录制任务生成的文件列表。 需要注意的是，此接口查询录制文件列表并不是实时的，可能有1分钟左右的延时。 此外，此接口最多查询 1000 个文件，需要注意文件切割时间和录制任务持续时间，避免生成录制文件数目超过1000。 |
| +startTs | Long | 录制文件开始时间，为毫秒级别 Unix 时间戳 |
| +endTs | Long | 录制文件结束时间，为毫秒级别 Unix 时间戳 |
| +fileUrl | String | 文件下载 url。 需要注意的是，文件下载 url，目前仅适配百度智能云对象存储 BOS，并且不包含 url 鉴权等信息。 |
示例
请求示例
JSON
1GET /v1/cloudrecording/testapp/testTaskId/query HTTP/1.1
2host: rtc.baidubce.com
3content-type: application/json
4authorization: {bce-authorization-string}
5x-bce-request-id: {bce-request-id}响应示例
JSON
1HTTP/1.1 200 OK
2x-bce-request-id: b06a9214-04d6-4a08-9f5d-966b04604cfb
3date: Mon, 05 Sep 2022 03:25:43 GMT
4transfer-encoding: chunked
5content-type: application/json;charset=UTF-8
6cache-control: no-cache
7{
8 "appId": "testapp",
9 "taskId": "testTaskId",
10 "status": "STOPPED",
11 "createdTime": 1717401011497,
12 "stopTime": 1717401169080,
13 "expiredTime": 1717404611497,
14 "fileList": [
15 {
16 "startTs": 1717401015000,
17 "endTs": 1717401077000,
18 "fileUrl": "https://***/***/***"
19 },
20 {
21 "startTs": 1717401076000,
22 "endTs": 1717401134000,
23 "fileUrl": "https://***/***/***"
24 }
25 ]
26}