Web SDK release history - ApsaraVideo VOD - Alibaba Cloud Documentation Center

This topic describes the release history and feature changes of ApsaraVideo Player SDK for web.

Important

Starting from December 1, 2024, ApsaraVideo Player SDK for web versions 2.28.0 and later will enforce license verification. Ensure that you have purchased and integrated a license. If you have not purchased a license for ApsaraVideo Player SDK for web, visit the ApsaraVideo SDK purchase page. Select the software development kit (SDK) and feature modules based on your business needs. For instructions about how to authorize the SDK after purchase, see Integrate a license.

Note

ApsaraVideo Player SDK for web does not depend on any frontend JavaScript (JS) libraries. You only need to import the JS file of the corresponding version into your page to initialize and use the SDK. For more information, see Quick integration.
Starting from version 2.16.3, the paths for importing the JS and CSS resources of ApsaraVideo Player SDK for web have changed.
The paths have changed from:
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
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

2025-12-08

Date	Version	Modifications
2025-12-08	2.35.1	Supports native playback of HTTP Live Streaming (HLS) videos on Microsoft Edge 143 and later.

2025-12-04

Date	Version	Modifications
2025-12-04	2.35.0	Supports dynamically showing and hiding the control bar by calling the showControlBar() and hideControlBar() methods.

2025-11-21

Date	Version	Modifications
2025-11-21	2.34.6	Supports the mock full-screen feature on iOS. The parameter is `enableMockFullscreen`. Fixes known issues to improve player stability.

2025-11-06

Date	Version	Modifications
2025-11-06	2.34.5	Fixes a cross-domain compatibility issue with the latest version of Firefox.

2025-10-29

Date	Version	Modifications
2025-10-29	2.34.4	Fixes an HLS compatibility issue with Chrome 141 and later.

2025-10-24

Date	Version	Modifications
2025-10-24	2.34.3	Fixes a compatibility error that occurs in uni-app under Vue 3 mode. Fixes an issue where the event for showing or hiding the control bar is triggered unexpectedly. Fixes known issues to improve player stability.

2025-08-27

Date	Version	Modifications
2025-08-27	2.34.0	Supports dynamically obtaining built-in UI components. You can call the getBuildInComponent() method to control the visibility of components.

2025-08-18

Date	Version	Modifications
2025-08-18	2.33.1	Fixes known issues to improve player stability.

2025-08-08

Date	Version	Modifications
2025-08-08	2.33.0	Supports the new version of the playback quality monitoring feature. Fixes an issue where Safari does not report an error when a video URL is invalid. Fixes an issue where you must click twice to pull Real-Time Streaming (RTS) streams on earlier versions of iOS browsers.

2025-07-03

Date	Version	Modifications
2025-07-03	2.32.0	Supports custom proxy domain names for ApsaraVideo VOD. Improves the accuracy of instrumentation data reporting.

2025-06-09

Date	Version	Modifications
2025-06-09	2.31.0	Enables the new log reporting feature. Upgrades the HLS playback kernel to improve playback stability. Fixes known issues.

2025-04-24

Date	Version	Modifications
2025-04-24	2.30.3	Adds compatibility for an advanced operator syntax. If you import the SDK using npm and encounter a syntax error at compile-time, upgrade to this version.

2025-04-22

Date	Version	Modifications
2025-04-22	2.30.2	Fixes an issue where resolution switching occasionally fails. Fixes a bug where the click-to-pause and double-click-to-skip features cannot be used at the same time.

2025-04-14

Date	Version	Modifications
2025-04-14	2.30.0	Improves the success rate of dragging the progress bar on mobile devices. Supports the long-press-to-change-playback-speed feature on mobile devices. Supports the double-click-to-fast-forward or double-click-to-fast-backward feature on mobile devices.

2025-03-10

Date	Version	Modifications
2025-03-10	2.29.2	Fixes known issues.

2025-02-13

Date	Version	Modifications
2025-02-13	2.29.1	Supports MediaService DRM. Optimizes caption display.

2024-12-31

