实时音视频
  • iOS
  • Android
  • macOS
  • Windows
  • HarmonyOS
  • Linux
  • Web
  • 小程序
  • Flutter
  • Electron
  • Unreal Engine
  • Unity3D
  • uni-app : JavaScript
  • React Native
  • Cocos Creator
  • 产品简介
  • 下载
  • 快速开始
    • 跑通示例源码
    • 集成 SDK
    • 实现视频通话
    • 实时音视频 SDK 与实时语音 SDK 差异
  • 通信能力
  • 房间能力
  • 音频能力
  • 视频能力
  • 直播能力
  • 其他能力
  • 最佳实践
  • 客户端 API
  • 服务端 API
  • 常见错误码
  • 常见问题
  • 文档中心
  • 实时音视频
  • 视频能力
  • 设置视频编码方式

设置视频编码方式

更新时间:2024-01-02 18:48

1 功能简介

在开发者推拉视频流时,可对编解码进行详细设置,包括启用分层视频编码(大小流)、使用硬件编解码和设置编码方式。

1.1 分层视频编码(大小流)

分层视频编码将码流分为基本层和扩展层,这种编码方式可以为不同网络状态的用户提供更好的体验,也称大小流。基本层保证了最基本的视频质量,而扩展层则是对基本层的补充。对于网络较好的用户,可只拉取扩展层获得更好的体验,对于网络状态较差的用户,只拉取基本层可以保证基本的视频质量。

当开发者在连麦或混流业务中出现以下情况时,推荐使用分层视频编码功能:

  • 需要不同终端显示不同质量的视频流。
  • 需要在较差的网络环境中保持连麦的流畅。
  • 需要根据网络状态自适应拉取视频流的质量。

分层视频编码使用的是 ZEGO 的私有协议,拉流端只有从 ZEGO 服务器上才能拉取到不同分层的视频流。

1.2 硬件编解码

开发者可选择开启硬件编码和硬件解码。开启硬件编解码后会使用 GPU 进行编解码,降低 CPU 使用率。若某些机型在推或拉大分辨率音视频流时设备发热严重,可开启硬件编解码。

1.3 视频编码方式

开发者可进行视频编码配置,使不同端之间进行编码对齐,进而实现多端互通。

使用场景:

  • 一般情况下使用默认编码即可。
  • 在同等分辨率帧率的情况下,需要降低码率,可以采用 H.265。
  • 在需要与小程序互通时,需要使用 H.264。

2 示例源码下载

请参考 下载示例源码 获取源码。

相关源码请查看 “/pages/example/advance-video/video-codec.nvue” 目录下的文件。

3 前提条件

在实现视频编解码功能之前,请确保:

4 实现步骤

4.1 分层视频编码

使用分层视频编码需要以下两个步骤:

  • 推流前通过指定特定的编码器来开启分层视频编码。
  • 拉流时指定要拉取的分层视频。

4.1.1 开启分层视频编码

在推流(startPublishingStream)前调用 setVideoConfig 设置 ZegoVideoConfig 类中的参数 “codecID”,即可开启/关闭分层视频编码功能。

目前 Web 只支持设置 ZegoVideoCodecID.DefaultZegoVideoCodecID.VP8

  • “codecID” 设置为 “ZegoVideoCodecID.SVC”,可以开启该功能。
  • “codecID” 设置为 “ZegoVideoCodecID.Default”、“ZegoVideoCodecID.VP8” 或 “ZegoVideoCodecID.H265” 可关闭该功能。
let videoConfig = {};
videoConfig.codecID = ZegoVideoCodecID.SVC;
ZegoExpressEngine.instance().setVideoConfig(videoConfig);

let streamID = "MultiLayer-1";
ZegoExpressEngine.instance().startPublishingStream(streamID);

4.1.2 指定要拉取的分层视频

在推流端开启了分层视频编码后,拉流端在拉流前后均可调用 setPlayStreamVideoType 接口,拉流端默认会根据网络情况拉取合适的视频分层,例如弱网只拉取基本层。开发者也可以传入具体的拉流参数以拉取特定的视频分层,目前支持的视频分层如下:

Web 目前不支持指定要拉取的分层视频。
枚举值 说明
ZegoVideoStreamType.Default 根据网络状态选择图层
ZegoVideoStreamType.Small 小分辨率类型
ZegoVideoStreamType.Big 大分辨率类型

以拉取扩展层为例:

ZegoExpressEngine.instance().setPlayStreamVideoType(playStreamID,ZegoVideoStreamType.Big);
ZegoExpressEngine.instance().startPlayingStream(playStreamID);

4.2 硬件编解码

由于少部分机型设备对硬件编码/解码的支持不佳,SDK 默认使用软件编码与软件解码的方式,若开发者有使用硬件编码的需求,可参照本节自行设置。

