HarmonyOS player SDK Release Notes

Date

Version

Changelog

Download link

2026-09-20

7.18.0

• Fixed known issues and improved player stability.

HarmonyOS player SDK-7.18.0

Date

Version

Changelog

Download link

2026-08-13

7.17.0

• Improved compatibility for HLS subtitle stream error scenarios.

• Fixed known issues and improved player stability.

HarmonyOS player SDK-7.17.0

Date

Version

Changelog

Download link

2026-06-04

7.15.0

• Added support for playing HLS videos with standalone encryption.

• Refined error codes for DRM playback failures.

HarmonyOS player SDK-7.15.0

Date

Version

Changelog

Download link

2026-05-11

7.14.0

• Optimized hardware decoding to reduce device overheating and high CPU usage.

• Improved player stability by fixing known issues.

HarmonyOS player SDK-7.14.0

Date

Version

Changelog

Download link

2026-04-08

7.13.0

• Adds an API to get the local cache status for a specified resource.

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

• Adds the setDefaultSubtitleLanguage() API for setting the default subtitle stream when multiple are available.

• Adds the selectTrackAccurate() API to enable accurate mode, preventing progress regression when switching resolutions.

• Fixes known issues and improves player stability.

HarmonyOS player SDK-7.13.0

Date

Version

Description

Download

2026-02-10

7.12.0

• Fixed known issues and improved player stability.

HarmonyOS Player SDK-7.12.0

Date

Version

Description

Downloads

2026-01-13

7.11.0

• Added support for setting the preload start position.

• Optimized RTS live streaming, which requires the RTS low latency live streaming component v7.11.0 or later. For details, see Implementing RTS stream pulling on HarmonyOS.

  • Optimized disconnection recovery and network switching to reduce buffering and errors.

  • Optimized decoding latency jitter to stabilize end-to-end latency.

  • Fixed several crashes to improve RTS component stability.

ApsaraVideo player SDK for HarmonyOS-7.11.0

Date

Version

Changelog

Download link

2025-12-05

7.10.0

• Added PlayAuth local signing.

• Added auto-refresh of VID VOD authentication upon expiration.

• Optimized the player HTTPDNS resolution policy.

HarmonyOS Player SDK-7.10.0

Date

Version

Changes

Downloads

2025-11-11

7.9.1

• Upgraded the player network library to improve network stability.

HarmonyOS Player SDK-7.9.1

Date

Version

Changes

Download link

2025-11-04

7.9.0

• Added support for refreshing URL authentication during playback.

• Optimized the MediaLoaderV2 preload feature to support network parameter configuration.

• Added support for ultra-low latency HDR video playback over the RTS protocol.

• Added the setAutoBandWidth API to configure network adaptation for the initial bitrate.

• Hid standard library symbols within the dynamic library to prevent conflicts with third-party libraries.

HarmonyOS Player SDK-7.9.0

Date

Version

Change log

Download

2025-10-14

7.8.0

• Fixed playback errors caused by the device write cache.

• Fixed several known issues and improved player stability.

HarmonyOS Player SDK-7.8.0

Date

Version

Changelog

Download link

2025-09-08

7.7.0

• Added MedialoaderV2 for VOD preloading.

• Now supports Real-Time Streaming (RTS) stream pulling. See Implement RTS stream pulling on HarmonyOS.

• Added network quality callbacks for Real-Time Streaming (RTS).

• Fixed an issue that caused snapshots to show a black screen in some scenarios.

• Fixed several known issues to improve player stability.

HarmonyOS Player SDK-7.7.0

Date

Version

Changelog

Download link

August 8, 2025

7.6.0

• Changed the default audio delay mode from low latency to normal mode to improve audio rendering stability.

• Optimized the license verification logic to reduce online verification errors.

• Added a callback for Professional Edition license verification results.

• Fixed several known issues to improve player stability.

HarmonyOS player SDK-7.6.0

Date

Version

Release notes

Download link

July 7, 2025

7.5.0

• Fixed rendering issues in hardware decoding.

• Added more diagnostic information for player network errors.

• Improved player stability by fixing known issues.

HarmonyOS player SDK-7.5.0

Date

Version

Changelog

Download link

2025-06-06

7.4.0

• Fixed intermittent secure download failures.

• Added more granular error code reporting and improved player error messages.

• Fixed an intermittent memory leak during preload.

• Fixed a hardware decoding incompatibility.

• Fixed several known issues to improve player stability.

HarmonyOS Player SDK-7.4.0

Date

Version

Description

Download

2025-04-30

7.3.0

• Added an interface for setting the playback scenario.

• Optimized the frame drop policy for audio-video desynchronization.

• Enabled setting the preload definition by passing a definition product.

• Enabled setting the initial playback definition by passing a definition product.

• Enabled configuring the frame count threshold for hardware decoding downgrade using globalsettings.

• Refined and categorized error codes for playback failures.

• Fixed several known issues and improved player stability.