Date	Version	Modifications
2024-12-31	2.28.5	Improves compatibility with the H.266 encoding format. Fixes an issue where the getDuration method returns an inaccurate value.

2024-12-11

Date	Version	Modifications
2024-12-11	2.28.3	Fixes a compatibility issue in uni-app.

2024-12-10

Date	Version	Modifications
2024-12-10	2.28.2	Fixes an issue where license verification for a domain name fails. Fixes an issue where the playback speed is displayed incorrectly after you switch the video.

2024-11-29

Date	Version	Modifications
2024-11-29	2.28.0	Supports double-clicking to enter full screen mode. The getPlayTime method supports obtaining the actual playback duration. Enables license verification. Improves the type compatibility of the seek parameter.

2024-11-12

Date	Version	Modifications
2024-11-12	2.27.1	Fixes an issue where skinLayoutIgnore may affect other instances. Fixes a compatibility issue with reactive data in Vue 2.

2024-10-24

Date	Version	Modifications
2024-10-24	2.27.0	Supports playback of a specified time range. Supports the snapshot API. Fixes known issues.

2024-10-17

Date	Version	Modifications
2024-10-17	2.26.2	Fixes an issue where swScript may fail the verification.

2024-09-25

Date	Version	Modifications
2024-09-25	2.26.1	Supports encrypted playback of on-demand videos using Alibaba Cloud proprietary cryptography on browsers for iOS versions earlier than 17.1. (For more information, see ApsaraVideo Player for web.) Supports data internationalization. The env parameter is added. Supports the adaptive width and height feature. The autoSize parameter is added. Enables the click-to-pause or click-to-play feature by default on PCs. (clickPause: true) Supports the npm package. (aliyun-aliplayer) Fixes known issues.

2024-08-19

Date	Version	Modifications
2024-08-19	2.26.0	Supports encrypted playback of videos using Alibaba Cloud proprietary cryptography on mobile browsers. (For more information, see H5 feature compatibility.) Supports FLV and HLS live streams that use H.266 encoding. Fixes known issues.

2024-07-26

Date	Version	Modifications
2024-07-26	2.25.1	Optimizes the display of multiple bitrate levels.

2024-07-22

Date	Version	Modifications
2024-07-22	2.25.0	Supports seamless fallback for RTS. Optimizes the handling of decoding errors. Supports specifying the format for source-based playback.

2024-07-01

Date	Version	Modifications
2024-07-01	2.24.1	Fixes an issue where the progress bar does not update after you drag the progress bar to seek a position on a mobile device. Improves the seeking accuracy of the progress bar.

2024-06-24

Date	Version	Modifications
2024-06-24	2.24.0	Supports DASH live streaming. Optimizes the display of the play button when you exit the full-screen mode during live streaming on iOS.

2024-06-11

Date	Version	Modifications
2024-06-11	2.23.1	Fixes an issue where seeking by clicking the progress bar is inaccurate if progress markers are present.

2024-05-31

Date	Version	Modifications
2024-05-31	2.23.0	Adds the `skinLayoutIgnore` parameter to allow you to easily hide UI components. For more information, see Configure the skinLayout property. Adds the `disableSeek` parameter in H5 mode to disable dragging of the progress bar. For more information, see Aliplayer API reference. Fixes an issue where the `player.off` method may remove multiple callback functions. Fixes an issue where Safari may not report an error when a 404 error occurs on a request to play an HLS URL.

2024-05-09

Date	Version	Modifications
2024-05-09	2.22.0	Adds support for adaptive muted autoplay. For more information, see the `autoplayPolicy` property in Aliplayer API reference. Optimizes the efficiency of automatic fallback for RTS playback. Adds the `videoUnavailable` event. This event is triggered when a black screen occurs because the video encoding format, such as H.265, is not supported. Optimizes DRM support detection. Fixes an issue where an error is reported if `dispose` is called immediately after initialization. Fixes an issue where the progress bar is inaccurate if the `transform` style is applied to the outer layer of the player.

2024-04-02

