文档中心
数据流录制服务端文档（旧版）
数据流录制服务端 API（旧版）
获取回放信息

获取回放信息

更新时间：2022-05-17 18:15

1 描述

录制结束后，当需要进行回放时，需要先调用本接口获取回放信息。将获取到的回放信息传递给回放 SDK，即可进行录制回放。

2 接口原型

请求方式：POST/JSON

请求地址：

服务环境	调用频率限制	请求地址
国内正式环境	10 次/秒	https://cloudrecord-sh.zego.im/get_play_info
国内测试环境	10 次/秒	https://cloudrecord-test.zego.im/get_play_info
海外正式环境	10 次/秒	https://cloudrecord-hk.zegocloud.com/get_play_info
海外测试环境	10 次/秒	https://cloudrecord-test.zegocloud.com/get_play_info

传输协议：HTTPS

3 请求参数

参数	类型	是否必选	描述
app_id	Int64	是	ZEGO 给开发者分配的 AppID，唯一标识一个应用。
access_token	String	是	接口鉴权凭证，通过 access_token 接口获取。
task_id	String	是	录制任务 ID，长度固定为 16 个字节的字符串。

4 请求示例

以下是 get_play_info 接口的请求示例。

{
    "app_id": 0000,
    "access_token": "xxxx",
    "task_id": "xxxx"
}

5 响应参数

参数	类型	描述
code	Int	错误码。
message	String	错误描述。
play_info	String	回放信息，传递给回放 SDK 进行录制回放。

6 响应示例

以下是 get_play_info 接口的响应示例。

{
    "code": 0,
    "message": "succeed",
    "play_info": "{\"start_time\":1623914862741,\"stop_time\":1623915193044,\"whiteboard\":{\"url\":\"\",\"file_name\":\"\"},\"custom_cmd\":{\"url\":\"\",\"file_name\":\"\"},\"internal_cmd\":{\"url\":\"https://xxxx.com/YMr5a-E4I2RdAAAO_5699_internal_cmd_20210617072742713.dat\",\"file_name\":\"YMr5a-E4I2RdAAAO_5699_internal_cmd_20210617072742713.dat\"},\"im\":{\"url\":\"\",\"file_name\":\"\"},\"stream\":[{\"stream_id\":\"a_5699_1623914851770\",\"file_name\":\"YMr5a-E4I2RdAAAO_5699_1623914851770_a_5699_1623914851770_VA_20210617072743322.flv\",\"url\":\"https://xxxx.com/YMr5a-E4I2RdAAAO//YMr5a-E4I2RdAAAO_5699_1623914851770_a_5699_1623914851770_VA_20210617072743322.flv\"}]}"
}