服务端 API v2
  • API概览
  • 调用方式
  • 房间信令接口
  • 混流接口
  • 媒体服务接口
  • 媒体文件接口
  • 音视频流审核接口
  • 回调说明
  • 全局返回码
  • 调测指南

合并媒体文件

更新时间:2022-01-18 11:43

1 描述

用户进行 CDN 录制时,会把录制好的媒体文件存放在 CDN 服务器上,用户可以调用本接口将多个媒体文件合并为一个。目前仅支持合并 MP3/MP4/M3U8 格式的媒体文件。

首次使用本接口需要联系 ZEGO 技术支持开通 CDN 录制服务并配置回调地址,媒体文件合并完成后会通过 媒体文件合并完成回调 通知。

2 接口原型

  • 请求方法:GET
  • 请求地址:https://rtc-api.zego.im/?Action=MergeMedia
  • 传输协议:HTTPS
  • 调用频率限制:20 次/秒

3 请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表请参考 调用方式 - 公共请求参数

参数 类型 是否必选 描述
Vendor String CDN 厂商名。
  • Tencent:腾讯云。
Format String 储存的文件格式(腾讯云:mp3/mp4/M3U8)。
InputFileId[] Array of String 要合并的文件 ID 列表,按顺序合并。
示例:InputFileId[]=5285890813221514958&InputFileId[]=5285890813221513290
OutputFileName String 合并后的媒体名称,不包含文件格式。

4 请求示例

https://rtc-api.zego.im/?Action=MergeMedia
&Vendor=Tencent
&Format=mp3
&InputFileId[]=5285890813221514958
&InputFileId[]=5285890813221513290
&OutputFileName=dt6
&<公共请求参数>

5 响应参数

参数 类型 描述
Code Number 返回码。
Message String 操作结果描述。
RequestId String 返回客户请求 ID。
Data Object 响应数据。
└ Tencent Object 腾讯云返回内容(CDN 为腾讯云时返回)。
  └ TaskId String 制作媒体文件的任务 ID,可以通过该 ID 查询制作任务。
  └ RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

6 响应示例

{
    "Code":0,
    "Message":"success",
    "RequestId":"3574501647605445341",
    "Data":
      {
        "Tencent":
           {
             "TaskId":"1400341231-EditMedia-0d8b6f0a5c457f5722e6b27796ce1f2ctt0",
             "RequestId":"07f0bdbc-6a52-4ef9-ba7b-e96d6c81d6c3"
           }
      }
}

7 返回码

以下仅列出了接口业务逻辑相关的返回码,完整返回码请参考 全局返回码

返回码 说明
41001 直播保存失败。
41002 频道保存失败。
41003 直播不存在。
41004 流已不存在。
42001 禁用直播失败。
42002 恢复直播失败。
43001 创建录制索引文件失败。