logo
当前页

场景化音视频配置


功能简介

为方便开发者快速接入,降低开发者接入门槛,SDK 通过大量线上数据验证,沉淀出多种场景化配置方案。开发者可根据所需场景,选择对应的房间模式,SDK 将自动应用适合该场景的音视频编解码器、音视频参数、流控策略等配置,从而快速实现该场景下的最佳效果。当前支持场景包括秀场直播、KTV、标准 1v1 音视频通话、高画质 1v1 音视频通话、标准语聊房、高音质语聊房。

调用方式

在创建引擎的 profile (ZegoEngineProfile) 参数中的 scenario (ZegoScenario) 字段需要指定一个场景,您可以根据实际音视频业务场景来选择。

注意

同一个房间内的用户,建议使用同一种房间场景,以获得最佳效果。

目前 SDK 支持下列场景:

场景(支持版本:3.0.0 及以上)场景描述关键配置说明
Broadcast

直播场景,适用于秀场、游戏、电商、教育大班课等一对多直播的场景中,对音画质量、流畅度、兼容性等进行了优化。

注意:直播场景中,SDK 没有业务上的 “角色” 之分(例如主播、观众),房间内的所有用户均可推拉流。

  • 分辨率:540p。
  • 帧率:24 fps。
  • 音频编码器兼容:与 Web SDK 互通时需要服务端转码。
StandardVideoCall

标准音视频通话场景,适用于 1v1 视频或语音通话场景。

  • 分辨率:360p。
  • 帧率:15 fps。
  • 音频编码器兼容:仅可用于 RTC 推流,转推 CDN 时需要服务端转码。
HighQualityVideoCall

高品质音视频通话场景,与 StandardVideoCall 场景类似,但该场景默认采用了比 StandardVideoCall 场景更高的视频配置,适用于对画质要求较高的视频通话场景。

  • 分辨率:540p。
  • 帧率:24 fps。
  • 音频编码器兼容:仅可用于 RTC 推流,转推 CDN 时需要服务端转码。
StandardVoiceCall

标准语音通话场景,适用于 1v1 纯语音通话场景。

注意:在实时音视频 (Express-Video) SDK 上,此场景默认不开启摄像头。

-
StandardChatroom

标准语聊房场景,适用于多人纯语音通话,节省流量。

注意:在实时音视频 (Express-Video) SDK 上,此场景默认不开启摄像头。建议存在音乐的语聊房场景选择高品质语聊房场景配置。

音频编码器兼容:仅可用于 RTC 推流,转推 CDN 时需要服务端转码。
HighQualityChatroom

高品质语聊房场景,与 StandardChatroom 场景类似,但此场景默认采用了比 StandardChatroom 场景下更高的音频配置,适用于对音质要求较高的多人纯语音通话场景。

注意:在实时音视频 (Express-Video)SDK 上,此场景默认不开启摄像头。

音频编码器兼容:仅可用于 RTC 推流,转推 CDN 时需要服务端转码。
Karaoke

卡拉 OK (KTV)场景,适用于实时合唱、在线 K 歌场景,对延迟、音质、耳返、回声消除等进行了优化,同时还保障了多人合唱时的精准对齐和超低时延。

注意:在实时音视频(Express-Video)SDK 上,此场景默认不开启摄像头。

音频编码器兼容:仅可用于 RTC 推流,转推 CDN 时需要服务端转码。
Default

默认(通用)场景,若上述场景枚举均不符合开发者的实际应用场景,可以使用此默认场景。

  • 分辨率:360p。
  • 帧率:15 fps。
  • 音频编码器兼容:与 Web SDK 互通时需要服务端转码。
注意

由于以下 3 种旧版场景已废弃,请使用旧版场景的用户尽快迁移到上述的新版场景。

  • General 旧版通用场景。
  • Communication 旧版实时通讯场景。
  • Live 旧版直播场景。

若指定场景后,开发者有对 SDK 音视频配置精细化控制的需求,可通过其他 API 进行配置,优先级高于场景化配置,详情请参考 常用视频配置文档。

注意

若有其他场景的设置需求或配置疑问,请联系 ZEGO 技术支持。

Previous

实现视频通话

Next

使用 Token 鉴权