Feature: Offline Playback and Offline DRM

app/build.gradle.kts

@@ -1,5 +1,6 @@
 plugins {
   alias(libs.plugins.android.application)
+  alias(libs.plugins.kotlin.compose)
 }
 
 android {
@@ -18,6 +19,7 @@ android {
 
   buildFeatures {
     viewBinding = true
+    compose = true
   }
   buildTypes {
     release {
@@ -39,6 +41,17 @@ dependencies {
   implementation(libs.androidx.recyclerview)
   implementation(libs.androidx.activity.ktx)
 
+  // Compose, used by the offline-downloads example
+  implementation(platform(libs.androidx.compose.bom))
+  implementation(libs.androidx.compose.ui)
+  implementation(libs.androidx.compose.material3)
+  implementation(libs.androidx.compose.ui.tooling.preview)
+  implementation(libs.androidx.compose.material.icons.core)
+  implementation(libs.androidx.activity.compose)
+  implementation(libs.androidx.lifecycle.viewmodel.compose)
+  implementation(libs.androidx.lifecycle.runtime.compose)
+  debugImplementation(libs.androidx.compose.ui.tooling)
+
   implementation(project(":library"))
 
   testImplementation(libs.junit)

app/src/main/AndroidManifest.xml

@@ -2,6 +2,18 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
     xmlns:tools="http://schemas.android.com/tools">
 
+    <!-- ===== Mux Player offline downloads =====
+         Only required if the app uses Mux Player's offline download support. The mux-player library
+         intentionally does not declare these, since they are sensitive and shouldn't be forced on
+         apps that don't download media. See the matching <service> block below in <application>. -->
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC"/>
+    <!-- Required for DownloadService progress notifications on API 33+ (also request at runtime) -->
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
+    <!-- Lets PlatformScheduler restart downloads after a device reboot -->
+    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
+    <!-- ===== end Mux Player offline downloads ===== -->
+
     <application
         android:allowBackup="true"
         android:dataExtractionRules="@xml/data_extraction_rules"
@@ -30,6 +42,11 @@
             android:name=".examples.SmartCacheActivity"
             android:exported="false"
             android:label="Smart Caching Example" />
+        <activity
+            android:name=".examples.offline.OfflineDownloadsActivity"
+            android:exported="false"
+            android:label="Offline Downloads Example"
+            android:theme="@style/Theme.MuxVideoMedia3.NoActionBar" />
         <activity
             android:name=".MainActivity"
             android:exported="true"
@@ -40,6 +57,26 @@
                 <category android:name="android.intent.category.LAUNCHER" />
             </intent-filter>
         </activity>
+
+        <!-- ===== Mux Player offline downloads =====
+             Only required if the app uses Mux Player's offline download support. Paired with the
+             permissions declared above at the top of the manifest. -->
+        <service
+            android:name="com.mux.player.offline.MuxDownloadService"
+            android:foregroundServiceType="dataSync"
+            android:exported="false">
+            <intent-filter>
+                <action android:name="androidx.media3.exoplayer.downloadService.action.RESTART"/>
+                <category android:name="android.intent.category.DEFAULT"/>
+            </intent-filter>
+        </service>
+        <!-- JobService used by PlatformScheduler (MuxDownloadService.getScheduler()) to reschedule
+             downloads when their requirements are met and after a reboot -->
+        <service
+            android:name="androidx.media3.exoplayer.scheduler.PlatformScheduler$PlatformSchedulerService"
+            android:permission="android.permission.BIND_JOB_SERVICE"
+            android:exported="true"/>
+        <!-- ===== end Mux Player offline downloads ===== -->
     </application>
 
 </manifest>

app/src/main/java/com/mux/player/media3/MainActivity.kt

@@ -19,6 +19,7 @@ import com.mux.player.media3.examples.BasicPlayerActivity
 import com.mux.player.media3.examples.ConfigurablePlayerActivity
 import com.mux.player.media3.examples.SmartCacheActivity
 import com.mux.player.media3.examples.carousel.PlayerCarouselActivity
+import com.mux.player.media3.examples.offline.OfflineDownloadsActivity
 
 class MainActivity : AppCompatActivity() {
 
@@ -73,6 +74,10 @@ class MainActivity : AppCompatActivity() {
       title = "Smart Caching",
       destination = Intent(this@MainActivity, SmartCacheActivity::class.java)
     ),
+    Example(
+      title = "Offline Downloads",
+      destination = Intent(this@MainActivity, OfflineDownloadsActivity::class.java)
+    ),
   )
 }
 

app/src/main/java/com/mux/player/media3/examples/offline/DownloadableAssets.kt

@@ -0,0 +1,72 @@
+package com.mux.player.media3.examples.offline
+
+import androidx.media3.common.MediaItem
+import com.mux.player.media.MediaItems
+import com.mux.player.media3.PlaybackIds
+
+/**
+ * One Mux asset this example knows how to download.
+ *
+ * @param title A human-readable name, shown in the UI. Not used by the download itself.
+ * @param playbackId The Mux playback ID. This is also the download's ID.
+ * @param playbackToken Required for signed playback and DRM. See [MediaItems.fromMuxPlaybackId].
+ * @param drmToken Required for DRM playback. DRM assets need *both* tokens.
+ */
+data class DownloadableAsset(
+  val title: String,
+  val playbackId: String,
+  val playbackToken: String? = null,
+  val drmToken: String? = null,
+) {
+
+  /**
+   * The [MediaItem] to hand to [com.mux.player.offline.MuxDownloadManager.startDownload]. It's an
+   * ordinary Mux MediaItem — the same one you'd use for streaming playback.
+   */
+  fun toMediaItem(): MediaItem = MediaItems.fromMuxPlaybackId(
+    playbackId = playbackId,
+    playbackToken = playbackToken,
+    drmToken = drmToken,
+  )
+}
+
+/**
+ * The assets offered on the 'Select Asset' screen. Compiled in for the sake of the example; a real
+ * app would fetch its catalog from its own backend.
+ */
+object DownloadableAssets {
+
+  val all: List<DownloadableAsset> = listOf(
+    DownloadableAsset(
+      title = "Tears of Steel",
+      playbackId = PlaybackIds.TEARS_OF_STEEL,
+    ),
+    DownloadableAsset(
+      title = "The Making of Big Buck Bunny",
+      playbackId = PlaybackIds.MAKING_OF_BUCK_BUNNY,
+    ),
+    DownloadableAsset(
+      title = "Elephants Dream",
+      playbackId = PlaybackIds.ELEPHANTS_DREAM,
+    ),
+    DownloadableAsset(
+      title = "Mux Marketing Video",
+      playbackId = PlaybackIds.MUX_MARKETING_VIDEO,
+    ),
+    // To download a DRM asset, add both tokens, which your backend generates:
+    // DownloadableAsset(
+    //   title = "My DRM Asset",
+    //   playbackId = "...",
+    //   playbackToken = "...",
+    //   drmToken = "...",
+    // ),
+  )
+
+  /**
+   * The title for [playbackId], or the playback ID itself if it isn't in [all]. Downloads outlive
+   * the catalog they came from (they're on disk between app launches), so the UI can't assume a
+   * download's asset is still listed.
+   */
+  fun titleFor(playbackId: String): String =
+    all.firstOrNull { it.playbackId == playbackId }?.title ?: playbackId
+}