Improved Error Management

Improvements

• Integrations can now access full details of errors that occur during asset loading.
• Core Business asset loading errors are now exposed as DataError.
• Added Player.resume(_:in:) to allow setting a transient start item and time.
• Introduced MediaSelectionPreference, improving media selection APIs and adding support for .off selection.
• Simplified playback speed APIs.
• Unified playlist navigation APIs to consistently respect the navigationMode across all use cases.
• Added reporting of the current AirPlay status in Commanders Act events.
• Made RepeatMode conform to CaseIterable.

Fixes

• Fixed an issue where playback of DRM-protected content could fail consistently after the app stayed in the background for several hours.
• Fixed stale values returned by Commanders Act and metrics tracker heartbeats.
• Fixed inconsistencies in the Picture-in-Picture restoration flag when stopping without restoration.
• Fixed incorrect busy state reporting when playback fails.

Demo Improvements

• Error messages now include icons for better clarity.
• Added a shortcut link to application settings.

Demo Fixes

• Fixed blurry images on skip buttons.
• Fixed the toggle tap gesture not working on iOS 26.
• Restored demo content that was previously unplayable.

Breaking Changes

• Replaced Player.setMediaSelection(preferredLanguages:for:) with Player.setMediaSelectionPreference(_:for:).
• Removed Player.mediaSelectionPreferredLanguages(for:).
• Removed Player.canReturnToPrevious(), Player.canAdvanceToNext(), Player.returnToPrevious() and Player.advanceToNext().
• Removed Player.setDesiredPlaybackSpeed(_:) and Player.effectivePlaybackSpeed. Use Player.playbackSpeed instead.

What's Changed

• Improve project structure by @defagos in #1236
• Improve CC-related recommendations by @defagos in #1238
• Add Dependabot configuration file by @defagos in #1239
• Bump actions/stale from 8 to 9 in the actions group by @dependabot[bot] in #1240
• Ignore Difference package updates by @defagos in #1242
• Cleanup code and update tools by @waliid in #1243
• Bump fastlane from 2.227.1 to 2.228.0 in the gems group by @dependabot[bot] in #1244
• Fix dependency name by @defagos in #1245
• Bump the packages group with 2 updates by @dependabot[bot] in #1246
• Avoid blurry images for skip buttons by @waliid in #1247
• Update RTS on-demand example URL by @defagos in #1251
• Fix stale values returned in heartbeats by @defagos in #1250
• Bump github.com/commandersact/iosv5 from 5.4.15 to 5.4.16 in the packages group by @dependabot[bot] in #1256
• Bump github.com/apple/swift-collections from 1.2.0 to 1.2.1 in the packages group by @dependabot[bot] in #1257
• Fix incorrect busy state by @waliid in #1261
• Make it possible to update the player item start position by @defagos in #1262
• Fix non-working toggle tap gesture on iOS 26 by @defagos in #1263
• Revert closure-based position retrieval API by @defagos in #1264
• Fix tap gesture behavior by @defagos in #1266
• Support transient resume item and time by @defagos in #1267
• Bump actions/checkout from 4 to 5 in the actions group by @dependabot[bot] in #1268
• Manage decryption keys using AVAssetResourceLoaderDelegate by @defagos in #1270
• Bump github.com/commandersact/iosv5 from 5.4.16 to 5.4.17 in the packages group by @dependabot[bot] in #1276
• Update packaging advice for reliable media selection handling by @defagos in #1275
• Support empty media selection by @defagos in #1277
• Fix missing localization bundle by @defagos in #1278
• Add link to app settings by @defagos in #1279
• Improve PiP restoration flag consistency by @defagos in #1280
• Add recommendations for the DEFAULT attribute by @defagos in #1282
• Improve error handling by @waliid in #1286
• Bump actions/stale from 9 to 10 in the actions group by @dependabot[bot] in #1287
• Bump github.com/comscore/comscore-swift-package-manager from 6.14.1 to 6.15.0 in the packages group by @dependabot[bot] in #1288
• Add Google Cast article by @waliid in #1289
• Update toolchain to Xcode, iOS and tvOS 26 by @defagos in #1290
• Add a playlist section in the playback article by @waliid in #1293
• Support AirPlay analytics measurements by @waliid in #1295
• Add article about user interface implementation by @defagos in #1294
• Fix documentation by @defagos in #1296
• Fix flaky test by @defagos in #1299
• Bump rexml from 3.4.1 to 3.4.2 in the bundler group across 1 directory by @dependabot[bot] in #1298
• Update expired URN example by @defagos in #1297
• Add Apple's monoscopic stream example by @defagos in #1300
• Avoid simultaneous dismissal gesture recognition by @defagos in #1301
• Make RepeatMode conform to CaseIterable by @waliid in #1304
• Make playback speed API simpler by @defagos in #1303
• Simplify menu labels by @waliid in #1305
• Avoid data races in concurrent code by @defagos in #1252
• Bump github.com/apple/swift-collections from 1.2.1 to 1.3.0 in the packages group by @dependabot[bot] in #1307

New Contributors

• @dependabot[bot] made their first contribution in #1240

Full Changelog: 12.0.0...13.0.0