MOMENT Studio
← Back

Unified Playback State Across Lock Screen and Mini Player

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

Aligned the mini player and lock screen remote control to a single playback state source, eliminating display inconsistencies between UI surfaces and the audio session.

As the number of playback-facing surfaces grows, the risk of state divergence increases. When the mini player display, the lock screen remote control, and the actual audio output derive their state independently, inconsistencies arise — tracks appearing stopped while audio continues, or UI state updating while the audio session remains unchanged.

The work addressed two areas. The first was the user-facing surface layer: the mini player and lock screen remote control were aligned to reflect the same playback state consistently. The second was the underlying audio session responsible for loading and unloading tracks. By ensuring that both UI representation and actual playback state derive from a single source, additional surfaces can be introduced without introducing state divergence.

When multiple surfaces share the same underlying state, it is essential that none of them resolve that state independently. Whether the input originates from the lock screen or the mini player, routing all control actions through a single playback owner guarantees consistent results regardless of entry point. This structural alignment is a prerequisite for reliably extending per-mode playback behavior.