All Products
Search
Document Center

ApsaraVideo VOD:Release notes for ApsaraVideo Player SDK for Web

Last Updated:Dec 16, 2024

This topic describes the release notes for ApsaraVideo Player SDK for Web.

Note
  • ApsaraVideo Player SDK for Web does not depend on frontend .js libraries. You need to only add the .js file of the corresponding version to your HTML document to initialize the player. For more information, see Quick integration.

  • The paths in which the JavaScript and CSS files are stored are changed for ApsaraVideo Player SDK for Web V2.16.3 or later.

    The old paths:

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

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

    The new paths:

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

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

2024-12-11

Release date

Version

Description

2024-12-11

2.28.3

  • The compatibility issue of uni-app is fixed.

2024-12-10

Release date

Version

Description

2024-12-10

2.28.2

  • The issue that the license-based domain name verification failed is fixed.

  • The issue that the playback speed is incorrect after a video is switched is fixed.

2024-11-29

Release date

Version

Description

2024-11-29

2.28.0

  • Double-click to full screen is supported.

  • The getPlayTime operation supports obtaining the playback duration.

  • License verification is enabled.

  • The type compatibility of the seek parameter is optimized.

2024-11-12

Release date

Version

Description

2024-11-12

2.27.1

  • The issue that the skinLayoutIgnore operation may affect other instances is fixed.

  • The compatibility issue of Vue 2 reactivity data is fixed.

2024-10-24

Release date

Version

Description

2024-10-24

2.27.0

  • Playback of a specific range is supported.

  • A screenshot operation is supported.

  • Specific known issues are fixed.

2024-10-17

Release date

Version

Description

2024-10-17

2.26.2

  • The issue that the SWScript verification failed is fixed.

2024-09-25

Release date

Version

Description

2024-09-25

2.26.1

  • Support for Alibaba Cloud proprietary cryptography is added on iOS 17.1 or earlier browsers. For more information, see Features of the HTML5 player supported by browsers.

  • The env parameter is added and data internationalization is supported.

  • The autoSize parameter is added and automatic rotation is supported.

  • The one-click play or pause feature is enabled by default on PC clients. Default setting: clickPause: true.

  • The node package manager (NPM) package aliyun-aliplayer is supported.

  • Specific known issues are fixed.

2024-08-19

Release date

Version

Description

2024-08-19

2.26.0

  • Videos encrypted by using Alibaba Cloud proprietary cryptography can be played in browsers on mobile devices. For more information, see Features of the HTML5 player supported by browsers.

  • H.266 Live streaming in the Flash Video (FLV) or HTTP Live Streaming (HLS) format is supported.

  • Specific known issues are fixed.

2024-07-26

Release date

Version

Description

2024-07-26

2.25.1

  • The playback of multi-bitrate video streams is optimized.

2024-07-22

Release date

Version

Description

2024-07-22

2.25.0

  • The seamless Real-Time Streaming (RTS) degradation feature is added.

  • The handling method of video decoding failures is optimized.

  • Format can be specified during the playback of source files.

2024-07-01

Release date

Version

Description

2024-07-01

2.24.1

  • The issue that the progress bar is not updated after you drag the progress handle to perform seeking is fixed.

  • The seeking accuracy is optimized.

2024-06-24

Release date

Version

Description

2024-06-24

2.24.0

  • Live streaming of Dynamic Adaptive Streaming over HTTP (DASH) is supported.

  • The display of the play button when you exit the full-screen mode on iOS devices during live streaming is optimized.

2024-06-11

Release date

Version

Description

2024-06-11

2.23.1

The issue that the seeking position in incorrect when you click on the progress bar that is marked is fixed.

2024-05-31

Release date

Version

Description

2024-05-31

2.23.0

  • The skinLayoutIgnore parameter is added. You can use this parameter to hide UI components. For more information, see Hide UI components.

  • The disableSeek parameter is added for HTML5 player. You can use this parameter to disable slider dragging on the progress bar. For more information, see API operations.

  • The issue that multiple callback functions are removed after you call the player.off method is fixed.

  • The issue that no error is reported when an HTTP status code 404 is returned after you play a video by using an HLS URL in Safari is fixed.

2024-05-09

Release date

Version

Description

2024-05-09

2.22.0

  • The adaptive mute autoplay feature is added. For more information, see the autoplayPolicy parameter described in the API operations topic.

  • The efficiency of playback over RTS by using a degraded protocol is optimized.

  • The videoUnavailable event is added. This event is triggered when black screen occurs due to unsupported video codec such as H.265.

  • The support check for Digital Rights Management (DRM) encryption is optimized.

  • The issue that an error occurs when you immediately call dispose after initialization is fixed.

  • The issue that the position of the progress handle does not accurately indicate the playback position when transform is configured for the player is fixed.

