查询录像--慢直播-火山引擎

文档中心

立即注册

导航

查询录像

最近更新时间：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
RecordID	Query	String	是	需要查询的录像任务 ID	record0xxxx

返回结果

返回参数说明

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

Result 字段包含以下参数：

字段	类型	说明
ID	String	录制任务唯一 ID，凭借该 ID 可以停止录像、查询录像结果、删除录像
Status	String	录像任务状态： success（录像任务成功） error（录像任务出错）
Msg	String	错误信息
CreatedAt	Integer	录像任务创建时间
UpdatedAt	Integer	录像任务更新时间
StoppedAt	Integer	录像任务停止时间
Res	StreamRecordResult	录像任务结果，参考以下 StreamRecordResult 结构说明

StreamRecordResult 结构说明

字段	类型	说明
Url	String	录像文件 URL
RemuxUrl	String	转封装录像 URL
Extra	Map<String,Object>	其他信息，说明如下： VideoSize（Integer）：录像文件大小，单位 byte VideoDuration（Integer）：录像时长，单位：ms

字段

类型

说明

Url

String

录像文件 URL

RemuxUrl

String

转封装录像 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
            }
        }
    }
}