StartPlayback - 开始回放--慢直播-火山引擎

文档中心

立即注册

慢直播

本地回放（新）

StartPlayback - 开始回放

开始录像回放。

调试

API Explorer

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

去调试

请求参数

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

参数	类型	是否必填	示例值	描述
Action	String	是	StartPlayback	要执行的操作，取值：StartPlayback。
Version	String	是	2023-10-01	API的版本，取值：2023-10-01。
SpaceID	String	否	spaceidxxxxxxuuid	流所属空间ID
StreamID	String	是	23355851-2d31-461c-9e44-968a0afb72f2	视频流 ID
StartTime	Integer	是	1660031340	回放片段的开始时间，秒级时间戳，例如：1660031340
EndTime	Integer	是	1660041340	回放片段的结束时间，秒级时间戳，例如：1660041340

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
PlaybackID	String	524c804d-0149-4b58-8209-2f17f6xxxxxx	回放流ID
PushUrl	String	rtmp://xxx.xxx-push.org/xxx/xxx?volcTime=1681xxxxxx&volcSecret=xxx	推流地址
PullUrls	Array of String	["rtmp://xxx.pull.video.com/xxx/xxx_xxx"]	拉流地址（多个）

请求示例

POST /?Action=StartPlayback&Version=2023-10-01 HTTP/1.1
Host: open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20241219T071420Z
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

{
  "StreamID": "23355851-2d31-461c-9e44-968a0afb72f2",
  "StartTime": 1660031340,
  "EndTime": 1660041340
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202412191514231440471711301490AC",
    "Action": "StartPlayback",
    "Version": "2023-10-01",
    "Service": "aiotvideo",
    "Region": "cn-beijing"
  },
  "Result": {
    "PlaybackID": "524c804d-0149-4b58-8209-2f17f6xxxxxx",
    "PushUrl": "rtmp://xxx.xxx-push.org/xxx/xxx?volcTime=1681xxxxxx&volcSecret=xxx",
    "PullUrls": [
      "[\"rtmp://xxx.pull.video.com/xxx/xxx_xxx\"]"
    ]
  }
}

错误码

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

状态码	错误码	错误信息
400	InvalidParameterPlaybackStartArgs	InvalidParameter.PlayBackStartArgs
500	NotFoundStream	InvalidParameter.StreamNotFound
500	InternalErrorStreamDB	InternalError.StreamDB
500	InternalError.PlaybackDB	InternalError.PlaybackDB
500	QuotaExceededDevicePlaybackCountLimit	QuotaExceeded.DevicePlaybackCountLimit
500	InternalErrorMissingPlaybackFile	InternalError.MissingPlaybackFile
500	InternalErrorDeviceInvite	InternalError.DeviceInvite

最近更新时间：2025.06.16 17:00:38

这个页面对您有帮助吗？

有用

无用