Add native Android media controls for HA media_player entities

app/lint-baseline.xml

@@ -63,7 +63,7 @@
         errorLine2="        ^">
         <location
             file="src/main/kotlin/io/homeassistant/companion/android/util/DataUriDownloadManager.kt"
-            line="64"
+            line="65"
             column="9"/>
     </issue>
 
@@ -85,7 +85,7 @@
         errorLine2="                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~">
         <location
             file="src/main/kotlin/io/homeassistant/companion/android/notifications/MessagingManager.kt"
-            line="1095"
+            line="1097"
             column="17"/>
     </issue>
 
@@ -404,7 +404,7 @@
         errorLine2="     ~~~~~~~~~~~">
         <location
             file="src/main/AndroidManifest.xml"
-            line="89"
+            line="90"
             column="6"/>
     </issue>
 
@@ -646,7 +646,7 @@
         errorLine2="                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~">
         <location
             file="src/main/kotlin/io/homeassistant/companion/android/settings/SettingsFragment.kt"
-            line="539"
+            line="558"
             column="17"/>
     </issue>
 
@@ -657,7 +657,7 @@
         errorLine2="                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~">
         <location
             file="src/main/kotlin/io/homeassistant/companion/android/settings/SettingsFragment.kt"
-            line="539"
+            line="558"
             column="17"/>
     </issue>
 
@@ -1341,7 +1341,7 @@
         errorLine2="                     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~">
         <location
             file="src/main/kotlin/io/homeassistant/companion/android/settings/assist/AssistSettingsScreen.kt"
-            line="381"
+            line="342"
             column="22"/>
     </issue>
 

app/src/main/AndroidManifest.xml

@@ -36,6 +36,7 @@
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC"/>
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE_LOCATION"/>
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MICROPHONE"/>
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK"/>
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE_REMOTE_MESSAGING"/>
     <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW"/>
     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
@@ -322,6 +323,18 @@
             </intent-filter>
         </service>
 
+        <service
+            android:name=".mediacontrol.HaMediaSessionService"
+            android:exported="true"
+            android:foregroundServiceType="mediaPlayback"
+            tools:ignore="ExportedService">
+            <!-- Exported so system media controllers can bind to the session.
+                 Connections are filtered in MediaSession.Callback#onConnect. -->
+            <intent-filter>
+                <action android:name="androidx.media3.session.MediaSessionService"/>
+            </intent-filter>
+        </service>
+
         <activity android:name=".controls.HaControlsPanelActivity"
             android:permission="android.permission.BIND_CONTROLS"
             android:exported="true"

app/src/main/kotlin/io/homeassistant/companion/android/frontend/navigation/FrontendNavigation.kt

@@ -4,7 +4,11 @@ import android.net.Uri
 import androidx.annotation.VisibleForTesting
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.LaunchedEffect
+import androidx.compose.ui.platform.LocalContext
 import androidx.hilt.lifecycle.viewmodel.compose.hiltViewModel
+import androidx.lifecycle.Lifecycle
+import androidx.lifecycle.compose.LocalLifecycleOwner
+import androidx.lifecycle.repeatOnLifecycle
 import androidx.navigation.NavController
 import androidx.navigation.NavGraphBuilder
 import androidx.navigation.NavOptions
@@ -18,6 +22,7 @@ import io.homeassistant.companion.android.frontend.FrontendScreen
 import io.homeassistant.companion.android.frontend.FrontendViewModel
 import io.homeassistant.companion.android.frontend.FrontendViewState
 import io.homeassistant.companion.android.launch.HAStartDestinationRoute
+import io.homeassistant.companion.android.mediacontrol.MediaControlStarterViewModel
 import io.homeassistant.companion.android.settings.SettingsActivity
 import io.homeassistant.companion.android.util.getActivity
 import io.homeassistant.companion.android.webview.WebViewActivity
@@ -70,6 +75,15 @@ internal fun NavGraphBuilder.frontendScreen(
     if (WIPFeature.USE_FRONTEND_V2) {
         composable<FrontendRoute> {
             val viewModel: FrontendViewModel = hiltViewModel()
+            val mediaControlStarter: MediaControlStarterViewModel = hiltViewModel()
+            val context = LocalContext.current
+
+            val lifecycle = LocalLifecycleOwner.current.lifecycle
+            LaunchedEffect(lifecycle) {
+                lifecycle.repeatOnLifecycle(Lifecycle.State.RESUMED) {
+                    mediaControlStarter.startIfConfigured(context)
+                }
+            }
 
             FrontendNavigationHandler(
                 navigationEvents = viewModel.navigationEvents,

app/src/main/kotlin/io/homeassistant/companion/android/mediacontrol/HaMediaNotificationProvider.kt

@@ -0,0 +1,37 @@
+package io.homeassistant.companion.android.mediacontrol
+
+import android.content.Context
+import androidx.core.app.NotificationCompat
+import androidx.media3.common.util.UnstableApi
+import androidx.media3.session.CommandButton
+import androidx.media3.session.DefaultMediaNotificationProvider
+import androidx.media3.session.MediaNotification
+import androidx.media3.session.MediaSession
+import com.google.common.collect.ImmutableList
+import io.homeassistant.companion.android.common.R as commonR
+
+/**
+ * Extends [DefaultMediaNotificationProvider] to display the Home Assistant notification icon
+ * and the media player entity's friendly name as the notification sub-text.
+ *
+ * @param sessionEntityName Maps a session ID to the friendly name of its media_player entity.
+ *   May return null if the entity name is not yet known.
+ */
+@UnstableApi
+class HaMediaNotificationProvider(context: Context, private val sessionEntityName: (sessionId: String) -> String?) :
+    DefaultMediaNotificationProvider(context) {
+
+    init {
+        setSmallIcon(commonR.drawable.ic_stat_ic_notification)
+    }
+
+    override fun addNotificationActions(
+        mediaSession: MediaSession,
+        mediaButtons: ImmutableList<CommandButton>,
+        builder: NotificationCompat.Builder,
+        actionFactory: MediaNotification.ActionFactory,
+    ): IntArray {
+        sessionEntityName(mediaSession.id)?.let { builder.setSubText(it) }
+        return super.addNotificationActions(mediaSession, mediaButtons, builder, actionFactory)
+    }
+}