HarmonyOS Player SDK-7.3.0

Date

Version

Changelog

Download

2025-04-01

7.2.0

• Added a callback interface to report startup cache hit status.

• Added custom digital watermark parameters.

• Added automatic network node switching on slow connections.

• Reduced stuttering during player startup.

• Fixed known issues and improved player stability.

HarmonyOS Player SDK-7.2.0

Date

Version

Changes

Download link

2025-03-03

7.1.0

• You can now remove black bars from screenshots by using the globalsettings parameter.

• The ABR algorithm is now more responsive under poor network conditions.

• Fixed several known issues and improved player stability.

HarmonyOS Player SDK 7.1.0

Date

Version

Modifications

Download

2025-02-17

7.0.0

• The player SDK is now available in standard and professional editions. For a feature breakdown by edition, see Feature Details of the Player SDK. Before using the mobile professional edition, confirm the version number of the player SDK in your application.

• Fixed a stability issue when calling setCacheUrlHashCallback.

• Fixed other known stability issues.

HarmonyOS player SDK-7.0.0

Date

Version

Description

Download link

2025-01-03

6.21.0

• Enhanced player stability by aligning the core engine with the Android and iOS platforms.

• Enabled secure download.

• Enabled playing local videos from URLs that start with "file://".

• Enabled setting the audio type.

• Enabled alpha playback.

• Enabled enhanced HTTPDNS.

• Enabled audio track switching.

• Enabled seamless resolution switching.

• Introduced the releaseAsync API for asynchronous player destruction to improve user experience in multi-instance playback scenarios.

• Private encryption now supports URL-level encryption for HLS (single and multiple bitrates) and MP4 videos.

• SelectTrack now supports fast switching mode for rapid resolution changes.

• Added a callback for audio-video asynchronization.

• Enabled setting an upper limit for adaptive bitrate (ABR) resolution switching.

• Enabled retrieving the playback duration.

• Built with DevEco Studio 5.0.1 Release 5.0.5.306 and verified on devices running version 5.0.0.113.

HarmonyOS Player SDK-6.21.0

Date

Version

Updates

Download

2024-10-30

preview-6.5.7

• Added preloading support.

• Added support for local video downloads (secure download not yet supported).

• Added screenshot support.

• Added quality switching support.

• Added live time-shifting support.

• Added support for external subtitle parsing (component-based rendering not yet supported).

• Fixed an issue where setting certain fields in sts playerconfig had no effect.

• Fixed an ANR issue caused by frequent calls to prepare.

• Fixed several known issues and improved player stability.

• Built with DevEco Studio 5.0.0 Release 5.0.3.906 and verified on devices running version 5.0.0.102.

HarmonyOS Player SDK-preview-6.5.7

Date

Version

Changes

Download link

2024-10-08

preview-6.5.6-291625

• Fixed an issue on devices running Next.0.0.68 where audio failed to play and the video froze when replaying a completed video (including through calls to interfaces such as Seek and Prepare).

• Built with DevEco Studio NEXT Beta1 5.0.3.810 and verified on devices running Next.0.0.68.

HarmonyOS Player SDK-preview-6.5.6-291625

Date

Version

Changes

Download

2024-09-24

preview-6.5.6-201621

• Ensures compatibility with Next.0.0.66 and fixes an issue on devices running this version where audio failed to play and video froze during replay (e.g., when calling the Seek and Prepare interfaces).

• Built with DevEco Studio NEXT Beta1 5.0.3.806 and verified on devices running Next.0.0.66.

HarmonyOS Player SDK-preview-6.5.6-201621

Date

Version

Description

Download

2024-09-04

preview-6.5.6

• Added support for the audio interruption callback.

• While this release does not support HDR video playback, the SDK now correctly triggers error callbacks for such attempts.

• Fixed an intermittent crash in the network library.

• Fixed an ANR caused by quickly scrolling the listPlayer.

• Fixed a bug that prevented VidPlayerConfig settings from taking effect.

HarmonyOS Player SDK-preview-6.5.6

Date

Version

Updates

Download

July 17, 2024

preview-6.5.4

• Supports playback with VidAuth, VidSts, and LiveStsSource.

• Built with IDE 5.0.3.402 and API 12.

• Fixed several known issues and improved player stability.

HarmonyOS Player SDK-preview-6.5.4

Date

Version

Release notes

Download link

2024-07-04

preview-6.5.3

Improved player stability by fixing known issues.

HarmonyOS Player SDK-preview-6.5.3

Date

Version

Modifications

Download link

2024-06-21

preview-6.5.2

• Added support for listPlayer.

• Added compatibility with HarmonyOS API 12 and later.

• Resolved known issues and improved player stability.

HarmonyOS Player SDK (preview-6.5.2)

Date

Version

Description

Download link

2024-03-22

preview-6.5.1

Initial release. For instructions, see SDK integration.

HarmonyOS Player SDK-preview-6.5.1