iOS Player SDK release history

Date

Version

Description

2026-06-04

7.15.0

• Added support for playing independently encrypted HLS videos.

• Refined the error codes for playback failures of DRM streams.

Date

Version

Description

2026-05-11

7.14.0

• Exposed H3 downgrade events.

• Exposes codec information for video streams.

• Fixed several known issues and improved player stability.

Date

Version

Changes

2026-04-08

7.13.0

• Added an API to get the local cache status of a specified resource.

• Added the getCurrentVps() API to get the unique ID of the current playback session.

• Added the setDefaultSubtitleLanguage() API to set the default subtitle stream in multi-subtitle scenarios.

• Added an audio enhancement plug-in with three features: volume normalization, vocal enhancement, and surround sound. This plug-in significantly improves audio playback. For more information, see audio enhancement.

• Fixed several known issues and improved player stability.

Date

Version

Updates

2026-02-10

7.12.0

• Fixed several known issues and improved player stability.

Date

Version

Description

2026-01-13

7.11.0

• Added custom client-side subtitle rendering logic. For details, see How to Add External Subtitles.

• Enabled setting the preload start position.

• Optimized RTS live streaming. This feature requires the RTS low-latency live streaming component version 7.11.0 or later. For details, see Implement RTS Stream Pulling on iOS.

  • Improved RTS network reconnection and network switching to reduce lag and errors.

  • Reduced decoding jitter and stabilized end-to-end latency.

  • Fixed several crashes and improved the stability of the RTS component.

Date

Version

Description

2025-12-05

7.10.0

• Optimized the automatic fallback from RTS to FLV to improve the stream pulling success rate. This feature requires RTS SDK 7.10.0 or later. For more information, see Implement RTS stream pulling on iOS.

• Enabled PlayAuth local signing.

• Enabled automatic refreshing of expired VID VOD authentication.

• Optimized the player's HTTPDNS resolution policy.

Date

Version

Changes

2025-11-11

7.9.1

• Upgraded the player network library for more stable network transmission.

Date

Version

Description

2025-11-04

7.9.0

• Enabled refreshing URL authentication during playback.

• Optimized MediaLoaderV2 preloading to support network parameter configuration.

• Enabled ultra-low latency HDR video playback over the RTS protocol.

• Added the setAutoBandWidth API to enable adaptive startup bitrate.

Date

Version

Description

2025-10-14

7.8.0

• Added support for third-party DRM encryption. See How to play encrypted videos for details.

• Reduced playback errors caused by the device write cache.

• The H.266 decoding plugin now supports HLS video playback.

• Fixed some known issues and improved player stability.

Date

Version

Description

2025-09-08

7.7.0

• Fixed an issue that could cause lag, disconnections, and audio-video desynchronization in extreme RTS scenarios. This fix requires RTS SDK 7.8.0 or later. For more information, see Implement RTS streaming on iOS.

• Introduced MedialoaderV2 to support preloading for ApsaraVideo VOD.

• Enabled network quality callbacks for real-time streaming (RTS).

• Added support for setting the maximum buffer duration before playback starts in pre-rendering mode.

• Fixed several known issues and improved player stability.

Date

Version

Description

2025-08-08

7.6.0

• Optimized the license validation logic to reduce validation errors in production.

• Added support for callbacks on Professional Edition license validation results.

• Added support for configuring the international environment in Info.plist to meet overseas data compliance requirements. For more information, see Integrate a license for iOS.

• Optimized error type classification for RTS playback.

• Added support for the H.266 decoding plugin.

• Added support for parsing CSS styles in WebVTT streams.

• Added support for rendering external WebVTT subtitles.

• Fixed some known issues and improved player stability.

Date

Version

Description

2025-07-07

7.5.0

• Reduced latency and stuttering for RTS ultra-low latency live streaming. Requires RtsSDK 7.4.0 or later. See Implement RTS stream pulling on iOS for details.

• Added guidance on troubleshooting player network exceptions.

• Fixed several known issues and improved player stability.

Date

Version

Description

2025-06-06

7.4.0

• Fixed an issue where secure downloads occasionally failed.

• Reduced the risk of stuttering in listplayer when pre-rendering is enabled.

• Refined player error codes and improved error messages.