2024-04-02

Release date

Version

Description

2024-04-02

2.21.0

  • The new version of HLS kernel is added and enabled by default. If errors occur, you can specify useHls2: false to use the old version HLS kernel.

  • The error message returned when the .js module failed to be loaded is optimized.

  • The issue that an HTTP 404 status code is returned and the system continues to send retry requests when you play a video by using an HLS URL in Safari is fixed.

2024-02-27

Release date

Version

Description

2024-02-27

2.20.3

  • Autoplay in the mute mode is supported.

  • The play and pause operations can be performed by clicking on the video image.

  • The startup loading time of FLV and HLS videos is shortened.

  • The issue that the logo image cannot be relocated after the size of the video image is changed is fixed.

2024-02-04

Release date

Version

Description

2024-02-04

2.20.2

Playback of H.266 videos is supported. For more information, see Play H.265 or H.266 videos.

2024-01-19

Release date

Version

Description

2024-01-19

2.20.1

The issue that an automatic retry fails to be initiated upon a playback failure over RTS is fixed.

2024-01-12

Release date

Version

Description

2024-01-12

2.20.0

  • Custom logo images can be added to videos. For more information, see the setLogo method and logo property described in the API operations topic.

  • The picture in picture (PiP) feature can be disabled in Firefox V116 and later.

  • The autoplay event is supported. For more information, see Events.

  • The new version of RTS SDK is released to support low-latency live streaming on more browsers.

2023-12-01

Release date

Version

Description

2023-12-01

2.19.0

  • Custom playback speeds are supported. You can specify the speedLevels parameter to configure custom playback speeds.

  • Custom UI content is supported. You can specify the extLanguageTexts parameter to modify the UI text in ApsaraVideo Player SDK. For example, you can modify the names of the definitions.

  • Player resizing based on a specific aspect ratio is supported. You can specify the ratio parameter to resize the player.

  • Thumbnail flickering during video playback is fixed.

  • The issue that the ended event is triggered twice when video playback is complete on an iOS client is fixed.

2023-11-02

Release date

Version

Description

2023-11-02

2.18.1

  • The issue that video seeking is inaccurate when a CSS style is added to the HTML tag is fixed.

  • The issue that seeking operations fail when videos are being preloaded on iOS 16 is fixed.

2023-10-26

Release date

Version

Description

2023-10-26

2.18.0

  • The performance of FLV-based live streaming is improved.

  • The compatibility of supplemental enhancement information (SEI) is improved.

  • The issue that multi-bitrate packaged videos that are encrypted by using Alibaba Cloud proprietary cryptography cannot be played when no accelerated domain name is configured is fixed.

2023-09-20

Release date

Version

Description

2023-09-20

2.17.1

  • Domain name switchover is supported in ApsaraVideo Player when Vid-based playback is used. This improves the usability of the SDK.

  • The error message page is optimized.

  • Streams can be played over RTS in WeChat browser on PCs.

2023-08-25

Release date

Version

Description

2023-08-25

2.16.5

  • The playback can be resumed even if the decoding fails. This improves the success rate of video playback.

  • Specific known issues are fixed.

2023-07-20

Release date

Version

Description

2023-07-20

2.16.3

  • The paths in which JavaScript and CSS files are stored are changed for ApsaraVideo Player SDK for Web V2.16.3 or later. For more information, see Quick integration.

  • Specific known issues are fixed.

2023-06-30

Release date

Version

Description

2023-06-30

2.16.1

  • The rtsTraceId event is added. The event is triggered when a stream is pulled over RTS. You can listen for this event to obtain the TraceId. For more information, see API operations.

  • Specific known issues are fixed.

2023-06-07

Release date

Version

Description

2023-06-07

2.15.7

  • Playback of H.265 video streams in the HLS format is supported.

  • The settingSelected event is added. This event is triggered when playback settings such as speed, definition, and subtitle are changed.

  • Specific known issues are fixed.

2023-05-10

Release date

Version

Description

2023-05-10

2.15.6

  • Error messages and callbacks can be returned when you use the SDK to play HLS videos from blocked regions.

  • Specific known issues are fixed.

2023-02-14

Release date

Version

Description

2023-02-14

