合并媒体文件

更新时间：2022-12-09 10:54

1 描述

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

首次使用本接口之前，请确认是否已经开通 CDN 录制服务。若未开通，请前往 ZEGO 控制台自助开通，详情请参考控制台的服务配置 - CDN，或联系 ZEGO 技术支持开通，并配置回调地址，媒体文件合并完成后会通过媒体文件合并完成回调通知。

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	是	合并后的媒体名称，不包含文件格式。使用时，请对该参数内容进行 UrlEncode。

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 返回码

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

返回码	说明	处理建议
0	请求成功。	-
2	输出参数错误。	-
3	未开通相关权限。	请联系 ZEGO 技术支持。
4	CDN 类型不匹配。	请检查参数。
5	配置错误。	请联系 ZEGO 技术支持。
6	请求过于频繁。	请稍后重试。
7	鉴权失败。	请检查鉴权参数是否正确。
1000	请求失败。	请联系 ZEGO 技术支持。
41003	资源不存在。	请确认资源格式、资源列表是否正确。