ApsaraVideo Player Web SDK release notes-ApsaraVideo VOD(VOD)-阿里云帮助中心

Important

ApsaraVideo Player SDK for web became commercially available on February 14, 2025 and enforces license validation since December 1, 2024. Upgrade to version 2.29.1 or later to avoid disruption. Purchase a license from the Audio and Video Terminal SDK purchase page, then follow Integrate a license to configure it.
Newly purchased Standard Edition licenses for the Player SDK Web client support only version 2.29.1 and later. Confirm your current SDK version before purchasing.

Note

The ApsaraVideo Player SDK for web has no frontend library dependencies. Import the JavaScript file to initialize it. Quick integration.
Starting with version 2.16.3, the SDK uses new paths for JavaScript and CSS resources.

Original:

CSS: https://g.alicdn.com/de/prismplayer/version number/skins/default/aliplayer-min.css

JS: https://g.alicdn.com/de/prismplayer/version number/aliplayer-min.js

Change to:

CSS: https://g.alicdn.com/apsara-media-box/imp-web-player/version number/skins/default/aliplayer-min.css

JS: https://g.alicdn.com/apsara-media-box/imp-web-player/version number/aliplayer-min.js

March 17, 2026

Date	Version	Changes
March 17, 2026	2.37.0	Add resume playback and tiled menu mode. Fix known issues and improve player stability.

March 4, 2026

Date	Version	Changes
March 4, 2026	2.36.0	Support dynamic watermarks.

February 26, 2026

Date	Version	Changes
February 26, 2026	2.35.9	Optimize the HLS core for better compatibility. Fix leftover items in secondary menus on mobile devices.

February 3, 2026

Date	Version	Changes
February 3, 2026	2.35.7	Resolve circular dependency issues when external parameters are passed.

December 8, 2025

Date	Version	Changes
December 8, 2025	2.35.1	Support native HLS playback in Edge 143 and later.

December 4, 2025

Date	Version	Changes
December 4, 2025	2.35.0	Support dynamic display and hiding of the control bar using showControlBar() and hideControlBar().

November 21, 2025

Date	Version	Changes
November 21, 2025	2.34.6	Support pseudo-full-screen on iOS. Use the `enableMockFullscreen` parameter. Fix known issues and improve player stability.

November 6, 2025

Date	Version	Changes
November 6, 2025	2.34.5	Fix cross-domain compatibility issues in newer Firefox versions.

October 29, 2025

Date	Version	Changes
October 29, 2025	2.34.4	Fix HLS compatibility issues in Chrome 141 and later.

October 24, 2025

Date	Version	Changes
October 24, 2025	2.34.3	Fix compatibility errors in uni-app Vue 3 mode. Fix abnormal triggering of control bar show/hide events. Fix known issues and improve player stability.

August 27, 2025

Date	Version	Changes
August 27, 2025	2.34.0	Support dynamic access to built-in UI components. Call getBuildInComponent() to control component visibility.

August 18, 2025

Date	Version	Changes
August 18, 2025	2.33.1	Fix known issues and improve player stability.

August 8, 2025

Date	Version	Changes
August 8, 2025	2.33.0	Support new playback quality monitoring features. Fix Safari browsers not reporting errors when video URLs are invalid. Fix double-tap requirement for RTS stream pulling on older iOS browsers.

July 3, 2025

Date	Version	Changes
July 3, 2025	2.32.0	Support custom VOD proxy domain names. Improve accuracy of instrumentation uploads.

June 9, 2025

Date	Version	Changes
June 9, 2025	2.31.0	Enable new log reporting. Upgrade the HLS playback core to improve stability. Fix known issues.

April 24, 2025

Date	Version	Changes
April 24, 2025	2.30.3	Fix syntax errors caused by advanced operators. If you use npm and encounter syntax errors during compilation, upgrade to this version.

April 22, 2025

