2.0.0

[MGaetan89]

Player

• Improved system integration and background playback through custom MediaController and MediaSession classes. Check the documentation for more information.
• Added a new Player.isAtLiveEdge(Long, Window) method to know if the media is at live edge.
• New way to load a media from a custom source by providing a custom AssetLoader implementation:

val player = PillarboxExoPlayer(
    context = context,
    mediaSourceFactory = PillarboxMediaSourceFactory(context).apply {
        addAssetLoader(SRGAssetLoader(context)) // Provided by pillarbox-core-business to handled URNs
        addAssetLoader(MyCustomAssetLoader())
    },
)

• Added new methods to easily manage tracks:

val player: Player = ...
val currentTracks: Tracks = player.currentTracks

val tracks: List<Track> = currentTracks.tracks // Get all the supported tracks
val audioTracks: List<AudioTrack> = currentTracks.audioTracks // Get all the supported audio tracks
val textTracks: List<TextTrack> = currentTracks.textTracks // Get all the supported text tracks
val videoTracks: List<VideoTrack> = currentTracks.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

• Added support for blocked segments.
• Added support for chapters. You can use the following methods to access the corresponding information:

Player.getCurrentChapters(): List<Chapter> // Get all the chapters for the current media
Player.getChapterAtPosition(Long): Chapter? // Get the chapter at the provided position
Player.getCurrentChapterAsFlow(): Flow<Chapter?> // Observe the chapter currently playing as Flow
Player.getCurrentChapterAsState(): State<Chapter?> // Observe the chapter currently playing as State

• Added support for time intervals (intro/credits). You can use the following methods to access the corresponding information:

Player.getCurrentCredits(): List<Credit> // Get all the credits for the current media (opening credits, closing credits)
Player.getCreditAtPosition(Long): Credit? // Get the credit at the provided position
Player.getCurrentCreditAsFlow(): Flow<Credit?> // Observe the credit currently active as Flow
Player.getCurrentCreditAsState(): State<Credit?> // Observe the credit currently active as State

Core business

• Extract information about blocked segments, chapters and credits.

Demo

• The multi-player showcase has been improved to only have one player playing audio at a given time.
• Added a showcase to toggle repeat mode and to pause the media item when it ends.
• Added a showcase to display chapters.
• Added a showcase with a blocked segment.

Breaking changes

• The mediaItemSource and dataSourceFactory arguments of the DefaultPillarbox constructor have been removed. Please provide a MediaCompositionService directly. The MediaCompositionMediaItemSource class and its related classes have been removed.
• PillarboxExoPlayer is now a concrete class, while PillarboxPlayer has become an interface. Simply replace your usages of PillarboxPlayer by PillarboxExoPlayer, and PillarboxExoPlayer by PillarboxPlayer:

// Pillarbox 1.0.0
val player: PillarboxExoPlayer = PillarboxPlayer(...)

// Pillarbox 1.1.0
val player: PillarboxPlayer = PillarboxExoPlayer(...)

Note

Following a change in AndroidX Media3 1.3.0, you should setup Java 8 APIs desugaring, by following this guide.
This is new requirement should be reverted in an upcoming version of AndroidX Media3 (see androidx/media#1312 (comment) for more information).
This should be done even if your min SDK version is 24+.

What's Changed

• Update README.md by @StaehliJ in Update README.md #471
• Use movable content to swap players by @StaehliJ in Use movable content to swap players #472
• Refactor Gradle build logic by @MGaetan89 in Refactor Gradle build logic #474
• Refactor media loading by @StaehliJ in Refactor media loading #475
• Update dependencies by @MGaetan89 in Update dependencies #481
• Update Robolectric to 4.12.1 by @MGaetan89 in Update Robolectric to 4.12.1 #482
• Improve the multi player showcase by @MGaetan89 in Improve the multi player showcase #478
• Extract analytics from CurrentMediaItemTracker by @MGaetan89 in Extract analytics from CurrentMediaItemTracker #483
• Don't filter out unsupported/forced tracks by @MGaetan89 in Don't filter out unsupported/forced tracks #487
• Improve media controller service by @StaehliJ in Improve media controller service #485
• Add live indicator by @StaehliJ in Add live indicator #489
• Update the "Add to playlist" dialog by @MGaetan89 in Update the "Add to playlist" dialog #490
• Rework the main Readme by @MGaetan89 in Rework the main Readme #491
• Update dependencies by @MGaetan89 in Update dependencies #494
• Update 12h45 stream in the demo app by @waliid in Update 12h45 stream in the demo app #498
• Setup Dependabot by @MGaetan89 in Setup Dependabot #496
• Bump the actions group with 2 updates by @dependabot in Bump the actions group with 2 updates #502
• Bump the androidx group with 6 updates by @dependabot in Bump the androidx group with 6 updates #504
• Improve live edge detection and provide Player extension by @StaehliJ in Improve live edge detection and provide Player extension #505
• 451 handle chapters and blocked segments by @StaehliJ in 451 handle chapters and blocked segments #501
• Provide simplified tracks management by @MGaetan89 in Provide simplified tracks management #495
• Enable desugaring of java 8+ feature for android < 24 by @StaehliJ in Enable desugaring of java 8+ feature for android < 24 #509
• Mitigate missing aspect ratio issue by @MGaetan89 in Mitigate missing aspect ratio issue #507
• Add a showcase to customise playback settings by @MGaetan89 in Add a showcase to customise playback settings #510
• 499 add chapters demo by @StaehliJ in 499 add chapters demo #513
• 506 remove audio chapters by @StaehliJ in 506 remove audio chapters #514
• Add support for "Skip intro"/"Skip credits" by @MGaetan89 in Add support for "Skip intro"/"Skip credits" #516
• Improve controls usability in the TV demo by @MGaetan89 in Improve controls usability in the TV demo #520
• 519 simplify TimeRange management by @StaehliJ in 519 simplify TimeRange management #521
• Separate TimeRanges are it is a sealed interface and we don't really … by @StaehliJ in Separate TimeRanges are it is a sealed interface and we don't really … #524
• Make the Dependency Analysis plugin only fails for unused dependencies by @MGaetan89 in Make the Dependency Analysis plugin only fails for unused dependencies #526
• Fix urn name in the demo by @StaehliJ in Fix urn name in the demo #527
• Integrate Dokka by @MGaetan89 in Integrate Dokka #529

New Contributors

• @waliid made their first contribution in Update 12h45 stream in the demo app #498
• @dependabot made their first contribution in Bump the actions group with 2 updates #502

Full Changelog: 1.0.0...2.0.0

---

This discussion was created from the release 2.0.0.