视频直播 LIVE-创建直播截图配置:请求参数

时间:2024-12-05 10:10:25

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token,使用Token鉴权方式时必填。通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

Authorization

String

使用AK/SK方式认证时必填,携带的鉴权信息。

X-Sdk-Date

String

使用AK/SK方式认证时必填,请求的发生时间。

X-Project-Id

String

使用AK/SK方式认证时必填,携带项目ID信息。

表3 请求Body参数

参数

是否必选

参数类型

描述

domain

String

直播推流 域名

app_name

String

应用名称

auth_key

String

回调鉴权密钥值

长度范围:[32-128]

若需要使用回调鉴权功能,请配置鉴权密钥,否则,留空即可。

time_interval

Integer

截图频率

取值范围:[5-3600]

单位:秒

object_write_mode

Integer

在OBS桶存储截图的方式:

  • 0:全保存模式,截图文件名中含时间戳,每条流的所有截图文件均会保存在存储对象里。示例:snapshot/{domain}/{app_name}/{stream_name}/{UnixTimestamp}.jpg

  • 1:覆盖模式,截图文件名不含时间戳,每条流只保存最新的截图文件,新的截图文件会覆盖原来的截图文件。示例:snapshot/{domain}/{app_name}/{stream_name}.jpg

obs_location

ObsFileAddr object

OBS存储位置信息

call_back_enable

String

是否启用回调通知

  • on:启用。

  • off:不启用。

call_back_url

String

通知服务器地址,必须是合法的URL且携带协议,协议支持http和https。截图完成后直播服务会向此地址推送截图状态信息。

表4 ObsFileAddr

参数

是否必选

参数类型

描述

bucket

String

OBS的bucket名称

location

String

OBS Bucket所在的区域,且必须保持与使用的直播服务区域保持一致。

object

String

OBS对象路径,遵守OSS Object定义

  • 当用于指示input时,需要指定到具体对象

  • 当用于指示output时,只需指定到截图结果期望存放的路径

support.huaweicloud.com/api-live/CreateSnapshotConfig.html