Date	Version	Changes
April 22, 2025	2.30.2	Fix occasional failures of resolution switching. Fix conflicts between pause-on-click and skip-on-double-click functions.

April 14, 2025

Date	Version	Changes
April 14, 2025	2.30.0	Improve drag success rate for the progress bar on mobile devices. Support long-press to adjust playback speed on mobile devices. Support double-click to fast forward or rewind on mobile devices.

March 10, 2025

Date	Version	Changes
March 10, 2025	2.29.2	Fix known issues.

February 13, 2025

Date	Version	Changes
February 13, 2025	2.29.1	Support MediaService DRM. Improve subtitle display.

December 31, 2024

Date	Version	Changes
December 31, 2024	2.28.5	Improve compatibility with H.266 encoding. Fix inaccurate return values from the getDuration method.

December 11, 2024

Date	Version	Changes
December 11, 2024	2.28.3	Fix compatibility issues in uni-app.

December 10, 2024

Date	Version	Changes
December 10, 2024	2.28.2	Fix license validation failures due to incorrect domain names. Fix incorrect playback speed display after switching videos.

November 29, 2024

Date	Version	Changes
November 29, 2024	2.28.0	Support double-click to enter full screen. getPlayTime returns the actual playback duration. Enable license validation. Improve type compatibility for seek parameters.

November 12, 2024

Date	Version	Changes
November 12, 2024	2.27.1	Fix skinLayoutIgnore affecting other player instances. Fix compatibility issues with Vue 2 reactive data.

October 24, 2024

Date	Version	Changes
October 24, 2024	2.27.0	Support playback within a specified time range. Support screenshot APIs. Fix known issues.

October 17, 2024

Date	Version	Changes
October 17, 2024	2.26.2	Fix potential swScript validation failures.

September 25, 2024

Date	Version	Changes
September 25, 2024	2.26.1	Support private encryption for on-demand videos on iOS browsers earlier than iOS 17.1. ApsaraVideo Player. Support data internationalization. New parameter: env. Support automatic sizing. New parameter: autoSize. Enable click-to-pause/play by default on desktop. Parameter: clickPause: true. Support npm packages. See aliyun-aliplayer. Fix known issues.

August 19, 2024

Date	Version	Changes
August 19, 2024	2.26.0	Support private encryption for video playback on mobile browsers. H5 feature adaptation guide. Support H.266-encoded FLV and HLS live streaming. Fix known issues.

July 26, 2024

Date	Version	Changes
July 26, 2024	2.25.1	Improve display of multi-bitrate options.

July 22, 2024

Date	Version	Changes
July 22, 2024	2.25.0	Support seamless downgrade for Real-Time Streaming (RTS). Improve error handling for decoding failures. Support specifying the format when playing source files.

July 1, 2024

Date	Version	Changes
July 1, 2024	2.24.1	Fix progress bar updates failing after seeking on mobile devices. Improve seek precision for the progress bar.

June 24, 2024

Date	Version	Changes
June 24, 2024	2.24.0	Support DASH live streaming. Improve playback button display when exiting full screen on iOS.

June 11, 2024

Date	Version	Changes
June 11, 2024	2.23.1	Fix incorrect seek positions when clicking the progress bar with markers enabled.

May 31, 2024

Date	Version	Changes
May 31, 2024	2.23.0	Add the `skinLayoutIgnore` parameter to hide UI components more easily. Configure the skinLayout property. In H5 mode, add the `disableSeek` parameter to disable progress bar dragging. Aliplayer API reference. Fix `player.off` potentially removing multiple callback functions. Fix Safari not reporting errors when requesting an HLS URL that returns 404.

May 9, 2024

Date	Version	Changes
May 9, 2024	2.22.0	Add support for adaptive mute autoplay. Use the `autoplayPolicy` property in the Aliplayer API reference. Improve efficiency of automatic RTS downgrade. Add the `videoUnavailable` event. This event triggers when unsupported video encodings (such as H.265) cause a black screen. Improve DRM capability detection. Fix errors when calling `dispose` immediately after initialization. Fix inaccurate progress bar behavior when the player's outer container uses the `transform` CSS property.