• Fixed several known issues and improved player stability.

Date

Version

Description

2025-04-30

7.3.2

• Added an interface to set the playback scenario.

• Optimized the frame dropping policy for when audio and video are out of sync.

• Added support for setting the preload definition by passing the definition product.

• Added support for setting the initial playback definition by passing the definition product.

• Added support for configuring the frame count threshold for hardware decoding fallback in globalsettings.

• Improved error classification for playback failures.

• Fixed several known issues and enhanced player stability.

Date

Version

Description

2025-04-01

7.2.0

• Added a callback API to report cache hit status at playback startup.

• Added support for user-defined parameters in digital watermarks.

• The player now automatically switches network nodes on slow connections.

• Reduced stuttering during playback startup.

• Fixed an audio issue with ultra-low latency live streaming (RTS) at low sampling rates.

• Fixed known issues and improved player stability.

Date

Version

Description

2025-03-03

7.1.0

• Added an option to configure the removal of black bars from screenshots using the globalsettings parameter.

• Improved the responsiveness of the ABR algorithm in poor network environments.

• Fixed some known issues and improved player stability.

Date

Version

Description

2025-02-14

7.0.0

• The Player SDK now comes in Standard and Professional editions. For a feature breakdown, see Player SDK feature details. When using the Professional Edition on a mobile client, confirm the Player SDK version number.

• Fixed known stability issues.

Date

Version

Description

2025-01-02

6.21.0

• Added an international environment setting to the license for overseas data compliance. For more information, see Integrate a license for iOS.

• Added the getPlayedDuration API to retrieve the played duration in real time.

• Further reduced the number of threads used by the player.

Date

Version

Description

2024-12-05

6.19.0

• Added support for setting the maximum rendition for adaptive bitrate (ABR) switching.

• Further reduced the player's thread count.

• Added support for video mirroring, rotation, and screenshots, and improved rendering quality in Metal rendering mode.

• Fixed an intermittent crash and improved player stability.

Date

Version

Changes

2024-11-14

6.18.0

• Reduced the player's thread usage.

• Added the destroyAsync API to support asynchronous player destruction and improve the user experience for multi-instance playback.

• Removed redundant animations for a smoother transition when restoring the app from picture-in-picture mode.

• Removed bitcode.

Date

Version

Description

2024-10-14

6.17.0

• Enabled URL-level private encryption for HLS (single and multiple bitrates).

• Enhanced the preload feature to support adaptive degradation when H265 adaptive playback is enabled.

• Enabled in-app picture-in-picture.

• Fixed several known issues.

Date

Version

Description

2024-09-11

6.16.0

• The player can now fall back to an H.264 backup stream if H.265 hardware decoding fails. If a backup stream is not configured, the player automatically switches to software decoding.

• SelectTrack now supports a fast switching mode to change resolutions rapidly.

• You can now enable local cache without specifying a cache path.

• Added support for pre-rendering.

• Fixed several known issues and improved player stability.

Date

Version

Description

2024-08-15

6.15.0

• Added support for non-standard HLS, including playback of GZIP-compressed streams and duration calculations aligned with non-standard HLS rules.

• Added support for DNS prefetching to reduce time to first frame.

• Added seamless fallback for RTS. The player now automatically falls back to an FLV stream if ARTC playback fails, without requiring an additional URL.

• Fixed several known issues and improved player stability.

Date

Version

Changes

2024-07-05

6.14.0

Fixes several production crashes and improves player stability.

Date

Version

Description

2024-06-26

6.13.0

• You can now use listPlayer to preload multi-bitrate HLS videos and select a preload mode based on your use case. For more information, see Preload multi-bitrate HLS videos.

• You can now set the renderer type in AVPConfig.

• Fixed several known issues and improved player stability.

Date

Version

Description

2024-05-14

6.12.0

• The player SDK now enables Enhanced HTTPDNS by default for playback via an Alibaba Cloud accelerated domain name.

• Added a background decoding switch to allow the player to continue software and hardware decoding in the background. For more information, see Background decoding.

• Added HTTP TCP pre-connection to reduce network connection time. For more information, see HTTP TCP pre-connection.

• Optimized RTS playback latency.

• Reduced the time to first frame.

• Fixed some known issues and improved player stability.

Date

