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

Performance Improvements

Improvements

• Ensure most PlayerItemTracker methods are executed off the main thread to avoid potential UI hitches, particularly when displaying videos in scrollable views.

Demo Fixes

• Fixed performance issues when seeking on certain devices.
• Resolved visible hitches when swiping between stories in the demo.
• Corrected a non-working stream URL.

Breaking Changes

• Removed HTTP and HTTPS constants from media composition streaming methods.
• Most PlayerItemTracker methods are now called off the main thread. Update your implementation to handle thread safety accordingly.

What's Changed

• Remove non-existing streaming constants by @defagos in #1229
• Improve documentation by @waliid in #1230
• Fix on-demand example URL by @defagos in #1234
• Fix performance issues due to access log and date retrieval by @defagos in #1233

Full Changelog: 11.0.0...12.0.0

Seek Behavior Overhaul

Fixes

• Seek logic has been revisited to address performance issues, particularly with audio content. The .immediate behavior has been rebranded as .optimal, ensuring the best experience based on the content being played.
• Player items delivered by the CoreBusiness framework will now include chapters only for episode content.

Demo Fixes

• Fixed issues where interacting with the slider could cause an inconsistent UI state or erratic behavior.

Breaking Changes

• The .immediate seek behavior has been replaced with .optimal.

What's Changed

• Remove picker label where superfluous by @defagos in #1217
• Fix slider animation glitches by @defagos in #1220
• Improve CI reliability by @defagos in #1222
• Improve documentation by @defagos in #1221
• Only return chapters for episodes by @defagos in #1223
• Fix slider interaction issues by @defagos in #1224
• Fix performance issues with immediate seeks in audio content by @defagos in #1225

Full Changelog: 10.0.2...11.0.0

Maintenance Release

Improvements

• Display the currently selected values in the settings menu for better visibility.
• Improve alignment between settings menu labels and the system player's user experience.
• Add support for displaying VPN/proxy blocking reasons.

Fixes

• Prevent potential plugin name clashes with other packages.
• Fix an issue where Player observation could fail when empty.

Demo Improvements

• Make skip intervals configurable in demo settings.

What's Changed

• Document sources of sample streams by @defagos in #1203
• Improve demo slider by @defagos in #1204
• Add VPN/proxy blocking reason by @defagos in #1191
• Prefix plugin name to avoid conflicts by @defagos in #1206
• Display current menu selections by @defagos in #1207
• Remove explicit equatable conformance by @waliid in #1209
• Fix player observability when empty by @defagos in #1208
• Remove web content tracking documentation by @defagos in #1210
• Support dynamic skips symbols based on player configuration by @waliid in #1211
• Fix documentation by @defagos in #1213
• Improve standard settings menu by @defagos in #1214
• Avoid using isActive as published var by @waliid in #1215

Full Changelog: 10.0.1...10.0.2

Improved Picture in Picture handling

Improvements

• Improved Picture in Picture (PiP) automatic start support for cases where the video view doesn’t cover the entire screen.

Demo Improvements

• Fixed an issue where the custom player controls toggle gesture wasn’t working as expected on iOS 17.

What's Changed

• Fix analytics documentation by @defagos in #1189
• Fix toggle gesture by @waliid in #1192
• Reorganize gestures for a better user experience by @waliid in #1194
• Update macOS and Xcode versions by @waliid in #1193
• Dependency update by @defagos in #1195
• Update gems by @defagos in #1196
• Disable skip gestures on iOS 17 by @defagos in #1197
• Fix settings preview by @defagos in #1199
• Allow to start Picture-in-Picture automatically for inline contents by @waliid in #1200
• Fix preprocessor condition by @waliid in #1201

Full Changelog: 10.0.0...10.0.1

Support for skip gestures

Improvements

• Introduced SkipTracker to simplify the implementation of skip gestures.
• Added skip methods that accept a Skip direction as a parameter. These methods are more ergonomic when the skip direction is determined programmatically, while the existing methods remain well-suited for UI-bound actions.
• Made PlayerItem conform to Hashable, simplifying the adoption of Hashable in wrapper types.
• Added methods to stop or close Picture in Picture without triggering restoration behavior.
• Added methods to show or hide the user interface managed by a VisibilityTracker.

Breaking Changes