Date	Version	Modifications
2024-04-02	2.21.0	Enables the new HLS kernel by default. If you encounter issues, you can pass `useHls2: false` to switch back to the old kernel. Optimizes the prompt that appears when a JS submodule fails to load. Fixes an issue where Safari continuously retries to play an HLS URL after a 404 error occurs.

2024-02-27

Date	Version	Modifications
2024-02-27	2.20.3	Supports muted autoplay. Supports clicking the screen to play or pause a video. Optimizes the startup speed for FLV and HLS videos. Fixes an issue where the logo image cannot be repositioned when the video size changes.

2024-02-04

Date	Version	Modifications
2024-02-04	2.20.2	Supports playback of videos that use the H.266 encoding format. For more information, see Play video streams that use the H.265 or H.266 protocol.

2024-01-19

Date	Version	Modifications
2024-01-19	2.20.1	Fixes an issue where automatic retry for RTS may fail.

2024-01-12

Date	Version	Modifications
2024-01-12	2.20.0	Supports setting a custom logo image on the screen. For more information, see the `setLogo` method and the `logo` property in Aliplayer API reference. Supports disabling the Picture-in-Picture (PiP) button in Firefox. Firefox 116 or later is required. Supports the `autoplay` event. For more information, see Events. Updates the RTS SDK to support RTS on more browsers.

2023-12-01

Date	Version	Modifications
2023-12-01	2.19.0	Supports custom playback speed lists. You can specify the list using the speedLevels parameter. Supports modifying the built-in Chinese and English text of the player SDK. For example, you can customize the display text for the definition list using the extLanguageTexts parameter. Supports scaling the player at a fixed ratio. You can specify the ratio using the ratio parameter. Optimizes an issue where the thumbnail of an ApsaraVideo VOD video may flicker during playback. Fixes an issue where the ended event may be triggered twice after playback is complete on an iOS device.

2023-11-02

Date	Version	Modifications
2023-11-02	2.18.1	Fixes an issue where seeking is inaccurate if a specific CSS style is added to the HTML tag. Fixes an issue where seeking fails on iOS 16 devices when preload is enabled.

2023-10-26

Date	Version	Modifications
2023-10-26	2.18.0	Optimizes the FLV live streaming experience. Improves SEI compatibility. Fixes an issue where playback of multi-bitrate videos that are packaged with Alibaba Cloud proprietary cryptography fails if no accelerated domain name is configured.

2023-09-20

Date	Version	Modifications
2023-09-20	2.17.1	Adds the active/standby switchover feature for ApsaraVideo VOD server domain names for Vid-based playback to improve usability. Optimizes the error message page. Supports RTS playback for Real-Time Streaming on the WeChat browser for PC.

2023-08-25

Date	Version	Modifications
2023-08-25	2.16.5	Adds an automatic playback recovery mechanism after a decoding failure to improve the playback success rate. Fixes some known issues.

2023-07-20

Date	Version	Modifications
2023-07-20	2.16.3	New paths are used to import the JS and CSS resources of ApsaraVideo Player SDK for web. For more information, see Quick integration. Fixes some known issues.

2023-06-30

Date	Version	Modifications
2023-06-30	2.16.1	Adds the `rtsTraceId` event. This event is triggered when an RTS stream is successfully pulled. You can subscribe to this event to obtain the RTS TraceId. For more information, see Aliplayer API reference. Fixes some known issues.

2023-06-07

Date	Version	Modifications
2023-06-07	2.15.7	Supports playback of HLS video streams that use H.265 encoding. Adds the `settingSelected` event. This event is triggered when an item in a settings list, such as playback speed, definition, or captions, is selected. Fixes some known issues.

2023-05-10

Date	Version	Modifications
2023-05-10	2.15.6	Supports error prompts and callbacks for on-demand HLS URLs that are blocked by the Location Blacklist feature. Fixes some known issues.

2023-02-14

Date	Version	Modifications
2023-02-14	2.15.2	Supports error prompts and callbacks for RTS and HLS stream pulling URLs that are blocked by the Location Blacklist feature. Fixes some known issues.

