Skip to main content

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) ── │
└──────────────────────────────────────────────┘
RegionRole
ArtworkAlbum / station art or stable placeholder
Title / artistOne-line primary + recessed secondary
SourceActive source label; tap opens source (complex)
TransportPrevious / play-pause / next
ProgressDisplay-only when position + duration are live

Craft constraints​

@sora craft locked for this slice:

  1. Cabin density — 76dp transport minima; quiet metadata hierarchy.
  2. Media accent as accent only — thin mark beside source; never body copy color and never a large mediaAccent wash on artwork / chrome.
  3. RE-quiet while Moving — title/artist/art stay glanceable; complex source soft-disables quietly; transport remains Allow.
  4. Honest empty / stale — unavailable metadata uses honest fallbacks; stale appends · stale; progress omitted unless both Signals are live — never invent telemetry.
  5. 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​

StateBehavior
Playing / pausedTransport reflects isPlaying
No sourceHonest empty copy; transport non-activatable
Artwork unavailableOutline well + em dash — never chaotic blank / accent wash
Position / duration unavailableHide progress numbers — do not invent
Stale metadataLast value + · stale
FaultFault presentation
Restricted (gate)Complex actions Block/Substitute RE-quiet; transport per matrix
Day / NightTheme Kit; mediaAccent mark only

Sizes & type (from tokens)​

TokenRole
cabin.component.mediaNowPlaying.artworkSizeArtwork square
cabin.component.mediaNowPlaying.transportMinSize76dp transport targets
cabin.component.mediaNowPlaying.gap / paddingSpacing
cabin.component.mediaNowPlaying.cornerRadiusModest radius
cabin.color.semantic.mediaAccentThin accent mark only (not body text / washes)
cabin.color.scheme.*.outlineArtwork well / transport outlines
cabin.color.scheme.*.onSurfaceTitle / artist / source / progress body copy
cabin.type.role.title / body / labelMetadata hierarchy

Stub: tokens/cabin.tokens.json.

Night warning / error / charging stay locked — unused as MediaNowPlaying chrome decoration.

Compliance gates​

InteractionMediaNowPlaying useMoving / Restricted / Unknown
GlanceTitle / artist / art displayAllow
MediaTransportPlay/pause, next, previousAllow
MediaComplexOpen source, scrub/seekBlock

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 via MediaComplex (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