media3-background-playback-service

Stars13

Forks3

UpdatedJuly 23, 2026 at 11:24

Compact skill for Media3 MediaSessionService, MediaController, notification, media buttons, and service lifetime.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

sunnat629

sunnat629/android-media-pack

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	media3-background-playback-service
description	Compact skill for Media3 MediaSessionService, MediaController, notification, media buttons, and service lifetime.
license	Apache-2.0
metadata	{"author":"Shunnek Labs","version":"1.2","target_media3_version":"1.10.1","last_reviewed":"2026-07-23","keywords":["android","media3","mediasessionservice","mediasession","mediacontroller","foreground-service","notification"]}

Trigger

Use when playback must survive Activity recreation/backgrounding or expose system notification, media buttons, external controllers.

Rules

Start with streaming-media-architecture for ownership, KMP split, preload window, and telemetry.
Pin Media3 to 1.10.1 through the version catalog.
Keep Media3 APIs in Android source sets; expose KMP-safe state/events upward.
Exactly one service-owned player for background/session playback.
UI talks through MediaController; UI does not own the service player.
You MUST declare both android.permission.FOREGROUND_SERVICE and android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK; both are mandatory on targetSdk 34+.
The service manifest entry MUST include the androidx.media3.session.MediaSessionService intent-filter action; add android.media.browse.MediaBrowserService so legacy browser clients (for example Android Auto) can bind.
Do not use legacy MediaSessionCompat, MediaSessionConnector, or PlayerNotificationManager.

Example

<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />

<service android:name=".playback.PlaybackService"
    android:exported="true"
    android:foregroundServiceType="mediaPlayback">
    <intent-filter>
        <action android:name="androidx.media3.session.MediaSessionService" />
        <action android:name="android.media.browse.MediaBrowserService" />
    </intent-filter>
</service>

media3-lifecycle-state
media3-audio-playback
media3-video-playback

More from this repository

same repository

media3-ads-ima

sunnat629/android-media-pack

Compact skill for Media3 Google IMA CSAI/SSAI ad insertion, AdViewProvider, companions, and ad telemetry.

2026-07-2313

media3-workmanager-offline-ops

sunnat629/android-media-pack

Compact skill for Media3 offline downloads with DownloadService, DownloadManager, Requirements, and the WorkManagerScheduler role of media3-exoplayer-workmanager.

2026-07-2313

media3-bandwidth-abr

sunnat629/android-media-pack

Compact skill for Media3 bandwidth estimation, ABR limits, load control, network constraints, and preload contention.

2026-07-2313

media3-cast-integration

sunnat629/android-media-pack

Compact skill for Media3 CastPlayer.Builder, automatic local/remote handoff, MediaRouteButton, and Cast session lifecycle.

2026-07-2313

media3-datasources-networking

sunnat629/android-media-pack

Compact skill for Media3 HTTP DataSource, OkHttp/Cronet/HttpEngine, cache, headers, auth, and custom DataSource decisions.

2026-07-2313

media3-inspector-metadata-thumbnails

sunnat629/android-media-pack

Compact skill for Media3 inspector metadata, thumbnail/frame extraction, and container sample inspection without playback.

2026-07-2313

name	media3-background-playback-service
description	Compact skill for Media3 MediaSessionService, MediaController, notification, media buttons, and service lifetime.
license	Apache-2.0
metadata	{"author":"Shunnek Labs","version":"1.2","target_media3_version":"1.10.1","last_reviewed":"2026-07-23","keywords":["android","media3","mediasessionservice","mediasession","mediacontroller","foreground-service","notification"]}

Trigger

Use when playback must survive Activity recreation/backgrounding or expose system notification, media buttons, external controllers.

Rules

Start with streaming-media-architecture for ownership, KMP split, preload window, and telemetry.
Pin Media3 to 1.10.1 through the version catalog.
Keep Media3 APIs in Android source sets; expose KMP-safe state/events upward.
Exactly one service-owned player for background/session playback.
UI talks through MediaController; UI does not own the service player.
You MUST declare both android.permission.FOREGROUND_SERVICE and android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK; both are mandatory on targetSdk 34+.
The service manifest entry MUST include the androidx.media3.session.MediaSessionService intent-filter action; add android.media.browse.MediaBrowserService so legacy browser clients (for example Android Auto) can bind.
Do not use legacy MediaSessionCompat, MediaSessionConnector, or PlayerNotificationManager.

Example

<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK" />

<service android:name=".playback.PlaybackService"
    android:exported="true"
    android:foregroundServiceType="mediaPlayback">
    <intent-filter>
        <action android:name="androidx.media3.session.MediaSessionService" />
        <action android:name="android.media.browse.MediaBrowserService" />
    </intent-filter>
</service>

media3-lifecycle-state
media3-audio-playback
media3-video-playback