2023-02-01

Date	Version	Modifications
2023-02-01	2.15.0	Supports playback of FLV video streams that use H.265 encoding. To use this feature, fill out a form to request a license. Fixes some known issues.

2023-01-04

Date	Version	Modifications
2023-01-04	2.14.0	Supports playback of MP4 video streams that use H.265 encoding. To use this feature, fill out a form to request a license. Fixes some known issues.

2022-11-02

Date	Version	Modifications
2022-11-02	2.13.2	Optimizes the npm import method to be compatible with server-side rendering (SSR) environments. Fixes some known issues.

2022-09-14

Date	Version	Modifications
2022-09-14	2.12.1	Fixes some known issues.

2022-09-08

Date	Version	Modifications
2022-09-08	2.12.0	Supports external captions in VTT format. For more information, see External captions. Fixes some known issues. Note Incompatible update: The return value of the caption service method `player._ccService.open()` has been changed from a string to an object that contains two properties: `language` (the srclang of the current caption) and `label` (the display name of the current caption).

2022-08-17

Date	Version	Modifications
2022-08-17	2.11.0	Supports caption switching for multi-bitrate streams that are encrypted using ApsaraVideo VOD DRM encryption.

2022-08-04

Date	Version	Modifications
2022-08-04	2.10.0	Supports passing a traceId for public instrumentation. Fixes some known issues.

2022-07-14

Date	Version	Modifications
2022-07-14	2.9.23	Supports automatic fallback for RTS playback. Supports clicking the volume icon to mute the sound. Fixes some known issues.

2022-07-04

Date	Version	Modifications
2022-07-04	2.9.22	Adds quality instrumentation for RTS. Supports detailed error prompts when an M3U8 video fails to load. Fixes some known issues.

2022-05-16

Date	Version	Modifications
2022-05-16	2.9.21	Fixes some known issues.

2022-04-25

Date	Version	Modifications
2022-04-25	2.9.20	Fixes some known issues.

2022-01-14

Date	Version	Modifications
2022-01-14	2.9.19	Optimizes the time shifting feature for live streaming. Fixes some known issues.

2022-01-13

Date	Version	Modifications
2022-01-13	2.9.18	Supports adaptive bitrate streaming for Low-Latency HTTP Live Streaming (LL-HLS).

2021-12-22

Date	Version	Modifications
2021-12-22	2.9.17	Supports LL-HLS playback.

2021-11-23

Date	Version	Modifications
2021-11-23	2.9.16	Fixes known issues and prevents the video tag from being hijacked by UC Browser.

2021-11-08

Date	Version	Modifications
2021-11-08	2.9.14	Supports RTS stream pulling on the WeChat browser for Android 7.0.9 and later.

2021-10-26

Date	Version	Modifications
2021-10-26	2.9.13	Fixes some known issues.

2021-09-18

Date	Version	Modifications
2021-09-18	2.9.12	ApsaraVideo Player SDK for web supports two bitrate switching modes for multi-bitrate DRM video playback: Adaptive bitrate streaming. Manual switchover. Fixes some known issues.

2021-08-19

Date	Version	Modifications
2021-08-19	2.9.11	Allows the use of lazyLoad for FLV live streaming. Fixes some known issues.

2021-08-04

Date	Version	Modifications
2021-08-04	2.9.8	Fixes some known issues.

2021-07-09

Date	Version	Modifications
2021-07-09	2.9.7	Adds the getCurrentPDT method. For HLS videos, this method lets you obtain the Program-Date-Time in real time. Fixes some known issues.

2021-06-24

Date	Version	Modifications
2021-06-24	2.9.6	Supports DRM playback. Supports frame synchronization for FLV live streaming. Supports parsing of SEI information for FLV. The subscription event is seiFrame. Adds keyboard shortcuts. Adds statuses for the control bar. Fixes some known issues.

2020-12-31

Date	Version	Modifications
2020-12-31	2.9.3	Supports switching RTS streams using loadByUrl. Adds a retry mechanism for RTS stream pulling. Fixes some known issues.