• Core extensions previously defined on Array have been moved to Collection for broader applicability.
• Removed the PictureInPicturePersistable.pictureInPictureDidClose() method.

Demo Improvements

• Enabled support for skip gestures in the custom player layout.
• Improved playlist management UI in the demo: it now supports inserting the same item multiple times, with control over both the insertion point and a multiplier.
• URIs in the monitoring panel are now displayed in full without truncation.

Demo Fixes

• Fixed high-speed capsule display issues on devices with a notch.

Added custom menu actions

Improvements

• Added support for custom actions in iOS player-related Menu contents, allowing applications to respond to user selections.
• Replaced navigation_bu_distributer with content_bu_owner in Commanders Act page views to ensure consistent measurement across applications and websites.
• Enhanced monitoring data with track (audio and subtitles) and application information.

Fixes

• Ensured buffer values are always clamped to the correct range.
• Restored Control Center to the system when no longer needed.

Breaking Changes

• Replaced PlayerProperties with TrackerProperties in tracker implementations. This ensures that property values accurately reflect the state at the time of capture, preventing discrepancies when accessed later.
• Renamed PlayerItemConfiguration to PlaybackConfiguration to better represent its role in PlayerItem and Asset configurations.
• Converted Server into an enum with fixed values to prevent unauthorized services from incorrectly implementing the SRG SSR metadata service contract.
• Restricted analytics source keys to a predefined enumeration of allowed values.

Demo Improvements

• Added support for Enhance Dialogue in player audio settings on compatible tvOS devices.

Removed custom server support in Core Business

This release removes support for custom servers in Core Business player items, ensuring that only official production, staging, and test environments are available.

Improvements

• URN information is now included in all reports sent to the SRG SSR monitoring platform, even when the URN is invalid.

Bug Fixes

• Fixed an assertion failure in debug builds when attempting to play a URN.

Breaking Changes

• The identifier associated with a MetricsTracker has been moved from its metadata to its configuration.
• Custom Server construction, previously marked as deprecated, is no longer supported.

Demo Improvements

• Removed MMF support.
• Removed alternative environments, including SAM and CH/WW location simulation.
• Enhanced the demo player slider appearance and behavior.

What's Changed

• Remove MMF support by @defagos in #1126
• Fix script location by @defagos in #1127
• Require an identifier to be provided when creating a metrics tracker by @defagos in #1128
• Simplify Plist overrides by @waliid in #1129
• Fix slider background and animations by @defagos in #1131
• Update dependencies by @defagos in #1132
• Replace futures with async publisher by @defagos in #1130
• Remove custom server initializer by @defagos in #1133

Full Changelog: 7.0.0...8.0.0

Removed Support for ComScore Page Views

This release removes support for tracking ComScore page views.

Miscellaneous Improvements

• Overlay Support: Added overlay functionality to SystemVideoView.
• Enhanced Security: Prevented item creation from unofficial service endpoints. The Server.init(baseUrl:queryItems:) initializer, while still available, will be deprecated in a future release and now triggers an assertion if used.
• Improved Documentation: Enhanced the organization and clarity of documentation catalogs.
• Analytics Delegate: Introduced AnalyticsDelegate, enabling applications to be informed whenever events or page views have been sent.

Breaking Changes

• The Analytics.trackPageView(commandersAct:) method now exclusively accepts Commanders Act page view data. The comScore parameter has been removed.
• The ComScorePageView type and the c8 property from ComScoreLabels have been removed.
• The comScorePageView property has been removed from the PageViewTracking protocol.
• The SwiftUI page view tracking modifier tracked(commandersAct:) now only supports Commanders Act page view data, removing the previously available comScore parameter.

What's Changed