Version

Description

2024-04-10

6.11.0

• Added a privacy manifest file to the player to comply with Apple's privacy update for App Store submissions. No configuration is required—simply upgrade to this version.

• The SEI callback supports exposing the uuid through a new parameter. After upgrading, you will need to update your code to ensure it compiles. The semantics of the existing data parameter remain unchanged.

• Improved handling of local cache exceptions.

• Optimized the reconnection logic for live streaming.

• Fixed some known issues and improved player stability.

Date

Version

Updates

2024-02-05

6.10.0

• SEI now supports H.265.

• You can now configure the priority between HTTPDNS and local DNS. For more information, see Configure HTTPDNS Priority.

• Fixed edge-case crashes and improved player stability.

Date

Version

Description

2024-01-08

6.9.0

• Adds support for playing videos with an alpha channel, enabling dynamic effects such as transparent gifts. For more information, see advanced features.

• Adds support for Metal rendering (limited to setting the background color, scaling mode, and picture-in-picture). For more information, see Metal rendering.

• Fixed some known issues.

Date

Version

Description

2023-12-08

6.8.0

• You can now switch audio tracks in single-bitrate mixed HLS streams. For more information, see Switch audio tracks.

• Added URL-level private encryption for MP4 files.

• Improved the reconnection mechanism on iOS for smoother playback when switching between Wi-Fi and 4G networks.

Date

Version

Changes

November 8, 2023

6.7.0

• Introduced support for Enhanced HTTPDNS, which uses the Alibaba Cloud CDN node scheduling policy to improve network performance and reduce the risk of DNS hijacking. For more information, see HTTPDNS. To enable it, submit a ticket or contact your Alibaba Cloud account manager.

• Introduced seamless switching. For ApsaraVideo Live streams, you can now use the switchStream method to seamlessly switch between different resolutions during playback, enhancing the viewing experience. For more information, see Play live streams by using UrlSource.

• Upgraded the core network library.

• Fixed several known issues.

Date

Version

Changes

2023-08-30

6.5.0

• Enhanced the player's onError function by adding more troubleshooting details to the extra field of ErrorInfo.

• ListPlayer now supports playback with vid and playauth.

• Fixed intermittent stuttering when switching the app to the background.

Date

Version

Description

2023-08-03

6.4.0

• Added support for dynamic preloading in playlist playback to reduce CDN resource overhead without impacting playback performance.

• Fixed some known issues.

Date

Version

Description

2023-07-04

6.3.0

• Updated the version number to match the audio and video client SDK.

• Added support for switching between the left and right channels. For configuration details, see Switch between the left and right channels.

• Fixed several known issues and improved stability.

Date

Version

Changes

2023-05-25

5.5.5.1

Fixed a crash that occurred at playback start in edge cases.

Date

Version

Description

2023-05-09

5.5.5.0

• Optimized HTTPDNS to poll candidate IPs on failure and fall back to local DNS.

• You can now download videos using VidAuth without specifying a region.

• Fixed an issue where ListPlayer would freeze in edge cases.

Date

Version

Description

April 6, 2023

5.5.4.0

• Added support for playing videos in the H.266 encoding format. To use this feature, submit a ticket.

• Enabled the RTS low-latency mode by default to improve real-time performance.

• Optimized the SDK package size to reduce the application footprint.

• Optimized the authentication policy for local cache with URL authentication. You can now choose whether to cache authentication based on your use case. For more information, see local cache.

• Fixed a decoding error during HLS video stream playback, improving playback stability.

• Fixed several other issues to improve overall application performance.

Date

Version

Description

2023-03-03

5.5.3.0

• Added support for HTTP/3 (RFC 9114). This significantly improves video access speed on weak networks.

• Added support for parsing non-standard SRT subtitle files.

• Introduced stricter license validation. You must now register and configure a license for the player SDK to prevent playback failures. For details on this process, see license management.

Date

Version

Description

2023-02-02

5.5.2.0

• ListPlayer now supports pre-rendering and multiple instances for smoother video switching.

• Added support for RTS fallback playback.

• Added support for events and delegate settings for the picture-in-picture button on iOS 15 and later.

• Reduced the SDK package size by optimizing the structure of third-party libraries.

• Fixed some known issues.