April 2, 2024

Date	Version	Changes
April 2, 2024	2.21.0	Enable the new HLS core by default. If issues occur, pass `useHls2: false` to revert to the legacy core. Improve error messages when loading JavaScript submodules fails. Fix Safari endlessly retrying when requesting an HLS URL that returns 404.

February 27, 2024

Date	Version	Changes
February 27, 2024	2.20.3	Support muted autoplay. Support click-to-play or pause. Improve startup speed for FLV and HLS videos. Fix logo repositioning issues when video dimensions change.

February 4, 2024

Date	Version	Changes
February 4, 2024	2.20.2	Support playback of H.266-encoded videos. Playback of H.265/H.266 encoded video streams.

January 19, 2024

Date	Version	Changes
January 19, 2024	2.20.1	Fix possible failures of automatic RTS retries.

January 12, 2024

Date	Version	Changes
January 12, 2024	2.20.0	Support custom logo images in the player. Use the `setLogo` method and `logo` property in the Aliplayer API reference. Support disabling the Picture-in-Picture (PiP) button in Firefox browsers (Firefox 116 or later required). Support the `autoplay` event. Events. Update the RTS SDK version to support more browsers for ultra-low-latency streaming.

December 1, 2023

Date	Version	Changes
December 1, 2023	2.19.0	Support custom playback speed lists using the speedLevels parameter. Support customizing built-in English and Chinese text, such as resolution list labels, using the extLanguageTexts parameter. Support fixed-ratio scaling using the ratio parameter. Improve flickering issues with VOD thumbnails during playback. Fix duplicate ended events on iOS after playback completion.

November 2, 2023

Date	Version	Changes
November 2, 2023	2.18.1	Fix inaccurate seeking when specific CSS styles are applied to HTML elements. Fix seek failures on iOS 16 devices in preload mode.

October 26, 2023

Date	Version	Changes
October 26, 2023	2.18.0	Improve FLV live streaming experience. Improve SEI compatibility. Fix playback failures for multi-bitrate privately encrypted packaged videos when no accelerated domain name is configured.

September 20, 2023

Date	Version	Changes
September 20, 2023	2.17.1	Add primary and backup domain switching for VOD server domains in Vid playback mode to improve usability. Improve error message pages. Support Real-Time Streaming (RTS) playback in WeChat for PC.

August 25, 2023

Date	Version	Changes
August 25, 2023	2.16.5	Add automatic recovery after decoding failures to improve playback success rates. Fix known issues.

July 20, 2023

Date	Version	Changes
July 20, 2023	2.16.3	The ApsaraVideo Player SDK for web uses new paths for JavaScript and CSS resources. Quick integration. Fix known issues.

June 30, 2023

Date	Version	Changes
June 30, 2023	2.16.1	Add the `rtsTraceId` event. Triggers when RTS stream pulling succeeds. Subscribe to retrieve the RTS TraceId. Aliplayer API reference. Fix known issues.

June 20, 2023

Date

Version

Changes

June 20, 2023

2.16.0

Add support for playback quality monitoring and single-point troubleshooting. To enable these features, fill out the form.

Playback quality monitoring lets you view playback metrics such as play counts in the ApsaraVideo VOD console. Playback quality monitoring (legacy).
Single-point troubleshooting lets you query user playback behavior in the ApsaraVideo VOD console to quickly locate playback issues. Single-point troubleshooting.

June 7, 2023

Date	Version	Changes
June 7, 2023	2.15.7	Support playback of H.265-encoded HLS video streams. Add the `settingSelected` event. This event triggers when users select an option in settings menus (playback speed, resolution, captions, etc.). Fix known issues.

May 10, 2023

