文档中心
实时音视频
产品简介
升级指南
3.0.0 及以上版本升级指南

3.0.0 及以上版本升级指南

更新时间：2024-12-19 19:21

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

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

废弃说明

废弃 ZegoScenario 场景枚举中的 General、Communication、Live 三种场景，请参考场景化音视频配置文档进行适配。

删除说明

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

方法名	描述
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
})