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
            }
        }
    }
}