实时音视频
  • iOS
  • Android
  • macOS
  • Windows
  • HarmonyOS
  • Linux
  • Web
  • 小程序
  • Flutter
  • Electron : JavaScript
  • Unreal Engine
  • Unity3D
  • uni-app
  • React Native
  • Cocos Creator
  • 产品简介
  • 下载
  • 快速开始
    • 跑通示例源码
    • 集成 SDK
    • 实现视频通话
    • 场景化音视频配置
  • 通信能力
  • 视频能力
  • 直播能力
  • 客户端 API
  • 服务端 API
  • 常见错误码
  • 常见问题
  • 文档中心
  • 实时音视频
  • 产品简介
  • 升级指南
  • 3.0.0 及以上版本升级指南

3.0.0 及以上版本升级指南

更新时间:2023-09-25 19:27

  • 如果您当前的 SDK 低于 3.0.0 版本,需要升级到任一 3.0.0 或以上的 SDK 版本时,都请务必阅读本文。
  • 此外,建议您根据当前版本号升级目标版本号,参考 发布日志 中两个版本区间的变更说明,检查您的业务相关接口。

本文将介绍 Express Electron SDK 版本升级至 3.0.0 及以上版本时的说明和注意事项。

废弃说明

  1. 废弃 ZegoScenario 场景枚举中的 GeneralCommunicationLive 三种场景,请参考 场景化音视频配置 文档进行适配。

删除说明

删除下列在先前版本已废弃的接口。

方法名 描述
setDebugVerbose 设置调试详细信息开关以及语言。此函数在 2.3.0 版本废弃,请使用 enableDebugAssistant 来实现原来的功能。
loginMultiRoom 登录多房间。此方法在版本 2.9.0 以后已废弃,若需实现多房间功能,请先在引擎初始化之前调用 setRoomMode 函数设置多房间模式,再使用 loginRoom 登录多房间,如果调用 loginRoom 函数登录多房间,请确保传入相同的用户信息。
setPlayStreamVideoLayer 设置选取拉流视频图层。此函数在 2.3.0 版本以后已废弃, 请使用 setPlayStreamVideoType 代替。
onDeviceError 设备异常通知。此函数在 2.15.0 版本及以上已废弃,请使用 onLocalDeviceExceptionOccurred 代替。

变更示例代码

您可以参考以下示例代码进行接口变更。

setDebugVerbose

3.0.0 版本前

zgEngine.setDebugVerbose(true, zgDefines.ZegoLanguage.Chinese);

3.0.0 版本及以上

zgEngine.enableDebugAssistant(true)

loginMultiRoom

3.0.0 版本前

var UserInfo = {userID: 'zego', userName: 'zego'}
zgEngine.loginRoom(roomID1, UserInfo, config = {});
zgEngine.loginMultiRoom(roomID2, config = {});

3.0.0 版本及以上

zgEngine.setRoomMode(zgDefines.ZegoRoomMode.MultiRoom)
var UserInfo = {userID: 'zego', userName: 'zego'}
zgEngine.loginRoom(roomID1, UserInfo, config = {});
zgEngine.loginRoom(roomID2, UserInfo, config = {});

setPlayStreamVideoLayer

3.0.0 版本前

zgEngine.setPlayStreamVideoLayer(streamID, zgDefines.ZegoPlayerVideoLayer.Base);

3.0.0 版本及以上

zgEngine.setPlayStreamVideoType(streamID, zgDefines.ZegoVideoStreamType.Small);

onDeviceError

3.0.0 版本前

zgEngine.on('onDeviceError', res = () =>{
    // handle code
})

3.0.0 版本及以上

zgEngine.on('onLocalDeviceExceptionOccurred', res = () =>{
    // handle code
})
本篇目录