Audio tracks, subtitles and user consent

[waliid]

This release adds support for audio tracks and subtitles.

Audio tracks and subtitles

• Add media selection APIs to retrieve available and selected audio tracks and subtitles or to change the current selection.
• Display forced subtitles when available.
• Automatically prefer tracks intended for Audio Description and SDH & CC depending on device accessibility settings.
• Override media selection programmatically.
• Override subtitle text style programmatically (WebVTT only).
• Provide standard menu for audio tracks and subtitles.

Global analytics labels and user consent support

• You can optionally provide an AnalyticsDataSource when starting Analytics. This data source can be used to deliver global labels in all comScore and Commanders Act events.
• User consent can be provided in comScore and Commanders Act global labels.

Breaking changes

• The restart and canRestart APIs have been renamed as replay and canReplay respectively. These APIs now always resume playback if needed.

Miscellaneous improvements

• Prevent playback of content containing at least a blocked segment.
• Improve automatic visibility management.
• Improve SRG SSR resource resolution to prefer HLS streams when available, most notably for SWI content.
• Add playbackSpeed binding API.
• Provide playback speed selection in standard menu API.
• Remove unused Diagnostics and UserInterface packages.
• Remove unused Google Cast SDK dependency.

Fixes

• Fix playback crashing when seeking near the end of some streams.
• Always send uptime to Commanders Act for livestreams, no matter the offset from the live edge.
• Fix player leak on tvOS.
• Fix never-ending slider interactions.
• Retrieve SRG SSR metadata on a device basis (vector).
• Fix unplayable RTS audio content.

What's Changed

• Update CI documentation for reliable git-describe results by @defagos in Update CI documentation for reliable git-describe results #497
• Generate local stream for subtitles and audio tracks by @waliid in Generate local stream for subtitles and audio tracks #498
• Add support for subtitles and audio tracks by @defagos in Add support for subtitles and audio tracks #516
• Reduce stale bot threshold by @defagos in Reduce stale bot threshold #517
• Retrieve media composition specific to supported vectors by @defagos in Retrieve media composition specific to supported vectors #519
• Avoid sound playing for a short while after system player UI dismissal on tvOS by @defagos in Avoid sound playing for a short while after system player UI dismissal on tvOS #522
• Add WWDC Keynote stream to examples by @defagos in Add WWDC Keynote stream to examples #525
• Keep user interface visible when seeking within an audio by @defagos in Keep user interface visible when seeking within an audio #527
• Properly ensure menu item ordering by @defagos in Properly ensure menu item ordering #529
• Always send uptime for livestreams by @defagos in Always send uptime for livestreams #531
• Replace deprecated stale bot with maintained one by @defagos in Replace deprecated stale bot with maintained one #530
• Use view modifiers where appropriate by @defagos in Use view modifiers where appropriate #532
• Show user interface when returning to the foreground while not playing by @defagos in Show user interface when returning to the foreground while not playing #526
• Fix neverending custom slider interactions by @defagos in Fix neverending custom slider interactions #528
• Add support for forced subtitles by @defagos in Add support for forced subtitles #533
• Show user interface when playback is paused by @defagos in Show user interface when playback is paused #535
• Add SDH and CC support by @defagos in Add SDH and CC support #536
• Update correctly subtitle selection by @waliid in Update correctly subtitle selection #538
• Update advice about automatic audio rendition selection by @defagos in Update advice about automatic audio rendition selection #539
• Enhancing the media selection options by @waliid in Enhancing the media selection options #544
• Update YouTubeKit by @waliid in Update YouTubeKit #543
• Support subtitle appearance customization by @defagos in Support subtitle appearance customization #545
• Improve default language ordering by @waliid in Improve default language ordering #546
• Add priority on supported streaming methods by @waliid in Add priority on supported streaming methods #547
• Reset media selection context when no item is being played by @defagos in Reset media selection context when no item is being played #549
• Make efficient seeks near the end of the available range safe by @waliid in Make efficient seeks near the end of the available range safe #550
• Rename restart API as replay by @defagos in Rename restart API as replay #551
• Add audio tracks and subtitles analytics by @waliid in Add audio tracks and subtitles analytics #552
• Fix media composition parsing by @waliid in Fix media composition parsing  #554
• Use page name instead of content title for Commanders Act by @waliid in Use page name instead of content title for Commanders Act #557
• Prevent any chapter from being played if one of its segments is blocked by @defagos in Prevent any chapter from being played if one of its segments is blocked #558
• Add support for user consent by @waliid in Add support for user consent #561
• Cleanup unused packages and dependencies by @defagos in Cleanup unused packages and dependencies #565
• Use Commanders Act debug source key in unit tests by @defagos in Use Commanders Act debug source key in unit tests #563
• Revisit menu API by @defagos in Revisit menu API #570
• Update for Xcode 15 and iOS / tvOS 17 support by @defagos in Update for Xcode 15 and iOS / tvOS 17 support #569

Full Changelog: 0.5.1...0.6.0

---

This discussion was created from the release Audio tracks, subtitles and user consent.