ControlPlayback - 本地回放控制--慢直播-火山引擎

文档中心

立即注册

导航

ControlPlayback - 本地回放控制

最近更新时间：2025.06.16 17:35:59首次发布时间：2025.02.13 18:13:05

本地回放控制

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	ControlPlayback	要执行的操作，取值：ControlPlayback。
Version	String	是	2023-10-01	API的版本，取值：2023-10-01。
PlaybackID	String	是	回放任务唯一ID	回放id
Cmd	Integer	是	1	操作类型： 0（开始） 1（暂停） 2（倍速） 3（跳转）
Ntp	String	是	10	指定起始播放时间，单位为：秒（如果当前片段长度为5分钟，指定60秒即从片段的第1分钟开始播放）
Scale	Float	是	4	倍速，可选项（需要按设备或网络支持的条件进行设置）： 1.0 2.0 4.0 8.0 16.0 32.0

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

POST /?Action=ControlPlayback&Version=2023-10-01&PlaybackID=Goe2Kz&Cmd=878&Ntp=1W&Scale=315.5677852730533 HTTP/1.1
Host: open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20241219T070834Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20241219/cn-beijing/aiotvideo/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20241219150838080050043236D562BE",
    "Action": "ControlPlayback",
    "Version": "2023-10-01",
    "Service": "aiotvideo",
    "Region": "cn-beijing"
  },
  "Result": {}
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息
400	InvalidParameter.PlayBackControlArgs	InvalidParameter.PlayBackControlArgs
500	ErrorDeviceSipTimeout	InternalError.SipTimeout
500	ErrorDeviceSipError	InternalError.SipError
500	InternalError.PlaybackDB	InternalError.PlaybackDB
500	NotFoundPlayback	NotFound.PlaybackDB