You need to enable JavaScript to run this app.
导航
慢直播
  • 文档首页
    • /慢直播/服务端 OpenAPI 文档/本地回放（新）/下载本地录像文件列表
下载本地录像文件列表
最近更新时间：2025.02.25 17:24:15首次发布时间：2023.08.01 17:13:45
我的收藏

查询可下载的本地录像文件列表。

请求说明

  • 请求方式：POST
  • 请求地址：https://open.volcengineapi.com

请求参数

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

参数类型是否必选示例值描述
Content-TypeString是application/json

Query

参数类型是否必选示例值描述
ActionString是GetLocalDownload接口名称。当前 API 的名称为 GetLocalDownload。
VersionString是2021-01-01接口版本。当前 API 的版本为 2021-01-01。
IDString否ts-xxxxxxxxx开始上传返回的 ID，可通过调用 LocalMediaDownload 接口获取

返回参数

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

参数类型示例值描述
GBMediasArray of GBMedias-可下载的设备本地录像文件列表；详细信息，参考以下 GBMedias 结构说明

GBMedias

参数类型示例值描述
IDStringts-sf18cwbepbdhi35录像文件 ID
StartTimeInteger1686153600录像开始时间，Unix 时间戳，单位：秒
EndTimeInteger1686182400录像结束时间，Unix 时间戳，单位：秒
CallIDStringglUtrIc7360j4ZrH本地录像请求的 ID

Status

String

done

录像文件状态：

  • init
  • uploaded
  • done
  • error
UrlStringhttps://aiot-server-boe.byted.org/media_record/v1/file/get_m3u8?StreamID=ts-sf18cwbepbdhi35&IsLive=1&X-JWT-Token=ZXlKaGJHY2lPaUpJVXpJMU5pSXNJblI1Y0NJNklrcFhWQ0o5LmV5SkJZMk52ZFc1MFNVUWlPakl4TURBd05qVTROREFzSW1WNGNDSTZNVGN3TkRFM01ESXlNeXdpYVhOeklqb2lZV2x2ZEY5elpYSjJaWElpTENKRmVIUnlZU0k2ZXlKUVpYSnRhWE56YVc5dUlqb2lPQ0o5ZlEuMzRxdlFpWWZrbkUxNjlnbl9WV2R3R1RwbmlJOXNLOTlIV3lvcVl3czR5VQ==&X-FROM=bytedance.videoarch.aiot_server&TokenExpire=15552000&Start=1688618223&Pub=1原始视频的 hls 直播地址
SubtitleUrlStringhttps://aiot-server-boe.byted.org/media_record/v1/file/get?ObjKey=tcvtopsg2z0cze2t.fcdn-boe-push.byted.org/202307061137_202307061138_1688618224097423471/mp4/1688618224_202307061137_202307061138_1688618224097423471_cv8a.mp4&X-JWT-Token=ZXlKaGJHY2lPaUpJVXpJMU5pSXNJblI1Y0NJNklrcFhWQ0o5LmV5SkJZMk52ZFc1MFNVUWlPakl4TURBd05qVTROREFzSW1WNGNDSTZNVGN3TkRFM01ESTBPU3dpYVhOeklqb2lZV2x2ZEY5elpYSjJaWElpTENKRmVIUnlZU0k2ZXlKUFltcExaWGtpT2lKMFkzWjBiM0J6WnpKNk1HTjZaVEowTG1aalpHNHRZbTlsTFhCMWMyZ3VZbmwwWldRdWIzSm5Mekl3TWpNd056QTJNVEV6TjE4eU1ESXpNRGN3TmpFeE16aGZNVFk0T0RZeE9ESXlOREE1TnpReU16UTNNUzl0Y0RRdk1UWTRPRFl4T0RJeU5GOHlNREl6TURjd05qRXhNemRmTWpBeU16QTNNRFl4TVRNNFh6RTJPRGcyTVRneU1qUXdPVGMwTWpNME56RmZZM1k0WVM1dGNEUWlMQ0pRWlhKdGFYTnphVzl1SWpvaU1TSjlmUS5ES3pJWXVjTEVpcHpLOUVDeDRwM0tOTmpVMTlGWlp4ZVV2UUpJYjVrTmtn&X-FROM=bytedance.videoarch.aiot_server&IsDownload=1直播水印地址（当调用 LocalMediaDownload 接口时，设置了 M3U8Option，并且 ToMp4 设置为 true，转换完成后会替换为水印视频的 mp4 地址）
FileSizeInteger1200录像文件大小
MsgString发生错误时（status 为 error 时），返回错误信息
FileStreamLengthInteger23000录像文件时长，单位：毫秒
FileNameStringfile01录像文件名称
CreateAtInteger1688618223创建时间。
FirstTsInteger1059上传首帧，单位秒。
FirstTranscodeInteger1798转码首帧，单位秒。
DeviceInfoStatusInteger1是否包含设备信息。1表示包含。
DeviceInfoObject of DeviceInfo设备信息。

DeviceInfo

参数类型示例值描述
DeviceFirmwareStringv1.0
DeviceManufacturerStringBytedance AIOT GB28181 Virtual Device
DeviceModelStringaiot gb28181 virtual device
MaxDownloadSpeedInteger0
DeviceIPString
RecvDeviceIPString
DownloadFlagInteger0
SubStreamKeyString

错误码

您可访问公共错误码，获取更多错误码信息。