MOMENT Studio
← Back

Anchoring the Mini Player to a Single Source of Truth

2025.10.18Technical Log#product-ui#playback#sleep

Refactored playback state architecture so the mini player always reflects the actual audio, video, and mount state. Unified sleep routine flow into a single state source.

The mini player displayed persistently at the bottom of the screen is the most frequently referenced indicator of playback state. When this surface diverges from the actual audio, video, or mount state, the overall reliability of the app degrades. This work addressed that divergence directly — volume control logic was cleaned up, unused code removed, and the mini player was anchored to a single, authoritative playback state.

The core change was to the playback state architecture itself. Audio, video, effect bindings, and Now Playing information had each maintained separate state; these were consolidated into a single source. Session restoration was also updated to ensure playback position and mode are recovered without interruption.

The sleep routine followed the same structural direction. Content selection, alarm configuration, and session persistence — previously handled as independent steps — were connected into a unified flow. The timeline sheet layout was adjusted to respond consistently to content. The result is a guaranteed consistent playback state regardless of which screen is used for control.