2.15.2

  • Error messages and callbacks can be returned for playback URLs in the RTS or HLS format that are inaccessible in specific regions.

  • Specific known issues are fixed.

2023-02-01

Release date

Version

Description

2023-02-01

2.15.0

  • Playback of H.265 videos in the FLV format is supported. You can submit a request on Yida to apply for a license.

  • Specific known issues are fixed.

2023-01-04

Release date

Version

Description

2023-01-04

2.14.0

  • Playback of H.265 videos in the MP4 format is supported. You can submit a request on Yida to apply for a license.

  • Specific known issues are fixed.

2022-11-02

Release date

Version

Description

2022-11-02

2.13.2

  • The import method for NPM packages is optimized and the server-side rendering (SSR) feature is supported.

  • Specific known issues are fixed.

2022-09-14

Release date

Version

Description

2022-09-14

2.12.1

Specific known issues are fixed.

2022-09-08

Release date

Version

Description

2022-09-08

2.12.0

  • External subtitles in the VTT format are supported. For more information, see Configure external subtitles.

  • Specific known issues are fixed.

Note

Incompatibility update: The return value of player._ccService.open() is changed from a string to an object that contains two attributes: language and label. language indicates srclang of the current subtitle. label indicates the display name of the current subtitle.

2022-08-17

Release date

Version

Description

2022-08-17

2.11.0

Subtitles in multi-bitrate streams encrypted by using DRM encryption can be switched.

2022-08-04

Release date

Version

Description

2022-08-04

2.10.0

  • traceId is added as a request parameter.

  • Specific known issues are fixed.

2022-07-14

Release date

Version

Description

2022-07-14

2.9.23

  • Automatic playback degradation is supported by RTS.

  • The volume icon can be clicked to mute the video.

  • Specific known issues are fixed.

2022-07-04

Release date

Version

Description

2022-07-04

2.9.22

  • Quality tracking points are added for RTS.

  • Error details can be displayed for loading failures of M3U8 videos.

  • Specific known issues are fixed.

2022-05-16

Release date

Version

Description

2022-05-16

2.9.21

  • Specific known issues are fixed.

2022-04-25

Release date

Version

Description

2022-04-25

2.9.20

Specific known issues are fixed.

2022-01-14

Release date

Version

Description

2022-01-14

2.9.19

  • The time shifting feature during live streaming is improved.

  • Specific known issues are fixed.

2022-01-13

Release date

Version

Description

2022-01-13

2.9.18

Adaptive bitrate streaming is supported for Low-Latency HTTP Live Streaming (LL-HLS).

2021-12-22

Release date

Version

Description

2021-12-22

2.9.17

LL-HLS is supported.

2021-11-23

Release date

Version

Description

2021-11-23

2.9.16

The issue that the video tag is hijacked by UC Browser is fixed.

2021-11-08

Release date

Version

Description

2021-11-08

2.9.14

Stream pulling over RTS is supported for the built-in browser of WeChat for Android V7.0.9 and later.

2021-10-26

Release date

Version

Description

2021-10-26

2.9.13

Specific known issues are fixed.

2021-09-18

Release date

Version

Description

2021-09-18

2.9.12

  • The following bitrate switching methods for the playback of DRM-encrypted videos that use different bitrates are supported:

    • Adaptive bitrate

    • Manual switching

  • Specific known issues are fixed.

2021-08-19

Release date

Version

Description

2021-08-19

2.9.11

  • LazyLoad is supported for FLV live streams.

  • Specific known issues are fixed.

2021-08-04

Release date

Version

Description

2021-08-04

2.9.8

Specific known issues are fixed.

2021-07-09

Release date

Version

Description

2021-07-09

2.9.7

  • The getCurrentPDT method is added for HLS videos to obtain the value of ProgramDateTime in real time.

  • Specific known issues are fixed.

2021-06-24

Release date

Version

Description

2021-06-24

2.9.6

  • DRM playback is supported.

  • Frame synchronization is supported for FLV live streams.

  • The seiFrame event can be subscribed to. This allows you to obtain SEI from FLV videos.

  • Keyboard shortcuts are added.

  • The status of the control bar is added.

  • Specific known issues are fixed.

2020-12-31

Release date

Version

Description

2020-12-31

2.9.3

  • loadByUrl can be called to switch between the streaming URLs of RTS streams.

  • Repeated stream pulling is supported for RTS streams.

  • Specific known issues are fixed.

2020-11-16

Release date

Version

Description

2020-11-16

2.9.2

  • The customTag parameter is added.

  • The rtsVersion parameter is added to allow you to specify the version of the RTS SDK that you want to load.

  • Specific known issues are fixed.

