MOMENT Studio
← Back

Aligning Lock Screen and Mini Player to the Same Playback State

2025.09.11Technical Log#playback#product-ui#ios-shell

Resolved an inconsistency where different playback paths each reported different track information, unifying the lock screen, mini player, and reels playback to reference a single source of truth.

A state existed where the currently playing track and the track information displayed across screens did not match. The lock screen remote control and the mini player pointed to different tracks, and in modes where two audio sources played simultaneously, it was unclear which path represented the authoritative playback state.

The root cause was a structural one: the audio session, track loading logic, and display layer each referenced independent state. This kind of inconsistency does not appear in feature specifications, but it directly undermines the reliability of the playback experience. The objective of this work was not to add functionality, but to establish a single source of truth for current playback state and consolidate the display paths — lock screen, mini player, and reels — to reference it consistently.

Track information retrieval across screen entry flows and in-app navigation was also aligned to the same standard. The core outcome is that playback state remains consistent regardless of which screen initiates or controls playback. Playback consistency is foundational to product reliability.