2020-11-16

Date	Version	Modifications
2020-11-16	2.9.2	Supports the customTag field. The new parameter is customTag. Supports controlling the version of the loaded RTS SDK using a parameter. The new parameter is rtsVersion. Fixes some known issues.

2020-10-23

Date	Version	Modifications
2020-10-23	2.9.1	Supports RTS playback. Supports frame synchronization for HLS live streaming. Supports parsing of SEI information for HLS. The subscription event is seiFrame. Fixes some known issues.

2020-09-08

Date	Version	Modifications
2020-09-08	2.9.0	Adds a notification for resolution changes in live streaming scenarios. The new subscription event is resolutionChange. Supports the thumbnail feature for credential-based playback. Fixes some known issues.

2020-07-21

Date	Version	Modifications
2020-07-21	2.8.9	Supports HLS live stream encryption. Fixes some known issues.

2020-03-30

Date	Version	Modifications
2020-03-30	2.8.8	Fixes some known issues.

2019-12-11

Date	Version	Modifications
2019-12-11	2.8.7	Optimizes support for multi-bitrate HLS. Fixes some known issues.

2019-05-10

Date	Version	Modifications
2019-05-10	2.8.2	Supports the preview feature for on-demand videos in H5. Supports retries for failed on-demand video playback. Fixes some known issues.

2019-02-22

Date	Version	Modifications
2019-02-22	2.8.1	Supports progress markers in H5. Optimizes playback on WeChat. Optimizes STS-based playback. Fixes some known issues.

2019-01-11

Date	Version	Modifications
2019-01-11	2.8.0	Supports encrypted playback using Alibaba Cloud proprietary cryptography in H5. Optimizes the UI and seek operations. Fixes some known issues.

2018-11-29

Date	Version	Modifications
2018-11-29	2.7.4	Supports filtering by definition and specifying a default definition when you obtain media resource addresses using Vid+PlayAuth. Supports live captions. Supports playback of Web DRM videos. Fixes some known issues.

2018-08-16

Date	Version	Modifications
2018-08-16	2.7.2	Optimizes multi-bitrate switching for live streaming. The time shifting feature for live streaming supports the HLS and FLV protocols. You can switch to HLS to play back previous video content or switch to FLV to return to the live broadcast. Allows the control bar to be hidden after a countdown when you hover the mouse pointer over the full screen. Fixes some known issues.

2018-06-25

Date	Version	Modifications
2018-06-25	2.7.1	Fixes an issue with HLS video playback on WeChat for Android.

2018-06-18

Date	Version	Modifications
2018-06-18	2.7.0	Supports multiple captions, multiple audio tracks, and thumbnails. Supports language customization. Supports standard encrypted playback in Flash. Provides a new player UI.

2018-03-16

Date	Version	Modifications
2018-03-16	2.6.0	Supports source-based playback mode with multiple definitions. Supports MP3 playback using Vid. Supports rotation and mirroring. Fixes some known issues.

2018-03-05

Date	Version	Modifications
2018-03-05	2.5.1	Optimizes error prompts. Fixes some known issues.

2018-01-09

Date	Version	Modifications
2018-01-09	2.5.0	Supports STS-based playback. Modifies the H5 player UI. Implements the time shifting feature for live streaming. Fixes some known issues.

2017-12-06

Date	Version	Modifications
2017-12-06	2.4.0	Prompts you to switch to a lower definition when the network connection is poor. Modifies definition matching for MTS-based playback. Provides a method to query the current playback status. Adds a drag event. Provides a full-screen operation service. Fixes an issue where an error is not caught when the token expires in the Flash player.

2017-11-23

Date	Version	Modifications
2017-11-23	2.3.5	Supports HTTPS. Fixes some known issues.

2017-11-17

Date	Version	Modifications
2017-11-17	2.3.0	Supports FLV playback in H5. For more information, see FLV playback. Supports setting watermarks for snapshots in H5. For more information, see Watermark settings. Provides an implementation of custom component plugins. For more information, see Implementation of custom components. Fixes some known issues.