Spec: MediaNowPlaying
Implementable contract for Cabin MediaNowPlaying — automotive now-playing chrome: artwork, metadata, transport, and source. Not a Material media card clone. Overview: media.md. Layer 2 domain surface (features).
Purpose
Glanceable now-playing with large transport controls. Complex media
interactions (source picker, scrub/seek) are Restriction Engine–gated while
Moving. Metadata and progress use honest Signal values — no fake
telemetry.
Anatomy
┌──────────────────────────────────────────────┐
│ [artwork] Title │
│ Artist │
│ Source │
│ [⏮] [⏯] [⏭] │
│ ── progress (when known) ── │
└──────────────────────────────────────────────┘
| Region | Role |
|---|---|
| Artwork | Album / station art or stable placeholder |
| Title / artist | One-line primary + recessed secondary |
| Source | Active source label; tap opens source (complex) |
| Transport | Previous / play-pause / next |
| Progress | Display-only when position + duration are live |
Craft constraints
@sora craft locked for this slice:
- Cabin density — 76dp transport minima; quiet metadata hierarchy.
- Media accent as accent only — thin mark beside source; never body copy color and never a large mediaAccent wash on artwork / chrome.
- RE-quiet while Moving — title/artist/art stay glanceable; complex source soft-disables quietly; transport remains Allow.
- Honest empty / stale — unavailable metadata uses honest fallbacks; stale
appends
· stale; progress omitted unless both Signals are live — never invent telemetry. - Not a Material media card — flat cabin surface, outline artwork well, no elevated card fill.
Night warning / error / charging stay locked — unused as MediaNowPlaying
chrome decoration.
States
| State | Behavior |
|---|---|
| Playing / paused | Transport reflects isPlaying |
| No source | Honest empty copy; transport non-activatable |
| Artwork unavailable | Outline well + em dash — never chaotic blank / accent wash |
| Position / duration unavailable | Hide progress numbers — do not invent |
| Stale metadata | Last value + · stale |
| Fault | Fault presentation |
| Restricted (gate) | Complex actions Block/Substitute RE-quiet; transport per matrix |
| Day / Night | Theme Kit; mediaAccent mark only |
Sizes & type (from tokens)
| Token | Role |
|---|---|
cabin.component.mediaNowPlaying.artworkSize | Artwork square |
cabin.component.mediaNowPlaying.transportMinSize | 76dp transport targets |
cabin.component.mediaNowPlaying.gap / padding | Spacing |
cabin.component.mediaNowPlaying.cornerRadius | Modest radius |
cabin.color.semantic.mediaAccent | Thin accent mark only (not body text / washes) |
cabin.color.scheme.*.outline | Artwork well / transport outlines |
cabin.color.scheme.*.onSurface | Title / artist / source / progress body copy |
cabin.type.role.title / body / label | Metadata hierarchy |
Stub: tokens/cabin.tokens.json.
Night warning / error / charging stay locked — unused as MediaNowPlaying
chrome decoration.
Compliance gates
| Interaction | MediaNowPlaying use | Moving / Restricted / Unknown |
|---|---|---|
Glance | Title / artist / art display | Allow |
MediaTransport | Play/pause, next, previous | Allow |
MediaComplex | Open source, scrub/seek | Block |
Idling: MediaComplex → Substitute (visible, non-activatable). Parked → Allow.
Missing compliance host / local is fail-closed (GateDisposition.Block)
for activatable controls that require a gate (including transport when host is
absent — safe by default).
Safety class: Convenience.
Views API (Alpha)
class CabinMediaNowPlayingView @JvmOverloads constructor(
context: Context,
attrs: AttributeSet? = null,
) : ViewGroup(context, attrs) {
fun bind(state: CabinMediaNowPlayingState) { /* … */ }
fun setOnActionListener(listener: ((CabinMediaNowPlayingAction) -> Unit)?) { /* … */ }
fun setCompliance(host: CabinComplianceHost?) { /* … */ }
}
Package: dev.decoupled.cabin.views. Module: cabin-views / CabinViews.
Compose API (Experimental)
@Composable
fun CabinMediaNowPlaying(
state: CabinMediaNowPlayingState,
onAction: (CabinMediaNowPlayingAction) -> Unit,
modifier: Modifier = Modifier,
)
Package: dev.decoupled.cabin.compose. Same gates and Signal honesty as Views;
wrap with CabinTheme. Not for SystemUI Soong adoption.
Shared state / actions (parity)
data class CabinMediaNowPlayingState(
val title: Signal<String>,
val artist: Signal<String>,
val sourceLabel: Signal<String>,
val isPlaying: Boolean,
val artworkAvailable: Boolean,
val positionMs: Signal<Long>,
val durationMs: Signal<Long>,
val hasSource: Boolean = true,
)
sealed interface CabinMediaNowPlayingAction {
data object PlayPause : CabinMediaNowPlayingAction
data object Next : CabinMediaNowPlayingAction
data object Previous : CabinMediaNowPlayingAction
data object OpenSource : CabinMediaNowPlayingAction
/** Complex scrub — only when both position and duration are live. */
data class SeekTo(val positionMs: Long) : CabinMediaNowPlayingAction
}
Identical contracts on Compose and Views (duplicated types; same fields).
Progress UI renders only when both positionMs and durationMs are
Signal.Value with duration > 0. Otherwise omit numeric progress — never
fabricate elapsed / remaining.
Acceptance criteria
- Automotive MediaNowPlaying (not Material media card clone)
- Views-first Alpha + Compose Experimental parity
- Transport via
MediaTransport; source/seek viaMediaComplex(Block while Moving) - RE-quiet complex while Moving; fail-closed when host / local absent
- Honest media numbers + empty/stale — no fake telemetry
- Media accent as mark only (not body copy / not large washes)
- Artwork unavailable → stable outline placeholder
- 76dp cabin density; Theme Kit outline; locked night safety unused as chrome
- Unit tests for RE + states on both stacks
- No catalog reverse deps; marketing/docs sites frozen