You need to enable JavaScript to run this app.
导航
查询录像
最近更新时间:2023.02.03 18:54:55首次发布时间:2023.02.03 18:54:55

根据录像任务 ID,查询指定录像任务的结果。

请求方式

使用 GET 方式发起请求。

请求参数

下表仅列出了接口特有的请求参数和部分公共参数。完整的公共参数列表,参考「公共参数」。

字段
位置
类型
必填
说明

Action

Query

String

公共参数,OpenAPI 接口名称

GetStreamRecord

Version

Query

String

公共参数,OpenAPI 接口版本

2021-01-01

RecordIDQueryString需要查询的录像任务 IDrecord0xxxx

返回结果

返回参数说明

通用返回参数,请参考 ResponseMetadata 结构体说明

Result 字段包含以下参数:

字段
类型
说明
IDString录制任务唯一 ID,凭借该 ID 可以停止录像、查询录像结果、删除录像

Status

String

录像任务状态:

  • success(录像任务成功)

  • error(录像任务出错)

MsgString错误信息
CreatedAtInteger录像任务创建时间
UpdatedAtInteger录像任务更新时间
StoppedAtInteger录像任务停止时间
ResStreamRecordResult录像任务结果,参考以下 StreamRecordResult 结构说明

StreamRecordResult 结构说明

字段
类型
说明
UrlString录像文件 URL
RemuxUrlString转封装录像 URL

Extra

Map<String,Object>

其他信息,说明如下:

  • VideoSize(Integer):录像文件大小,单位 byte

  • VideoDuration(Integer):录像时长,单位:ms

示例

请求示例

GET https://open.volcengineapi.com?Action=GetStreamRecord
&Version=2021-01-01
&RecordID=record0xxxx
&<公共请求参数>

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202209141449260102020891370D037571",
        "Action": "GetStreamRecord",
        "Version": "2021-01-01",
        "Service": "aiotvideo",
        "Region": "cn-north-1"
    },
    "Result": {
        "ID":"record0xxx",
        "Status":"success",
        "Msg":"err_msg",
        "CreatedAt":160000000,
        "UpdatedAt":160000001,
        "StoppedAt":160000002,
        "Res": {
            "Url":"https://xxxx", 
            "UrlDelKey":"",
            "RemuxUrl":"https://xxxx", 
            "RemuxUrlDelKey":"",
            "Extra": {
                "VideoSize": 10101010,
                "VideoDuration": 128
            }
        }
    }
}