接口行为

你可以使用 GetWebRecordTask 接口，查询某指定录制任务的任务状态。

调用接口
请求方式

使用 GET 方式发起请求。

请求参数

Query

参数名类型必填示例值描述
ActionString是GetWebRecordTask接口名称，本接口取值：GetWebRecordTask
VersionString是2020-12-01接口版本，本接口取值：2020-12-01
AppIdstring是Your_AppId应用的唯一标志。
TaskIdstring是Your_TaskId任务 ID，是任务的唯一标志。
返回参数
EventData
参数名类型示例值描述
CreateTimeInteger1629183877用户录制发起时间戳，unix 时间，单位为秒。
FinishTimeInteger1629573877用户录制结束时间戳，unix 时间，单位为秒。
TaskIdstringYour_TaskId任务 ID，是任务的唯一标志。
StatusInteger1任务状态：
1：启动中
2：运行中
3：任务失败
4：任务成功
Vidstringxxxxvvv文件在点播平台的唯一标识。你可以根据 vid 在点播平台上找到对应的文件。
FinalFileFile{"Bucket":"Your\_Bucket","ObjectKey":"1.mp4"}所有切片文件拼接而成的最终文件。
Files[]File[{"Bucket":"Your\_Bucket","ObjectKey":"1\_00001.mp4"} ,{"Bucket":"Your\_Bucket","ObjectKey":"1\_00002.mp4"}]切片文件列表
请求示例代码

请求路径：

https://rtc.volcengineapi.com?Action=GetWebRecordTask&Version=2020-12-01&AppId=Your_AppId&TaskId=Your_TaskId

postscript
返回调用结果
正常返回示例
{
    "ResponseMetadata": {
        "Service": "rtc",
        "Action": "GetWebRecordTask",
        "Version": "2020-12-01",
        "Region": "cn-north-1",
        "RequestId": "Your_RequestId"
    },
    "Result": {
        "Message": "success",
        "EventData": {
            "TaskId": "test-long-t4",
            "Status": 4,
            "Vid": "xxxxvvv",
            "FinalFile": {
                "Bucket": "cloud-record-test-2",
                "ObjectKey": "test-long-t4.mp4"
            },
            "Files": [
                {
                    "Bucket": "cloud-record-test-2",
                    "ObjectKey": "test-long-t4_000001.ts",
                    "Index": 1
                },
                {
                    "Bucket": "cloud-record-test-2",
                    "ObjectKey": "test-long-t4_000002.ts",
                    "Index": 2
                },
                {
                    "Bucket": "cloud-record-test-2",
                    "ObjectKey": "test-long-t4_000003.ts",
                    "Index": 3
                }
            ],
            "CreateTime": 1650613147,
            "FinishTime": 1650656784
        }
    }
}

json