Release 0.31.0

.github/workflows/ci-ios-tvos.yml

@@ -78,9 +78,7 @@ jobs:
           restore-keys: pods-
 
       - name: Install pods
-        run: |
-          pod repo add bitmovin https://github.com/bitmovin/cocoapod-specs.git || pod repo update bitmovin
-          yarn pods
+        run: yarn pods
         env:
           CP_HOME_DIR: ${{ github.workspace }}/.cocoapods-cache
 
@@ -131,9 +129,7 @@ jobs:
           restore-keys: pods-
 
       - name: Install pods
-        run: |
-          pod repo add bitmovin https://github.com/bitmovin/cocoapod-specs.git || pod repo update bitmovin
-          yarn example pods
+        run: yarn example pods
         env:
           CP_HOME_DIR: ${{ github.workspace }}/.cocoapods-cache
 

.github/workflows/create-sdk-update-pr.yml

@@ -66,7 +66,6 @@ jobs:
         if: ${{ inputs.sdk_name == 'ios' }}
         run: |
           sed -i '' 's/s.dependency "BitmovinPlayer", ".*/s.dependency "BitmovinPlayer", "${{ inputs.version_number }}"/g' RNBitmovinPlayer.podspec
-          pod repo add bitmovin https://github.com/bitmovin/cocoapod-specs.git
           yarn bootstrap
 
       - name: Save Pods cache

.github/workflows/start-release-train.yml

@@ -77,13 +77,6 @@ jobs:
         run: |
           yarn version --new-version ${{ inputs.version_number }} --no-git-tag-version
 
-      - name: Set up CocoaPods
-        run: |
-          pod repo add bitmovin https://github.com/bitmovin/cocoapod-specs.git || pod repo update bitmovin
-        working-directory: example/ios
-        env:
-          CP_HOME_DIR: ${{ github.workspace }}/.cocoapods-cache
-
       - name: Install pods to update Podfile.lock
         run: |
           yarn bootstrap

CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [0.31.0]
+
+### Added
+
+- `MediaControlConfig` to configure the media control information for the application. When `isEnabled` is `true`, the current media information will be shown on the lock-screen, in notifications, and within the control center
+- Android: `playerConfig.playbackConfig.isBackgroundPlaybackEnabled` to support background playback
+
+### Changed
+
+- Update Bitmovin's native Android SDK version to `3.91.0`
+
+### Deprecated
+
+- `TweaksConfig.updatesNowPlayingInfoCenter` in favor of `MediaControlConfig.isEnabled`
+
 ## [0.30.0] - 2024-10-31
 
 ### Changed

android/build.gradle

@@ -105,5 +105,6 @@ dependencies {
     // Bitmovin
     implementation 'com.google.ads.interactivemedia.v3:interactivemedia:3.33.0'
     implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'
-    implementation 'com.bitmovin.player:player:3.90.0+jason'
+    implementation 'com.bitmovin.player:player:3.91.0+jason'
+    implementation 'com.bitmovin.player:player-media-session:3.91.0+jason'
 }

android/src/main/java/com/bitmovin/player/reactnative/MediaSessionPlaybackManager.kt

@@ -0,0 +1,50 @@
+package com.bitmovin.player.reactnative
+
+import android.content.ComponentName
+import android.content.Context
+import android.content.Intent
+import android.content.ServiceConnection
+import android.os.IBinder
+import com.bitmovin.player.api.Player
+import com.bitmovin.player.reactnative.extensions.playerModule
+import com.bitmovin.player.reactnative.services.MediaSessionPlaybackService
+import com.facebook.react.bridge.*
+
+class MediaSessionPlaybackManager(val context: ReactApplicationContext) {
+    private var serviceBinder: MediaSessionPlaybackService.ServiceBinder? = null
+    private lateinit var playerId: NativeId
+    val player: Player?
+        get() = serviceBinder?.player
+
+    inner class MediaSessionPlaybackServiceConnection : ServiceConnection {
+        override fun onServiceConnected(className: ComponentName, service: IBinder) {
+            val binder = service as MediaSessionPlaybackService.ServiceBinder
+            serviceBinder = binder
+            binder.player = getPlayer()
+        }
+
+        override fun onServiceDisconnected(name: ComponentName) {
+            destroy(playerId)
+        }
+    }
+
+    fun setupMediaSessionPlayback(playerId: NativeId) {
+        this.playerId = playerId
+
+        val intent = Intent(context, MediaSessionPlaybackService::class.java)
+        intent.action = Intent.ACTION_MEDIA_BUTTON
+        val connection: ServiceConnection = MediaSessionPlaybackServiceConnection()
+        context.bindService(intent, connection, Context.BIND_AUTO_CREATE)
+    }
+
+    fun destroy(nativeId: NativeId) {
+        if (nativeId != playerId) { return }
+        serviceBinder?.player = null
+        serviceBinder = null
+    }
+
+    private fun getPlayer(
+        nativeId: NativeId = playerId,
+        playerModule: PlayerModule? = context.playerModule,
+    ): Player = playerModule?.getPlayerOrNull(nativeId) ?: throw IllegalArgumentException("Invalid PlayerId $nativeId")
+}

