单流转码

---

功能简介

单流转码，指在云端把单条原始流转换为不同编码格式、不同分辨率的转码流。在直播等场景中，观众可以基于接入网络质量、终端设备等，自行选择不同分辨率的流进行观看，以保证播放的流畅性。

应用场景

• 当开发者提供多种分辨率的视频流供用户按需观看时，需要将原始流转换为不同清晰度的转码流，此时可使用单流转码功能。
• 将原始视频流转换为不同的视频编码格式时，可使用单流转码功能。例如，部分设备由于性能问题不能解码 H.265 时，需要转码为 H.264。

前提条件

在使用单流转码功能之前，请确保：

• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。
• 已在项目中集成 ZEGO Express SDK，并实现了基本的音视频推拉流功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。

• 需使用 L3 拉流、转推 CDN 拉流（通过 streamID 拉流） 或 RTC 拉流，且未使用混流能力。

实现流程

单流转码的主要流程如下：

1. 添加转码模板。
2. 创建引擎并登录房间。
3. 按需拉取转码流，根据需要选择拉流方式为 L3 拉流、转推 CDN 拉流（通过 streamID 拉流） 或 RTC，并传入转码模板 ID 触发转码。

1 添加转码模板

请联系 ZEGO 技术支持添加转码模板，并获取到对应的转码模板 ID。

目前支持配置的转码参数为：模板 ID、分辨率、码率、帧率及视频编码格式。

2 创建引擎并登录房间

具体流程请参考“实现视频通话”文档的 创建引擎 和 登录房间 章节。

3 拉转码流

配置 ZegoPlayerConfig 的 codecTemplateID 属性，填写 步骤 1 添加转码配置模板 中获取的转码模板 ID，并开始拉流。

ZegoPlayerConfig playerConfig = ZegoPlayerConfig.defaultConfig();
// 按实际业务情况配置
playerConfig.resourceMode = ZegoStreamResourceMode.OnlyL3;
// 101 是配置好的模板 ID，参考步骤 1 添加转码配置模板
playerConfig.codecTemplateID = 101;
ZegoCanvas playCanvas = ZegoCanvas(_playViewID);
// engine 为创建引擎时，创建的 ZegoExpressEngine 对象
ZegoExpressEngine.instance.startPlayingStream("streamID", canvas:playCanvas, config:playerConfig);

常见问题

混流和单流转码的区别是什么？

• 混流一般用于将多条输入流合并为一路，同时支持定义多路输出流的编码格式、分辨率等参数，且混流转码需要开发者额外调用客户端或服务端接口触发。
• 单流转码用于实现单条流的转码功能，且无需开发者额外调用客户端或服务端接口触发，仅需在拉流时带上模板参数触发即可。