3.21.5及以上版本升级指南
2026-01-14
注意
如果您当前的 SDK 低于 3.21.5 版本，需要升级到 3.21.5 或以上的 SDK 版本时，请务必阅读本文。此外，建议您参考 发布日志 中两个版本区间的变更说明，检查您的业务相关接口。
本文将介绍 Express SDK 升级至 3.21.5 及以上版本时，为减少平台差异，部分 Web 端接口定义对齐 Native 端所产生的接口参数变化。
Web 端接口变更
localDeviceExceptionOccurred
localDeviceExceptionOccurred 修改回调参数格式。
localDeviceExceptionOccurred(exceptionType: ZegoDeviceExceptionType, deviceType: ZegoDeviceType, deviceID: string):voidpublisherQualityUpdate 和 playerQualityUpdate
publisherQualityUpdate 和 playerQualityUpdate 修改回调参数。
publisherQualityUpdate(streamID: string, quality: ZegoPublishStreamQuality):void
playerQualityUpdate(streamID: string, quality: ZegoPlayStreamQuality):voidaddPublishCdnUrl 和 removePublishCdnUrl
addPublishCdnUrl、removePublishCdnUrl 修改参数格式。3.21.5 版本之前 Web 端第一个参数为 targetUrl ，第二个参数为 streamID ；3.21.5 版本之后第一个参数为 streamID ，第二个参数为 targetURL。
addPublishCdnUrl(streamID: string, targetURL: string):Promise<ZegoPublisherUpdateCdnUrlResult>
removePublishCdnUrl(streamID: string, targetURL: string):Promise<ZegoPublisherUpdateCdnUrlResult>