Date

Version

Description

2022-12-13

5.5.1.0

• Upgraded the network library kernel.

• Fixed an occasional crash caused by a seek operation when reconnecting on a weak network.

Date

Version

Description

2022-12-02

5.5.0.0

• The player now supports Dolby Atmos. During VR playback, it converts four-channel to two-channel audio depending on the device status. To enable this feature, submit a request on Yida or contact your Alibaba Cloud account manager.

• Improved player stability.

• Fixed some known issues.

Date

Version

Modifications

2022-11-03

5.4.9.2

• Fixed an issue preventing App Store submissions.

• Fixed an issue where the seek callback event failed to fire after video playback was complete.

• Reduced the SDK package size.

Date

Version

Description

2022-09-30

5.4.9.1

• Added local caching for multi-bitrate video streams.

• Introduced an advanced adaptive bitrate streaming (ABR) algorithm that reduces buffering for multi-bitrate video streams. To enable this feature, submit a request on Yida or contact your Alibaba Cloud account manager.

• Reduced the sdk package size.

Date

Version

Description

2022-09-06

5.4.9.0

• Added support for Dolby Audio playback on compatible devices.

• Added the picture-in-picture feature on iOS 15, which allows playback to continue in the background.

• Added support for on-device super resolution, which upscales low-bitrate videos for higher-resolution playback. For more information, see on-device super resolution. To enable this feature, submit a ticket or contact Alibaba Cloud sales.

• Reduced the SDK package size.

• Fixed some known issues.

Date

Version

Description

2022-08-02

5.4.8.0

• This version requires a license. For details, see license management.

• Added interfaces to retrieve quality metrics such as audio bitrate, video bitrate, and download speed.

• Added support for subtitles in WebVTT format for MPEG-DASH streams.

Date

Version

Description

2022-07-04

5.4.7.1

• Enhanced the local cache. The player now checks for cache file expiration using the HTTP protocol and uses an optimized file structure for improved stability.

• Added a large cache feature. When local cache is enabled, you can set a longer buffer duration (maxBufferDuration). This feature stores an additional 50 seconds of buffer in a local file to prevent excessive memory usage.

• Added license management.

• Fixed an issue where cloud configuration could fail to retrieve a field in some scenarios.

• Fixed an issue where seeking to the end of an HLS stream caused an error.

• Fixed an issue where http-range requests caused an error during live streaming.

Date

Version

Updates

2022-04-19

5.4.6.0

• Added an advanced ABR algorithm that optimizes HLS and DASH live streaming and on-demand playback, and enhances LL-HLS auto bitrate capabilities.

• Added support for cloud-side configuration.

• Fixed incorrect display aspect ratios for some videos.

• Improved player stability.

• Removed automatic SEI data deduplication performed by the SDK.

• Optimized how the playlist player handles network disconnections.

• Fixed intermittent playback start failures.

Date

Version

Description

2022-02-22

5.4.5.0

• Enabled HTTP 2.0 by default.

• The list player now supports the HLS format (requires local cache to be enabled).

• Added support for HttpDNS (must be enabled manually).

• Added support for video post-processing.

• Reduced the SDK package size.

• Added support for license settings.

• Added the video enhancement post-processing module (requires a purchased license).

• Added the video frame interpolation post-processing module (requires a purchased license).

• Added support for catalyst. To enable this feature, submit a request on Yida or contact your Alibaba Cloud sales manager.

Date

Version

Changes

2022-01-17

5.4.4.1

• Added support for LL-HLS with multiple bitrates.

• Added support for adaptive bitrate for LL-HLS. The ABR algorithm will be continuously optimized.

• Improved the stability of LL-HLS.

Date

Version

Description

2021-12-27

5.4.4.0

• Added support for playback speeds up to 5x.

• Added support for formatted display of ASS subtitles.

• Enabled playback of streams with Alibaba Cloud private encryption over RTMP and HTTP-FLV.

• Added support for LL-HLS.

• Added local caching.

• Added preloading.

• Added support for HTTP/2.

• Improved multi-bitrate switching for HLS live streaming.

• Improved DASH pseudo-live streaming.

• Improved compatibility and stability.

• Improved stop performance.

• Fixed an issue that caused stuttering when calling prepare and stop in quick succession.

