Provide simplified tracks management

[MGaetan89]

Pull request

Description

This PR provides new APIs to manage audio/text/video tracks. The new APIs are located in the ch.srgssr.pillarbox.player.tracks package in the pillarbox-player module.

Tracks.tracks // Get all the supported tracks
Tracks.audioTracks // Get all the supported audio tracks
Tracks.textTracks // Get all the supported text tracks
Tracks.videoTracks // Get all the supported video tracks

Player.selectTrack(Track) // Select a single track
Player.enable<Audio|Text|Video>Track() // Enable a specific type of track
Player.disable<Audio|Text|Video>Track() // Disable a specific type of track
Player.setAuto<Audio|Text|Video>Track() // Restore the default track of a specific type

Changes made

• Revert the existing APIs to how they were in Pillarbox 1.0.0, to keep the existing behaviour
• Introduce new APIs to access/select/enable/disable audio/text/video tracks
• Deprecated the existing APIs with migration information to the new APIs
• Update both demo apps to add a Quality settings to allow the user to select the video quality
• The Player.videoQualities extension returns a modified subset of Tracks.videoTracks:
  • The list contains only one track with a specific Format.height
  • Only one quality is ever selected, independently of the selected video tracks

Behaviour changes

• The default aspect ratio now uses the first selected video track, instead of the first selected group of video tracks
• Duplicated tracks are no longer listed

Checklist

• Your branch has been rebased onto the main branch.
• APIs have been properly documented (if relevant).
• The documentation has been updated (if relevant).
• New unit tests have been written (if relevant).
• The demo has been updated (if relevant).
• All pull request status checks pass.

[github-actions]

Code Coverage

Overall Project	46.59% -0.59%	🟢
Files changed	32.52%	🟢

Module	Coverage
:pillarbox-core-business	85.02% -0.05%	🟢
:pillarbox-player	47.18% -1.2%	🟢
:pillarbox-ui	0% -0.25%	🟢

Files

Module	File	Coverage
:pillarbox-core-business	CommandersActStreaming.kt	96.43% -0.3%	🟢
:pillarbox-player	Tracks.kt	100%	🟢
	PlayerCallbackFlow.kt	78.03%	🟢
	TrackSelectionParameters.kt	1.77% -31.42%	🟢
	PlayerTracks.kt	0% -58.14%	🟢
:pillarbox-ui	PlayerSurface.kt	0% -1.65%	🟢

[MGaetan89]

I've updated the PR to:

• filter out video tracks with a trick-play role (765aad6)
• filter out video qualities without a size of 0 or negative (bca23e5)

[MGaetan89]

Moved back to in progress:

• Add a setting to change the video track
• Remove the quality selector, and create a dedicated story