Date	Version	Changes
May 10, 2023	2.15.6	For Geo-blocking-protected VOD HLS URLs, the player now provides appropriate error messages and callbacks. Fix known issues.

February 14, 2023

Date	Version	Changes
February 14, 2023	2.15.2	For Geo-blocking-protected RTS and HLS stream URLs, the player now provides appropriate error messages and callbacks. Fix known issues.

February 1, 2023

Date	Version	Changes
February 1, 2023	2.15.0	Support playback of H.265-encoded FLV video streams. To enable this feature, fill out the form to request a license. Fix known issues.

January 4, 2023

Date	Version	Changes
January 4, 2023	2.14.0	Support playback of H.265-encoded MP4 video streams. To enable this feature, fill out the form to request a license. Fix known issues.

November 2, 2022

Date	Version	Changes
November 2, 2022	2.13.2	Improve npm integration to support SSR environments. Fix known issues.

September 14, 2022

Date	Version	Changes
September 14, 2022	2.12.1	Fix known issues.

September 8, 2022

Date	Version	Changes
September 8, 2022	2.12.0	Support external VTT subtitles. External subtitles. Support subtitles configured through the Generic Media Management service. Fix known issues. Note Incompatible update: The return value of the subtitle service method `player._ccService.open()` changed from a string to an object containing two properties: language (the srclang of the current subtitle) and label (the display name of the current subtitle).

August 17, 2022

Date	Version	Changes
August 17, 2022	2.11.0	Support subtitle switching for multi-bitrate streams encrypted by ApsaraVideo VOD DRM.

August 4, 2022

Date	Version	Changes
August 4, 2022	2.10.0	Support mediaAuth playback using credentials from the Generic Media Management service. Support passing traceId as a common instrumentation parameter. Fix known issues.

July 14, 2022

Date	Version	Changes
July 14, 2022	2.9.23	Support automatic RTS downgrade. Support one-click mute by clicking the volume icon. Fix known issues.

July 4, 2022

Date	Version	Changes
July 4, 2022	2.9.22	Add RTS quality instrumentation. Provide detailed error messages when M3U8 video loading fails. Fix known issues.

May 16, 2022

Date	Version	Changes
May 16, 2022	2.9.21	Fix known issues.

April 25, 2022

Date	Version	Changes
April 25, 2022	2.9.20	Fix known issues.

January 14, 2022

Date	Version	Changes
January 14, 2022	2.9.19	Improve time shifting for live streaming. Fix known issues.

January 13, 2022

Date	Version	Changes
January 13, 2022	2.9.18	LL-HLS supports adaptive bitrate streaming.

December 22, 2021

Date	Version	Changes
December 22, 2021	2.9.17	Support LL-HLS playback.

November 23, 2021

Date	Version	Changes
November 23, 2021	2.9.16	Fix known issues and prevent UC Browser from hijacking the video element.

November 8, 2021

Date	Version	Changes
November 8, 2021	2.9.14	Support RTS stream pulling in Android WeChat browser (version 7.0.9 or later).

October 26, 2021

Date	Version	Changes
October 26, 2021	2.9.13	Fix known issues.

September 18, 2021

Date	Version	Changes
September 18, 2021	2.9.12	The ApsaraVideo Player SDK for web supports two bitrate switching methods for multi-bitrate DRM videos: Adaptive bitrate streaming. Manual bitrate switching. Fix known issues.

August 19, 2021

Date	Version	Changes
August 19, 2021	2.9.11	FLV live streaming supports lazyLoad. Fix known issues.

August 4, 2021

Date	Version	Changes
August 4, 2021	2.9.8	Fix known issues.

July 9, 2021

Date	Version	Changes
July 9, 2021	2.9.7	Add the getCurrentPDT method to retrieve the Program-Date-Time in real-time for HLS videos. Fix known issues.

June 24, 2021

Date	Version	Changes
June 24, 2021	2.9.6	Support DRM playback. Support frame synchronization for FLV live streaming. Support parsing SEI information for FLV. Subscribe to the seiFrame event. Add keyboard shortcuts. The status of the newly added control bar (controbar). Fix known issues.

