TranscodeMedia
https://rtc-api.zego.im/
用户进行 CDN 录制时,可以将录制好的媒体文件存放在 CDN 服务器上,并通过本接口对媒体文件进行点播转码,改变源文件的编码格式、分辨率和码率等属性,在不同终端、网络环境中进行播放。
首次使用本接口之前,请确认是否已经开通 CDN 录制服务。若未开通,请前往 ZEGO 控制台 自助开通,详情请参考 控制台 - 服务配置 - CDN,或联系 ZEGO 技术支持开通,并配置回调地址,媒体文件转码完成后会通过 点播转码完成回调 通知。
开发者可以通过 点播转码完成回调 或 查询媒体文件任务 接口,查看转码任务的状态、文件回放地址等详细信息。
Request
Query Parameters
- 录制文件生成回调 的参数 FileID,仅 CDN 厂商为 Tencent 时会回调该参数。
- 媒体文件合并完成回调 的参数 file_id。
- 检索媒体信息 的参数 FileId。
- 360p
- 540p
- 720p
- 360p:封装格式 MP4,视频编码 H.264,码率 400 kbps,帧率25 fps,音频编码 AAC。
- 540p:封装格式 MP4,视频编码 H.264,码率 1000 kbps,帧率 25 fps,音频编码 AAC。
- 720p:封装格式 MP4,视频编码 H.264,码率 1800 kbps,帧率 25 fps,音频编码 AAC。
Possible values: [TranscodeMedia
]
接口原型参数
https://rtc-api.zego.im?Action=TranscodeMedia
💡公共参数。AppId,ZEGO 分配的用户唯一凭证。
💡公共参数。随机字符串。
💡公共参数。Unix 时间戳,单位为秒。最多允许 10 分钟的误差。
💡公共参数。签名,用于验证请求的合法性。
Possible values: [2.0
]
Default value: 2.0
💡公共参数。签名版本号。
Possible values: [true
, false
]
Default value: false
💡公共参数。是否为测试环境。设为 true 表示使用测试环境。2021-11-16 及之前在 ZEGO 控制台创建的项目默认是测试环境,可根据业务需求设置此参数;而之后创建的项目默认是正式环境。
Possible values: [Tencent
]
CDN 厂商名。
当前仅支持取值为 Tencent:腾讯云。
需要转码的源文件 ID,可以通过以下方式获取:
注意
ZEGO 不会对"传入的 FileId 文件是否真实存在"进行验证,请您注意填写正确的 FileId;传入错误的 FileId,响应参数中的 Code 为 1000。
Possible values: [360p
, 540p
, 720p
]
转码后的媒体文件分辨率,有以下取值可选:
注意
如果您需要自定义文件转码参数,请联系 ZEGO 技术支持配置自定义模板。对于常见的转码规格,默认的各分辨率转码模板对应的参数如下:
Responses
- 200
- application/json
- curl
- python
- go
- nodejs
- ruby
- csharp
- php
- java
- powershell
- CURL