ZegoExpressEngine 音视频插件（JS） - 更新日志

3.21.0（2025-06-30）

3.21.0

新增功能

  1. 媒体播放器新增清理最后一帧的能力，mediaPlayer-> clearView

3.17.4（2025-01-06）

3.17.4

新增功能

  1. 添加 [setAudioDeviceMode] 接口，用于设置音频设备模式。

3.17.3（2024-11-26）

新增功能

1. 新增屏幕共享功能

iOS 屏幕共享分为应用内共享与跨应用共享，分别用于当前应用分享与系统级别的应用分享。如使用跨应用共享，需要在 iOS 原生工程新建 Broadcast Upload Extension 进程用于录制屏幕。 Android 为更符合隐私规范，需开发者主动声明屏幕共享权限：

  • 如果目标 Android SDK 版本低于 34.0.0 版本，需设置 `FOREGROUND_SERVICE`` 权限声明。
  • 如果目标 Android SDK 版本是 34.0.0 及以后版本，需要设置 FOREGROUND_SERVICE 及 FOREGROUND_SERVICE_MEDIA_PROJECTION 权限声明。 详情请参考 屏幕共享 文档。

相关 API 请参考 startScreenCapture、stopScreenCapture、updateScreenCaptureConfig、mobileScreenCaptureExceptionOccurred，mobileScreenCaptureStart

2. 媒体播放器新增设置视图模式

新增 ZegoViewMode 参数，用于设置媒体播放器的视图模式，详情请参考 媒体播放器 文档。

改进优化

  1. 更新集成 Express Native SDK 至 3.17.3 版本

3.16.1（2024-08-15）

适配 uni_modules，开发者可以使用 uni_modules 依赖本插件

3.15.3（2024-07-05）

修复更新

web 端适配 vue3 框架

3.15.2（2024-06-13）

新增功能

  1. web 适配 vue3 框架

3.15.1（2024-06-13）

新增功能

  1. 适配 vue3 框架；
  2. 新增 [roomStateChanged] 回调，监听房间状态变更；
  3. 新增 [setStreamExtraInfo] 接口，设置流附加消息；

3.10.3（2024-05-11）

问题修复

修复 addPublishCdnUrl 接口参数调用问题

3.9.0（2023-09-19）

1. 新增本地媒体录制功能。

开发者可将音视频流录制成本地文件，用于以后回放等用途。

相关 API 请参考 startRecordingCapturedData, stopRecordingCapturedData，capturedDataRecordStateUpdate，capturedDataRecordProgressUpdate

3.6.0（2023-07-10）

新增功能

1. 当设置为后置摄像头时可以使用手机手电筒

相关 API 请参考 enableTorch

1.8.0（2023-04-25）

新增功能

1. 媒体播放器支持播放透明特效 (仅支持 App)

媒体播放器支持通过渲染 Alpha 通道，实现播放透明特效文件功能，详情请参考 播放透明礼物特效。

相关 API 请参考 loadResourceWithConfig

1.7.1（2022-11-08）

1. 媒体播放器功能支持 Web 平台使用

新增支持在 Web 平台使用 createMediaPlayer、destroyMediaPlayer 以及 createMediaPlayer 创建的实例对象的 setPlayerView、start、pause、resume、stop、setPlaySpeed、enableRepeat、getTotalDuration、enableAux、setVolume 等接口，详情请参考 功能总览|_blank。

相关 API 请参考 createMediaPlayer、destroyMediaPlayer

1.7.0（2022-10-17）

1. 部分接口支持 H5 平台使用

v1.7.0 版本之前的 SDK 仅支持 App 平台使用。v1.7.0 版本开始，部分接口支持在 H5 平台上使用。 接口详情请查看 发布日志

1.6.1（2022-06-20）

新增房间附加消息功能

该功能可以设置一个以房间为单位的附加消息，该消息跟随整个房间的生命周期，每个登录到房间的用户都能够同步消息。开发者可用于实现各种业务逻辑，如房间公告等等。目前房间附加消息只允许设置一个键值对，且 key 最大长度为 10 字节，value 最大长度为 100 字节。

相关 API 请参考 setRoomExtraInfo / roomExtraInfoUpdate

1.6.0（2022-03-29）

ZegoExpressEngineSDK 音视频插件的JS包装