• Improve documentation by @defagos in #1067
• Add method to respond to state changes at the user interface level by @defagos in #1070
• Add article about resource optimization by @defagos in #1072
• Add hover support by @defagos in #1073
• Fix layout glitches during rotation by @defagos in #1074
• Add GitHub workflows by @waliid in #1075
• Avoid running the release workflow when it is not appropriate by @waliid in #1084
• Fix Pillarbox version in the demo app by @waliid in #1089
• Improve log formatting by @defagos in #1088
• Rename CI workflow by @waliid in #1090
• Update tooling documentation by @defagos in #1091
• Disable parallel testing to improve CI unit test reliability by @defagos in #1085
• Add important instructions for apps using a delivery pipeline by @defagos in #1093
• Add hlsreport information by @defagos in #1094
• Avoid flaky expectations capturing values during a hardcoded time interval by @defagos in #1099
• Add timeouts for GitHub action jobs by @waliid in #1101
• Prevent item creation from non-official service endpoints by @defagos in #1102
• Remove dead code by @defagos in #1103
• Document limit restrictions when casting to AirPlay receivers by @defagos in #1109
• Polish documentation catalogs by @defagos in #1105
• Cleanup Makefile targets by @waliid in #1104
• Declare monitoring resources by @defagos in #1111
• Increase job timeouts to 30 minutes by @defagos in #1112
• Add system video view overlay support by @defagos in #1114
• Avoid using shellcode env with pkgx by @waliid in #1119
• Fix demo deliveries by @waliid in #1120
• Improve demo playback slider by @waliid in #1118
• Remove comScore page views by @defagos in #1121
• Fix system video view overlay issues by @defagos in #1122
• Support custom tracking when page views are tracked by @waliid in #1124

Full Changelog: 6.0.0...7.0.0

SRG SSR monitoring and Low Data Mode support

This release adds monitoring for SRG SSR content. It also introduces new APIs to better manage data in constrained environments, with support for Low Data Mode and upper bounds that can be set on content bitrate and resolution.

Recent API changes introduced for playlists in 4.0.0 have also been rollbacked. These APIs failed to deliver the convenient model / playlist synchronization they were introduced for.

Monitoring

• SRG SSR core business player items are monitored automatically. The collected data covers a wide range of Quality of Service / Quality of Experience needs and, even though all data is anonymous, you should ensure that your app privacy details are updated accordingly if needed.

Support for constrained data environments

• ImageSource supports standard and low-resolution image URLs. When provided these are automatically loaded when Low Data Mode has been enabled for a network.
• Core business player items retrieve low-resolution images when Low Data Mode has been enabled for a network.
• The player configuration has been extended with a allowsConstrainedNetworkAccess to prevent playback for non-essential content when Low Data Mode has been enabled.
• PlayerLimits can be freely defined to set upper bounds on content bitrate and resolution. This makes it possible to implement data-saving modes. Note that no lower bounds can be set, as the player must remain free to use available lower-quality variants to ensure an uninterrupted playback experience.

Miscellaneous improvements

• Provide a way to optionally attach metadata to unavailable Assets.
• Attach metadata to core business player items which are unavailable for a business reason (e.g. content not available yet).
• Make Player.currentItem a published property.

Breaking changes

• The source parameter associated with PlayerItems has been removed.
• The corresponding Playlist parameter has been removed.

Fixes

• Fix erratic change observability when changing legible media options.
• Hide RoutePickerView for iPad apps running on macOS.

Demo improvements

• Add quality switch to the custom player layout settings menu.
• Add similar setting to the global demo settings. This setting is applied throughout the demo where appropriate.
• Improve demo overall accessibility via VoiceOver.

What's changed

• Remove playlist source support by @defagos in #1041
• Monitor SRG SSR content by @waliid in #1042
• Set LSMinimumSystemVersion to 14.0 by @waliid in #1043
• Update GitHub templates by @waliid in #1044
• Remove monitoring warnings by @waliid in #1046
• Deliver metadata with business errors by @defagos in #981
• Remove error severity by @defagos in #1048
• Update known issues to reflect state as of iOS / tvOS 18 by @defagos in #1047
• Update fastlane to version 2.225.0 by @defagos in #1050
• Fix performance issue by @defagos in #1051
• Never display route selection for iPad apps run on macOS or Catalyst by @defagos in #1052
• Add support for Low Data Mode and bandwidth / resolution limits by @defagos in #1056
• Update 3rd party dependencies to most recent versions by @defagos in #1058
• Convert demo project to Xcode 16 folders by @defagos in #1055
• Remove superfluous Quality menu level on macOS by @defagos in #1057
• Avoid using SwiftLint via Mint by @waliid in #1059
• Improve demo accessibility via VoiceOver by @defagos in #1062
• Fix player observability in response to media accessibility updates by @defagos in #1061
• Improve tool resilience to offline conditions by @defagos in #1064

Full Changelog: 5.0.0...6.0.0