合并媒体文件
https://rtc-api.zego.im/
用户进行 CDN 录制时,会把录制好的媒体文件存放在 CDN 服务器上,用户可以调用本接口将多个媒体文件进行 裁剪 和 合并。
目前仅支持合并 MP3/MP4/M3U8 格式的媒体文件。
- 首次使用本接口之前,请确认是否已经开通 CDN 录制服务。若未开通,请前往 ZEGO 控制台 自助开通,详情请参考 控制台 - 服务配置 - CDN,或联系 ZEGO 技术支持开通。
- 请联系 ZEGO 技术支持开通合并媒体文件功能,并配置回调地址,媒体文件合并完成后会通过 媒体文件合并完成回调 通知。
- 使用该功能合并后的录制文件会永久保存,不能通过配置来修改保存天数。若需要删除,可以使用 删除媒体文件 接口进行删除。
Request
Query Parameters
- Tencent:腾讯云。
- Huawei:华为云。
-
腾讯云:MP3、MP4、M3U8。
注意使用的 CDN 厂商是“腾讯云”时,如果合并后的文件为 MP3 或 MP4 格式,您需要确保输入源文件的“音频格式”为 AAC-LC 编码,否则合并后的视频文件可能没有声音。 -
华为云:MP4、M3U8。
- 0:默认值,不裁剪,直接合并文件。
- 1:对媒体文件进行裁剪等操作后,再合并文件。此时
InputFileId[]参数无效,此时必须传入HandleMediaArgs.N.FileId参数。 - Vendor 取值为 Tencent,此参数必选。
- Vendor 取值为 Huawei,此参数非必选,不填则由系统自动生成。
- 取值为 0(默认值):表示文件永久保存不过期。
- 取值大于 0:超过该时长文件将被删除。
- 该字段,仅对 Vendor 取值为 Tencent 时有效。
- 如果合并媒体文件的任务完成时长,大于其有效保存时长,文件将不会生成,媒体文件合并完成回调 在访问合成后的文件 URL 时会 404。
可选值: [MergeMedia]
接口原型参数
https://rtc-api.zego.im/?Action=MergeMedia
💡公共参数。应用 Id,由 ZEGO 分配的用户唯一凭证。可从 ZEGO 控制台 获取。
💡公共参数。16 位 16 进制随机字符串(8 字节随机数的 hex 编码)。生成算法可参考 签名示例。
💡公共参数。当前 Unix 时间戳,单位为秒。生成算法可参考 签名示例,最多允许 10 分钟的误差。
💡公共参数。签名,用于验证请求的合法性。请参考签名机制生成。
可选值: [2.0]
默认值: 2.0
💡公共参数。签名版本号。
可选值: [Tencent, Huawei]
可能的取值及对应的 CDN 厂商:
默认值: MP4
合并后的文件格式,默认格式为 MP4。
可选值: [0, 1]
默认值: 0
合并操作类型。
该参数取值为 1 时,仅对 Vendor 取值为 Tencent 有效,取值为 Huawei 无效。
可选值: >= 1, <= 20
可选值: >= 1, <= 10
Type 取值为 1,此参数有效。
需要裁剪后、再进行合并的文件 ID 列表,按照字段名中 N 从小到大的顺序进行合并,最多支持合并 10 个文件。
例如,HandleMediaArgs.0.FileId=5285890813221514958&HandleMediaArgs.1.FileId=5285890813221513290
HandleMediaArgs.N.FileId默认值: 0
HandleMediaArgs.N.FileId 对应的媒体文件开始裁剪的时间偏移量,默认为 0,单位:秒。
例如,HandleMediaArgs.0.StartTime 对应的是 HandleMediaArgs.0.FileId 这个媒体文件的开始裁剪时间。
HandleMediaArgs.N.StartTimeHandleMediaArgs.N.FileId 对应的媒体文件结束裁剪的时间偏移量,默认为视频文件的结束时间,单位:秒。
例如,HandleMediaArgs.0.EndTime 对应的是 HandleMediaArgs.0.FileId 这个媒体文件的结束裁剪时间。
HandleMediaArgs.N.EndTimeHandleMediaArgs.0.FileId=5576678019238910395&
HandleMediaArgs.0.StartTime=0.5&
HandleMediaArgs.0.EndTime=10.5&
HandleMediaArgs.1.FileId=5576678019238910395&
HandleMediaArgs.1.StartTime=10&
HandleMediaArgs.1.EndTime=15合并后的媒体文件名称,不包含文件格式。
使用时,请对该参数内容进行 UrlEncode。
默认值: 0
合并后媒体文件的有效保存时长(单位:小时),即文件过期时间 = 接口请求时间 + 有效保存时长。
Responses
- 200
- application/json