android/src/main/java/com/bitmovin/player/reactnative/PlayerModule.kt

@@ -10,6 +10,7 @@ import com.bitmovin.player.reactnative.converter.toAdItem
 import com.bitmovin.player.reactnative.converter.toAnalyticsConfig
 import com.bitmovin.player.reactnative.converter.toAnalyticsDefaultMetadata
 import com.bitmovin.player.reactnative.converter.toJson
+import com.bitmovin.player.reactnative.converter.toMediaControlConfig
 import com.bitmovin.player.reactnative.converter.toPlayerConfig
 import com.bitmovin.player.reactnative.extensions.mapToReactArray
 import com.facebook.react.bridge.*
@@ -25,6 +26,8 @@ class PlayerModule(context: ReactApplicationContext) : BitmovinBaseModule(contex
      */
     private val players: Registry<Player> = mutableMapOf()
 
+    val mediaSessionPlaybackManager = MediaSessionPlaybackManager(context)
+
     /**
      * JS exported module name.
      */
@@ -74,6 +77,8 @@ class PlayerModule(context: ReactApplicationContext) : BitmovinBaseModule(contex
         val playerConfig = playerConfigJson?.toPlayerConfig() ?: PlayerConfig()
         val analyticsConfig = analyticsConfigJson?.toAnalyticsConfig()
         val defaultMetadata = analyticsConfigJson?.getMap("defaultMetadata")?.toAnalyticsDefaultMetadata()
+        val enableMediaSession = playerConfigJson?.getMap("mediaControlConfig")
+            ?.toMediaControlConfig()?.isEnabled ?: true
 
         val networkConfig = networkNativeId?.let { networkModule.getConfig(it) }
         if (networkConfig != null) {
@@ -90,6 +95,12 @@ class PlayerModule(context: ReactApplicationContext) : BitmovinBaseModule(contex
                 defaultMetadata = defaultMetadata ?: DefaultMetadata(),
             )
         }
+
+        if (enableMediaSession) {
+            promise.unit.resolveOnUiThread {
+                mediaSessionPlaybackManager.setupMediaSessionPlayback(nativeId)
+            }
+        }
     }
 
     /**
@@ -211,6 +222,7 @@ class PlayerModule(context: ReactApplicationContext) : BitmovinBaseModule(contex
      */
     @ReactMethod
     fun destroy(nativeId: NativeId, promise: Promise) {
+        mediaSessionPlaybackManager.destroy(nativeId)
         promise.unit.resolveOnUiThreadWithPlayer(nativeId) {
             destroy()
             players.remove(nativeId)

android/src/main/java/com/bitmovin/player/reactnative/RNPlayerView.kt

@@ -16,6 +16,7 @@ import com.bitmovin.player.api.event.SourceEvent
 import com.bitmovin.player.api.ui.PlayerViewConfig
 import com.bitmovin.player.api.ui.StyleConfig
 import com.bitmovin.player.reactnative.converter.toJson
+import com.bitmovin.player.reactnative.extensions.playerModule
 import com.facebook.react.ReactActivity
 import com.facebook.react.bridge.*
 import com.facebook.react.uimanager.events.RCTEventEmitter
@@ -102,8 +103,23 @@ class RNPlayerView(
     private val activityLifecycle = (context.currentActivity as? ReactActivity)?.lifecycle
         ?: error("Trying to create an instance of ${this::class.simpleName} while not attached to a ReactActivity")
 
+    /**
+     * Relays the provided set of events, emitted by the player, together with the associated name
+     * to the `eventOutput` callback.
+     */
+    private var playerEventRelay: EventRelay<Player, Event> = EventRelay<Player, Event>(
+        EVENT_CLASS_TO_REACT_NATIVE_NAME_MAPPING,
+        ::emitEventFromPlayer,
+    )
+
+    internal var enableBackgroundPlayback: Boolean = false
+    var playerInMediaSessionService: Player? = null
+
     private val activityLifecycleObserver = object : DefaultLifecycleObserver {
         override fun onStart(owner: LifecycleOwner) {
+            if (playerInMediaSessionService != null) {
+                playerView?.player = playerInMediaSessionService
+            }
             playerView?.onStart()
         }
 
@@ -116,10 +132,28 @@ class RNPlayerView(
         }
 
         override fun onStop(owner: LifecycleOwner) {
+            removePlayerForBackgroundPlayback()
             playerView?.onStop()
         }
 
         override fun onDestroy(owner: LifecycleOwner) = dispose()
+
+        // When background playback is enabled,
+        // remove player from view so it does not get paused when entering background
+        private fun removePlayerForBackgroundPlayback() {
+            playerInMediaSessionService = null
+            val player = playerView?.player ?: return
+
+            if (!enableBackgroundPlayback) {
+                return
+            }
+            if (context.playerModule?.mediaSessionPlaybackManager?.player != player) {
+                return
+            }
+
+            playerInMediaSessionService = player
+            playerView?.player = null
+        }
     }
 
     init {
@@ -133,15 +167,6 @@ class RNPlayerView(
         activityLifecycle.addObserver(activityLifecycleObserver)
     }
 
-    /**
-     * Relays the provided set of events, emitted by the player, together with the associated name
-     * to the `eventOutput` callback.
-     */
-    private val playerEventRelay = EventRelay<Player, Event>(
-        EVENT_CLASS_TO_REACT_NATIVE_NAME_MAPPING,
-        ::emitEventFromPlayer,
-    )
-
     /**
      * Relays the provided set of events, emitted by the player view, together with the associated name
      * to the `eventOutput` callback.

android/src/main/java/com/bitmovin/player/reactnative/RNPlayerViewManager.kt

@@ -248,6 +248,7 @@ class RNPlayerViewManager(private val context: ReactApplicationContext) : Simple
             val playbackConfig = playerConfig?.getMap("playbackConfig")
             val isPictureInPictureEnabled = view.config?.pictureInPictureConfig?.isEnabled == true ||
                 playbackConfig?.getBooleanOrNull("isPictureInPictureEnabled") == true
+            view.enableBackgroundPlayback = playbackConfig?.getBoolean("isBackgroundPlaybackEnabled") ?: false
 
             val rnStyleConfigWrapper = playerConfig?.toRNStyleConfigWrapperFromPlayerConfig()
             val configuredPlayerViewConfig = view.config?.playerViewConfig ?: PlayerViewConfig()

android/src/main/java/com/bitmovin/player/reactnative/converter/JsonConverter.kt

@@ -898,6 +898,14 @@ fun String.toMediaType(): MediaType? = when (this) {
     else -> null
 }
 
+data class MediaControlConfig(
+    var isEnabled: Boolean = true,
+)
+
+fun ReadableMap.toMediaControlConfig(): MediaControlConfig = MediaControlConfig().apply {
+    withBoolean("isEnabled") { isEnabled = it }
+}
+
 /**
  * Converts a [CastPayload] object into its JS representation.
  */

android/src/main/java/com/bitmovin/player/reactnative/services/MediaSessionPlaybackService.kt

@@ -0,0 +1,59 @@
+package com.bitmovin.player.reactnative.services
+
+import android.content.Intent
+import android.os.Binder
+import android.os.IBinder
+import com.bitmovin.player.api.Player
+import com.bitmovin.player.api.media.session.MediaSession
+import com.bitmovin.player.api.media.session.MediaSessionService
+
+class MediaSessionPlaybackService : MediaSessionService() {
+    inner class ServiceBinder : Binder() {
+        var player: Player?
+            get() = [email protected]
+            set(value) {
+                if (player == value) {
+                    return
+                }
+
+                disconnectSession()
+                [email protected] = value
+                value?.let {
+                    createSession(it)
+                    connectSession()
+                }
+            }
+    }
+
+    private var player: Player? = null
+    private val binder = ServiceBinder()
+    private var mediaSession: MediaSession? = null
+
+    override fun onGetSession(): MediaSession? = null
+
+    override fun onDestroy() {
+        disconnectSession()
+        player = null
+
+        super.onDestroy()
+    }
+
+    override fun onBind(intent: Intent?): IBinder {
+        super.onBind(intent)
+        return binder
+    }
+
+    private fun createSession(player: Player) {
+        mediaSession = MediaSession(
+            this,
+            mainLooper,
+            player,
+        )
+    }
+
+    private fun connectSession() = mediaSession?.let { addSession(it) }
+    private fun disconnectSession() = mediaSession?.let {
+        removeSession(it)
+        it.release()
+    }
+}

example/android/app/src/main/AndroidManifest.xml

@@ -9,6 +9,7 @@
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" />
     <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
 <!--END-->
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />
 
     <application
       android:name=".MainApplication"
@@ -52,5 +53,14 @@
             android:name="com.google.android.gms.cast.framework.OPTIONS_PROVIDER_CLASS_NAME"
             android:value="com.bitmovin.player.casting.BitmovinCastOptionsProvider" />
 
+      <service
+          android:name="com.bitmovin.player.reactnative.services.MediaSessionPlaybackService"
+          android:foregroundServiceType="mediaPlayback"
+          android:exported="true">
+          <intent-filter>
+              <action android:name="androidx.media3.session.MediaSessionService"/>
+          </intent-filter>
+      </service>
+
     </application>
 </manifest>

example/ios/Podfile

@@ -2,7 +2,6 @@ require_relative '../node_modules/react-native/scripts/react_native_pods'
 require_relative '../node_modules/@react-native-community/cli-platform-ios/native_modules'
 
 source 'https://cdn.cocoapods.org'
-source 'https://github.com/bitmovin/cocoapod-specs.git'
 source 'https://github.com/react-native-tvos/react-native-tvos-podspecs.git'
 
 prepare_react_native_project!