数据流录制
  • iOS
  • Android : Java
  • Web
  • 产品简介
    • 概述
    • 发布日志
  • 下载
    • SDK 下载
    • 体验 App
  • 快速开始
    • 跑通示例源码
    • 录制实现流程
    • 回放 SDK 集成
    • 回放实现流程
  • 基础功能
  • 客户端 API
  • 服务端 API v2
  • 常见错误码
  • 常见问题
  • 文档中心
  • 数据流录制
  • 服务端 API v2
  • 获取回放信息

获取回放信息

更新时间:2024-04-02 14:55

1 描述

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

2 接口原型

  • 请求方法:POST
  • 请求地址:https://cloudrecord-api.zego.im/?Action=DescribePlayInfo
  • 传输协议:HTTPS
  • 调用频率限制:10 次/秒

3 请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表请参考 调用方式 中的 “2.1 公共请求参数”。

参数 类型 是否必选 描述
TaskId
Int
录制任务 ID,长度固定为 16 个字节的字符串。

4 请求示例

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

  • 请求 URL
    https://cloudrecord-api.zego.im/?Action=DescribePlayInfo
    &AppId=1234567890
    &SignatureNonce=15215528852396
    &Timestamp=1234567890
    &Signature=7a2c0f11145fb760d607a07b54825013
    &SignatureVersion=2.0
    &IsTest=false
  • 请求消息体
    {
      "TaskId": "X3CgNeE4I1qAAABN"
    }

5 响应参数

参数 类型 描述
Code
Int64
错误码。
Message
String
错误描述。
RequestId
String
请求 ID。
Data
Object
响应对象。
详见 Data 成员列表

Data 成员如下:

参数 类型 描述
PlayInfo
String
回放信息,传递给回放 SDK 进行录制回放。

6 响应示例

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

{
    "Code": 0,
    "Message": "succeed",
    "RequestId": "abcd123",
    "Data": {
        "PlayInfo": "{\"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\"}]}"
    }
}
本篇目录