Date

Version

Description

2021-08-03

5.4.2.0

• Added support for referer and other configurations for lists.

• Upgraded ffmpeg to 4.3.1.

• Added support for video latency settings.

• Added support for UTC time callbacks in HLS.

• Added a clear screen feature.

• Improved player stability.

• Optimized audio playback over Bluetooth.

• Optimized decoding on 9.x to prevent black screens.

Date

Version

Description

2021-06-07

5.4.1

• Added data callbacks for audio/video playback.

• Improved compatibility with dash.

• Improved adaptive bitrate switching for live streaming.

• Improved media information reporting.

• Improved responsiveness when switching between Wi-Fi and cellular networks.

• Added the ability to destroy a view during playback.

• Improved foreground/background switching.

Date

Version

Description

2021-05-14

5.4.0

• Added support for DASH streaming technology.

• Added support for backward buffer.

• Added support for retrieving the current download speed.

• Improved player SDK compatibility.

• Removed the dependency on OpenGL ES.

Date

Version

Updates

2021-05-11

5.3.4

• Improved audio and video synchronization.

• Improved external subtitles display.

• Improved stability.

• Fixed an error with background playback of privately encrypted content.

Date

Version

Description

2021-03-08

5.3.2

• Added support for HLG HDR video.

• Enabled rotation, mirroring, screenshots, and fill mode adjustments during HDR playback.

• Improved compatibility for multi-channel audio playback.

• Improved audio playback stability.

• Improved performance with the system player.

Date

Version

Description

2021-01-19

5.3.0

• Improved stop performance.

• Optimized the default definition selection logic for vid playback.

• Added support for Alibaba Cloud HLS.

• Improved playback progress accuracy.

• Improved support for external subtitles.

• Removed the Conan package dependency.

• Added Widevine support to the player kernel.

• Added support for HDR10 playback.

Date

Version

Description

2021-01-07

5.2.3

• Optimized the download module logic.

• Improved compatibility with MP4 HLS.

• Added support for Alibaba Cloud audio-only playback.

• Fixed an issue causing noise when switching videos during playlist playback.

Date

Version

Change log

2020-11-17

5.2.2

• Improves compatibility for video playback at different frame rates.

• Fixed frame drops when resuming custom-speed playback after stopping.

• Improves compatibility with MP4 files.

• Improves playlist playback.

• Improves volume and mute settings.

• Improves player stop performance.

Date

Version

Description

2020-09-30

5.2.1

• Improved compatibility with HLS.

• Separated the artc package to reduce version coupling with the player SDK.

• Added support for FairPlay DRM.

• Removed OpenSSL to reduce package size.

• Enabled pixelbuffer output from standard encrypted HLS streams.

Date

Version

Description

2020-09-22

5.1.6

• Optimized the progress display.

• Optimized external subtitle display.

• Optimized audio-video synchronization.

• Optimized the playback start speed for vid lists.

• Optimized audio playback for various sampling rates.

• Updated foreground and background event listening to support iPad devices.

• Fixed a bug that prevented automatic fallback to software decoding for interlaced content.

Date

Version

Description

2020-07-22

5.1.5

Added support for artc playback.

Date

Version

Description

2020-07-07

5.1.4

• Added encryption for HLS live streaming.

• Added a setting for the IP resolution type.

• Improved pre-caching.

• Added a setting for the video background color.

• Reduced latency for HLS live streaming.

• Improved player compatibility.

• Open-sourced the player kernel, CicadaPlayer.

• Enabled customization of AudioSession properties.

Date

Version

Changes

2020-08-10

4.7.5

Fixed a crash on iOS 14.

Date

Version

Modifications

2020-03-16

4.7.4

• Added an interface to get FPS and a callback interface for video rendering.

• Improved SDK stability.

Date

Version

Changelog

2019-12-11

4.7.3

• Enabled setting the initial bitrate for multi-bitrate streams.

• Improved the audio/video synchronization logic.

• Improved SDK stability.

Date

Version

Description

2019-11-01

4.7.2

• Added precise seek for video on demand when switching definitions.

• Added support for live stream catch-up.

• Improved SDK stability.

Date

Version

Description

2019-09-18

4.7.1

• Enabled retrieval of H.264 SEI information.