December 31, 2020

Date	Version	Changes
December 31, 2020	2.9.3	Support loadByUrl switching for RTS streams. Add retry mechanism for RTS stream pulling. Fix known issues.

November 16, 2020

Date	Version	Changes
November 16, 2020	2.9.2	Support the customTag field. New parameter: customTag. Support controlling the loaded RTS SDK version. New parameter: rtsVersion. Fix known issues.

October 23, 2020

Date	Version	Changes
October 23, 2020	2.9.1	Support RTS playback. Support frame synchronization for HLS live streaming. Support parsing SEI information for HLS. Subscribe to the seiFrame event. Fix known issues.

September 8, 2020

Date	Version	Changes
September 8, 2020	2.9.0	Add resolutionChange event to notify of stream resolution changes in live streaming. Support thumbnails in credential-based playback. Fix known issues.

July 21, 2020

Date	Version	Changes
July 21, 2020	2.8.9	Support HLS live stream encryption. Fix known issues.

March 30, 2020

Date	Version	Changes
March 30, 2020	2.8.8	Fix known issues.

December 11, 2019

Date	Version	Changes
December 11, 2019	2.8.7	Improve HLS multi-bitrate support. Fix known issues.

May 10, 2019

Date	Version	Changes
May 10, 2019	2.8.2	Support VOD preview in H5. Support retry on failure for VOD. Fix known issues.

February 22, 2019

Date	Version	Changes
February 22, 2019	2.8.1	Support progress bar markers in H5. Improve WeChat playback. Improve STS playback. Fix known issues.

January 11, 2019

Date	Version	Changes
January 11, 2019	2.8.0	Support Alibaba Cloud proprietary cryptography in H5. Improve UI and seek operations. Fix known issues.

November 29, 2018

Date	Version	Changes
November 29, 2018	2.7.4	Support resolution filtering and default resolution selection when using vid+playauth to get media resource addresses. Support live stream captions. Support Web DRM video playback. Fix known issues.

August 16, 2018

Date	Version	Changes
August 16, 2018	2.7.2	Improve live stream multi-bitrate switching. Support time shifting for HLS and FLV live streams. Switch to HLS to rewind and to FLV to return to the live broadcast. The control bar can be hidden with a countdown on hover in full screen. Fix known issues.

June 25, 2018

Date	Version	Changes
June 25, 2018	2.7.1	Fix HLS video playback issues in Android WeChat.

June 18, 2018

Date	Version	Changes
June 18, 2018	2.7.0	Support multiple subtitles, audio tracks, and thumbnails. Support language customization. Support standard encrypted playback in Flash. New player UI.

March 16, 2018

Date	Version	Changes
March 16, 2018	2.6.0	Support multi-resolution source playback mode. Play MP3 files using Vid. Support rotation and mirroring. Fix known issues.

March 5, 2018

Date	Version	Changes
March 5, 2018	2.5.1	Improve error messages. Fix known issues.

January 9, 2018

Date	Version	Changes
January 9, 2018	2.5.0	Support STS playback. Update H5 player UI. Implement time shifting for live streaming. Fix known issues.

December 6, 2017

Date	Version	Changes
December 6, 2017	2.4.0	Prompt to switch to a lower resolution on poor networks. Update resolution matching for MTS playback. Provide a method to query the current playback status. Add drag events. Provide a full-screen operation service. Fix unhandled errors when Flash player tokens expire.

November 23, 2017

Date	Version	Changes
November 23, 2017	2.3.5	Support HTTPS. Fix known issues.

November 17, 2017

Date	Version	Changes
November 17, 2017	2.3.0	Support FLV playback in H5. FLV Playback. Support watermarks for H5 screenshots. Watermark Settings. Provide custom component plugins. Custom Component Implementation. Fix known issues.