2020-10-23

Release date

Version

Description

2020-10-23

2.9.1

  • Playback of RTS streams is supported.

  • Frame synchronization is supported for HLS live streams.

  • The seiFrame event can be subscribed to. This allows you to obtain SEI from HLS videos.

  • Specific known issues are fixed.

2020-09-08

Release date

Version

Description

2020-09-08

2.9.0

  • The resolutionChange event can be subscribed to. This allows you to receive notifications when the video resolution is changed during live streaming.

  • The thumbnail feature is supported when the cursor is hovered over the progress bar of a video that is played by video ID.

  • Specific known issues are fixed.

2020-07-21

Release date

Version

Description

2020-07-21

2.8.9

  • HLS-based encrypted live streaming is supported.

  • Specific known issues are fixed.

2020-03-30

Release date

Version

Description

2020-03-30

2.8.8

Specific known issues are fixed.

2019-12-11

Release date

Version

Description

2019-12-11

2.8.7

  • The playback of HLS streams with different bitrates is improved.

  • Specific known issues are fixed.

2019-05-10

Release date

Version

Description

2019-05-10

2.8.2

  • The preview feature is supported by the HTML5 player.

  • Playback retry is supported for on-demand videos that failed to be played.

  • Specific known issues are fixed.

2019-02-22

Release date

Version

Description

2019-02-22

2.8.1

  • The progress bar in the HTML5 player can be marked.

  • The playback in WeChat is improved.

  • Security Token Service (STS)-based playback is improved.

  • Specific known issues are fixed.

2019-01-11

Release date

Version

Description

2019-01-11

2.8.0

  • Videos that are encrypted by using Alibaba Cloud proprietary cryptography can be played by the HTML5 player.

  • The UI and seeking feature are improved.

  • Specific known issues are fixed.

2018-11-29

Release date

Version

Description

2018-11-29

2.7.4

  • The media URL can be obtained by using the vid and playauth parameters. Resolutions can be filtered and the default resolution can be specified.

  • Live subtitles can be configured.

  • DRM-based playback in web browsers is supported.

  • Specific known issues are fixed.

2018-08-16

Release date

Version

Description

2018-08-16

2.7.2

  • Switching between multi-bitrate live streams is optimized.

  • Switching between the FLV and HLS protocols during time shifting is supported. To return to a previous video, switch to the HLS protocol. To return to the current stream, switch to the FLV protocol.

  • The control bar can be hidden after the cursor remains idle for a specific period of time in full-screen mode.

  • Specific known issues are fixed.

2018-06-25

Release date

Version

Description

2018-06-25

2.7.1

The playback issues of HLS videos in WeChat for Android are fixed.

2018-06-18

Release date

Version

Description

2018-06-18

2.7.0

  • Multiple subtitles, audio tracks, and thumbnails are supported.

  • The language can be changed.

  • Playback of HLS-encrypted videos is supported by the Flash player.

  • The player UI is updated.

2018-03-16

Release date

Version

Description

2018-03-16

2.6.0

  • The playback of sources that use multiple resolutions is supported.

  • The playback of MP3 files by VID is supported.

  • Rotation and mirroring features are supported.

  • Specific known issues are fixed.

2018-03-05

Release date

Version

Description

2018-03-05

2.5.1

  • Error messages are optimized.

  • Specific known issues are fixed.

2018-01-09

Release date

Version

Description

2018-01-09

2.5.0

  • STS-based playback is supported.

  • The UI of the HTML5 player is updated.

  • Time shifting is supported.

  • Specific known issues are fixed.

2017-12-06

Release date

Version

Description

2017-12-06

2.4.0

  • A message is displayed to provide the option for users to change the resolution under poor network conditions.

  • Resolution matching in MTS-based playback is optimized.

  • A method that can be used to query the current playback status is added.

  • The seeking event is added.

  • Operations can be performed in full-screen mode.

  • The issue that no error message is returned when the token of the Flash player expires is fixed.

2017-11-23

Release date

Version

Description

2017-11-23

2.3.5

  • The HTTPS protocol is supported.

  • Specific known issues are fixed.

2017-11-17

Release date

Version

Description

2017-11-17

2.3.0

  • FLV videos can be played by using the HTML5 player. For more information, see FLV playback.

  • Watermarks can be included in snapshots in the HTML5 player. For more information, see Watermark settings.

  • Components can be customized. For more information, see Custom component settings.

  • Specific known issues are fixed.