Web 目前不支持硬件编解码。

4.2.1 开启硬件编码

该功能需在推流前设置才能生效,如果在推流后设置,停止推流后重新推流才可以生效。

若开发者需要开启硬件编码,可调用 enableHardwareEncoder 接口。

// 开启硬件编码
ZegoExpressEngine.instance().enableHardwareEncoder(true);

4.2.2 开启硬件解码

该功能需在拉流前设置才能生效,如果在拉流后设置,停止拉流后重新拉流才可以生效。

若开发者需要开启硬件解码,可调用 enableHardwareDecoder 接口。

// 开启硬件解码
ZegoExpressEngine.instance().enableHardwareDecoder(true);

4.3 设置视频编码方式

在推流(startPublishingStream)前调用 setVideoConfig 接口设置 “ZegoVideoConfig” 类下的参数 “codecID”,即可设置视频编码方式。目前支持的视频编码方式如下:

目前 Web 仅支持 H.264、VP8,其他编码方式暂不支持。

枚举值 编码方式 使用场景
ZegoVideoCodecID.Default 默认编码(H.264) H.264 是被广泛使用的高精度视频的录制、压缩和发布格式,拥有很好的兼容性。
ZegoVideoCodecID.SVC 分层编码 (H.264 SVC) 需要使用分层编码的场景。
ZegoVideoCodecID.VP8 VP8 常用于 Web 视频,但不能用在 CDN 录制场景中,否则会造成录制文件异常。
ZegoVideoCodecID.H265 H.265 拥有更好的压缩率,但需考虑兼容性。

以设置编码方式为 H.265 为例:

let videoConfig = {};
videoConfig.codecID = ZegoVideoCodecID.H265;
ZegoExpressEngine.instance().setVideoConfig(videoConfig);

let streamID = "MultiLayer-1";
ZegoExpressEngine.instance().startPublishingStream(streamID);

5 API 参考列表

方法 描述
setVideoConfig 设置视频参数
enableHardwareEncoder 开/关硬件编码
enableHardwareDecoder 开/关硬件解码

6 常见问题

  1. 什么是大小流?

    大小流即分层视频编码,用户在接收端拉流前,根据自己的网络状况,可以调用 setPlayStreamVideoType 设置为 ZegoVideoStreamTypeSMALL(小流)或者 ZegoVideoStreamTypeBIG(大流),也可以设置为 ZegoVideoStreamTypeDEFAULT,让 ZEGO 帮您自动选择。

  2. 分层视频编码拉取基本层和扩展层码率、分辨率等参数有区别吗?

    分层视频编码基本层的分辨率宽高分别是扩展层的 50%,拉取基本层的码率大约为拉取扩展层码率的 25%,其他参数一致。

分层视频编码只会拉取一层,网络情况良好时,只拉扩展层,网络情况不好时,只拉取基础层。

例如,用户设置编码分辨率为 “800 × 600”,则扩展层分辨率为 “800 × 600”,基本层分辨率为 “400 × 300”。
  1. 转推或直推 CDN,观众从 CDN 上拉流,分层视频编码是否有效?从 CDN 拉取的流码率、分辨率是多少?

    • 分层视频编码使用的是 ZEGO 的私有协议,拉流端只有从 ZEGO 服务器上才能拉取到不同分层的视频流。

    • 转推 CDN 场景下,推流端推送到 ZEGO 服务器的流可以使用分层视频编码,从 ZEGO 服务器也可以拉取到分层视频编码的流。但是 ZEGO 服务器转推到 CDN 服务器的流无法使用分层视频编码,而会是高质量的流。从 CDN 拉取的流与分层视频编码中扩展层的码率、分辨率一致。

    • 直推 CDN 场景下,由于不经过 ZEGO 服务器,所以分层视频编码无效。从 CDN 拉取的流的分辨率和码率与推流用户设置的分辨率和码率一致。

  2. 分层视频编码的优缺点?

优点 缺点
  • 分层视频编码可以根据需要产生不同的码流或者提取出不同的码流,使用分层视频编码实现一次编码比用普通编码方式编码多次更高效。
  • 分层视频编码应用更灵活。
  • 分层视频编码网络适应性更强。
  • 压缩效率稍低:在同样的条件下,分层视频编码比普通编码方式的压缩效率要低 20% 左右,也就是说要达到和普通编码方式相同的视频质量,分层视频编码的码率要比普通编码方式多 20%,分层数越多,效率下降越多。(目前 SDK 只支持 1 路基本层和 1 路扩展层)
  • 编码效率低:分层视频编码在同样的条件下,比普通编码方式的编码计算复杂度高,所以编码效率相比普通编码方式约低 10%。
  • 不支持硬件编码:分层视频编码不支持硬件编码,对 CPU 的性能负担较大,支持硬件解码。
本篇目录