Release Notes

Version 1.6.0

Release Date: 2026-03-24

New Features

1. Added configuration option keepScreenOn to keep the screen on and prevent auto screen-off when playing video on mobile devices.

Improvements

1. Optimized the time to first frame when playing stream: the player now decodes and renders the first frame immediately after receiving data, without waiting for buffered data.

Bug Fixes

1. Fixed the issue where the onError callback would not be triggered when autoplay failed after importing the player code across domains.

2. Fixed the issue where the player would get the muted property value as undefined.

3. Fixed the issue where using MSE decoding mode to enter the page and autoplay audio and video without interaction could cause subsequent playback exceptions.

4. Fixed the occasional playback failure that occurred when, after initializing the player plugin, calling stop to stop the resource and then play to play the resource again.

Version 1.5.1

Release Date: 2025-11-21

Bug Fixes

1. Fixed the issue where decoding failed when playing H265 videos from some CDN providers.

2. Fixed the issue where stuttering occurred when playing 720P H265 videos in Safari browser on some iOS models.

3. Fixed the issue where when more than three player instances were created on some Android models in Chrome browser, the newly created player instances would fail to decode.

Version 1.5.0

Release Date: 2025-07-23

New Features

1. Support for getting real-time sound waves of audio played by the player.

   Related API please refer to: enableSoundLevelMonitor

Version 1.3.1

Release Date: 2024-09-24

New Features

1. Added received bytes-related fields to player stream quality data for traffic statistics

   The player stream quality data QualityStats obtained through getPlayQuality and onResetPlayQuality adds received bytes-related fields, including total received bytes, video data bytes, audio data bytes, and SEI data bytes.

   Related API please refer to: totalRecvBytes, videoRecvBytes, audioRecvBytes, seiRecvBytes

2. Added onResetPlayQuality callback interface

   When the player resets stream quality data, the onResetPlayQuality callback will be triggered and return the final stream quality data before the reset. This avoids the inability to obtain the final stream quality data with getPlayQuality.

   Related API please refer to: onResetPlayQuality

3. Added onRecvSEI callback interface

   When the player receives SEI data, this callback will be triggered.

   Related API please refer to: onRecvSEI

Bug Fixes

1. Fixed the issue where onplay callback was sometimes not triggered when calling the play method after calling the stop method and setting the URL address of the CDN live stream to be played through src.
2. Fixed the issue where played and QualityStats states were incorrect after calling the stop method.
3. Fixed the wasm.gz file decompression anomaly issue.
4. Fixed the issue where switching decoder abnormally failed after WebCodecs decoding failed.
5. Fixed the inaccurate download bitrate and decoding bitrate in QualityStats.

Version 1.3.0

Release Date: 2024-03-21

New Features

1. Support for getting stream playing quality

   Added the interface for getting stream playing quality getPlayQuality, facilitating developers to perform related business processing after receiving the stream playing quality callback.

2. Support for setting buffer Buffer

   When using the player plugin to play streams, it supports setting buffer Buffer to improve audio and video playback stability during network jitter.

   Related API please refer to setBufferInterval

Bug Fixes

1. Fixed the issue where the player plugin froze due to memory overflow when using soft decoding for a long time.

Version 1.2.0

Release Date: 2024-03-07

New Features

1. Support H.264 and H.265 MSE decoding

   Note:

   • MSE (Media Source Extensions) decoding does not support iOS mobile devices. When using on iOS mobile devices, it will automatically fall back to soft decoding for playback by default.
   • Some devices or browsers do not support H.265 MSE decoding and will automatically fall back to soft decoding for playback.

   The player plugin initialization configuration ZegoExpressPlayerConfig.decodeType parameter adds a new value "MSE", used to specify priority use of MSE decoding to play media resources.

   When the player decodes, it decodes and plays in the priority order of "WebCodecs hardware decoding > MSE hardware decoding > soft decoding". If the browser does not support a certain decoding method, it will automatically fall back to the next method.

Bug Fixes

1. Fixed the issue where there was no audio when rendering audio on some iOS devices due to the device's mute button affecting it.

Version 1.1.0

Release Date: 2023-12-27

New Features

1. Support H.264 and H.265 WebCodecs hardware decoding

   Note: This function supports use on Chrome browsers on PC and a few Android models. For some Chrome browsers that do not support H.265 WebCodecs hardware decoding, it will automatically fall back to soft decoding.

   If you integrate the player plugin in the Chrome browser on PC, it will prioritize using WebCodecs hardware decoding for playback by default. If you need to specify soft decoding, please manually modify the player plugin initialization configuration ZegoExpressPlayerConfig.decodeType.

Improvements and Optimizations

1. Optimized first frame time and frame drop strategy, resulting in lower average latency compared to previous versions.

2. Reduced the size of the compressed plugin package by 226 KB compared to previous versions.

Bug Fixes

1. Fixed the issue where audio automatically played occasionally when the Web page was in the hidden state.

Version 1.0.0

Release Date: 2023-10-19

ZEGO's self-developed Web player plugin was released for the first time, supporting playing CDN live video streams in H.265 and H.264 formats, while supporting common player control functions.