• Enabled FLV live catch-up.

Date

Version

Description

2019-08-19

4.7.0

• Enabled WebVTT thumbnails.

• Enabled precise seek.

• Enabled configuration of the encryption type for video requests.

• Enabled RTS.

Date

Version

Description

2019-08-02

4.5.0

• Introduced AliPlayer, a new, more user-friendly player interface.

• Added support for H.265 software and hardware decoding, and H.265 playback for live streaming.

• Added the preview feature.

• Introduced AliListPlayer for short-form video playlist playback.

• Added support for HLS master playlists.

• Added support for multiple audio tracks, subtitles, and bitrates, as well as thumbnails.

• Added support for seamless and adaptive switching across multiple bitrates.

• Enhanced the cache while playing feature to support caching MP4 URLs and retrieving cached file names.

• Introduced an improved offline download interface.

Date

Version

Description

2019-06-12

3.4.10

• Added the region parameter to on-demand playback to support internationalization.

• Added support for on-demand audio playback and download.

• Fixed related crashes.

Date

Version

Description

2019-01-04

3.4.9

• Optimized loop playback.

• Fixed an issue that prevented a vid request from being stopped.

• Reduced stutter when the app returns to the foreground.

• Fixed an issue that caused a crash when rapidly scrolling through short video lists.

Date

Version

Changelog

2018-08-25

3.4.7

• Fixed a bug where the frame would not update immediately after seeking from a paused state.

• Fixed a bug that prevented error reporting when seeking after a network disconnection.

• Fixed a bug that prevented users from re-downloading deleted files.

• Fixed a crash on iOS 8 caused by repeatedly switching the app to and from the background during playback.

Date

Version

Description

2018-06-21

3.4.6

• Added support for HLS standard encrypted downloads.

• Added an API to retrieve the video rotation angle.

• Added an API for trace ID instrumentation.

Date

Version

Release notes

2018-05-27

3.4.5

• Fixed a 4003 error that occurred when seeking to the end of a video.

• Fixed an issue that prevented seeking to the beginning of a video.

• Fixed an error that occurred when seeking outside the buffered range after a network disconnection during playback.

• Made the UI player open source.

Date

Version

Changes

2018-05-04

3.4.4

• Fixed an issue where videos with spaces in their titles failed to play.

• Fixed an issue where playback could not be resumed after the push streaming backend sent an image.

Date

Version

Updates

2018-04-25

3.4.3

• Fixed a playback issue with MP3 files containing cover art.

• Fixed an audio playback issue that occurred when the screen was off.

Date

Version

Changes

2018-04-18

3.4.2

• Added referer-based hotlink protection.

• Optimized data logging.

• Removed third-party dynamic libraries.

Date

Version

Description

2018-03-06

3.4.1

Fixed errors in the tracking log.

Date

Version

Updates

2018-02-26

3.4.0

• Time-shifting for live streaming.

• MPS secure download.

• Continuous playback demo.

Date

Version

Description

2018-02-06

3.3.4

• Fixed an issue where STS tokens expired due to a time zone mismatch.

• Fixed an issue where cached meta information for video rotation was lost.

• Fixed an error that occurred when uploading to the App Store.

• Improved the error messages for STS expiration and playback status.

• Optimized the download completion logic.

• Fixed DNS request failures when the network was unavailable.

• Added support for variable-resolution video playback.

Date

Version

Modifications

2018-01-24

3.3.3

• Added the live quiz playback feature.

• Fixed a UI thread hang.

Date

Version

Description

2018-01-08

3.3.2

Fixed a crash caused by a missing language pack.

Date

Version

Description

2017-12-13

3.3.0

• Added a callback API for the start of loop playback.

• Added an API to set the video rendering rotation angle.

• Added an API for video frame mirroring.

• Added a callback API for the completion of playback in the UI player.

• Added support for progressive download for videos played from a URL.

Date

Version

Description

2017-11-23

3.2.2

Fixed a bug in the stream pushing SDK where there was no audio during background playback.

Date

Version

Description

2017-11-15

3.2.0

• Added loop playback.

• Added screenshot support.

• Added seeking within the cache.

• Optimized the demo application by merging the basic and advanced player examples.

• Added full-screen event callbacks for the UI player.