291 lines
10 KiB
Python
291 lines
10 KiB
Python
"""Central orchestration placeholder for the Box runtime."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from pathlib import Path
|
|
from typing import Any
|
|
|
|
from core.state import BoxState, RuntimeState
|
|
from player.base_player import BasePlayer
|
|
import hashlib
|
|
|
|
|
|
class BoxController:
|
|
def __init__(
|
|
self,
|
|
state: RuntimeState,
|
|
player: BasePlayer,
|
|
config: dict[str, Any],
|
|
config_path: str,
|
|
) -> None:
|
|
self._state = state
|
|
self._player = player
|
|
self._config = config
|
|
self._config_path = Path(config_path)
|
|
|
|
@property
|
|
def state(self) -> RuntimeState:
|
|
return self._state
|
|
|
|
def start(self) -> None:
|
|
"""Start the main loop (not implemented in Phase 1a)."""
|
|
return None
|
|
|
|
def handle_nfc_on(self, uid: str) -> None:
|
|
if self._state.state == BoxState.ERROR:
|
|
return None
|
|
if self._state.active_uid == uid and self._state.state != BoxState.IDLE:
|
|
return None
|
|
if self._config.get("server_reachable") is False:
|
|
print("error: server not reachable")
|
|
self._trigger_error("server_unreachable")
|
|
return None
|
|
tag = self._resolve_tag(uid)
|
|
if tag is None:
|
|
print(f"error: uid '{uid}' not found in config tags")
|
|
self._trigger_error("uid_unmapped")
|
|
return None
|
|
self._state.last_error = None
|
|
|
|
playlist = self._build_playlist(tag)
|
|
if not playlist:
|
|
path_value = tag.get("path", "-")
|
|
resolved = self._resolve_path(path_value)
|
|
print(
|
|
f"error: no playable files found for uid '{uid}' at path '{resolved}'"
|
|
)
|
|
self._trigger_error("no_playable_files")
|
|
return None
|
|
|
|
if uid in self._state._resume:
|
|
file_index, position = self._state._resume[uid]
|
|
else:
|
|
file_index, position = 0, 0
|
|
|
|
if file_index < 0 or file_index >= len(playlist):
|
|
print(
|
|
f"error: stored progress points outside playlist for uid '{uid}'"
|
|
)
|
|
self._trigger_error("invalid_resume")
|
|
return None
|
|
|
|
if self._state.active_uid and self._state.active_uid != uid:
|
|
self._store_progress(self._state.active_uid)
|
|
self.stop()
|
|
|
|
media_ref = playlist[file_index]
|
|
duration = self._duration_for(media_ref)
|
|
self._state.active_uid = uid
|
|
self._state.playback_type = tag.get("type")
|
|
self._state.playback_path = tag.get("path")
|
|
self._state.current_file = Path(media_ref).name
|
|
self._state.current_duration = duration
|
|
self._state.file_index = file_index
|
|
self._state.position = position
|
|
self._state._playlist = playlist
|
|
|
|
self._player.play(media_ref)
|
|
self._state.current_media = media_ref
|
|
self._state.state = BoxState.PLAYING
|
|
|
|
def pause(self) -> None:
|
|
self._player.pause()
|
|
if self._state.state == BoxState.PLAYING:
|
|
self._state.state = BoxState.PAUSED
|
|
|
|
def stop(self) -> None:
|
|
self._player.stop()
|
|
self._clear_playback_state()
|
|
|
|
def handle_nfc_off(self, uid: str) -> None:
|
|
if self._state.state == BoxState.ERROR:
|
|
return None
|
|
if self._state.active_uid != uid:
|
|
return None
|
|
self._store_progress(uid)
|
|
self.stop()
|
|
|
|
def _resolve_tag(self, uid: str) -> dict[str, Any] | None:
|
|
tags = self._config.get("tags", {})
|
|
if not isinstance(tags, dict):
|
|
return None
|
|
tag = tags.get(uid)
|
|
if not isinstance(tag, dict):
|
|
return None
|
|
if "type" not in tag or "path" not in tag:
|
|
return None
|
|
return tag
|
|
|
|
def tick(self, seconds: int) -> None:
|
|
if self._state.state == BoxState.ERROR:
|
|
return None
|
|
if self._state.state != BoxState.PLAYING:
|
|
return None
|
|
if self._state.position is None or self._state.file_index is None:
|
|
return None
|
|
if not self._state._playlist:
|
|
return None
|
|
if seconds <= 0:
|
|
return None
|
|
|
|
remaining = seconds
|
|
file_index = self._state.file_index
|
|
position = self._state.position
|
|
|
|
while remaining > 0 and file_index < len(self._state._playlist):
|
|
media_ref = self._state._playlist[file_index]
|
|
duration = self._duration_for(media_ref)
|
|
if duration <= 0:
|
|
break
|
|
time_left = duration - position
|
|
if remaining < time_left:
|
|
position += remaining
|
|
remaining = 0
|
|
else:
|
|
remaining -= time_left
|
|
file_index += 1
|
|
position = 0
|
|
|
|
if file_index >= len(self._state._playlist):
|
|
last_index = len(self._state._playlist) - 1
|
|
last_media = self._state._playlist[last_index]
|
|
last_duration = self._duration_for(last_media)
|
|
self._state.file_index = last_index
|
|
self._state.position = last_duration
|
|
if self._state.active_uid:
|
|
self._store_progress(self._state.active_uid)
|
|
self.stop()
|
|
return None
|
|
|
|
self._state.file_index = file_index
|
|
self._state.position = position
|
|
media_ref = self._state._playlist[file_index]
|
|
self._state.current_media = media_ref
|
|
self._state.current_file = Path(media_ref).name
|
|
self._state.current_duration = self._duration_for(media_ref)
|
|
|
|
def _build_playlist(self, tag: dict[str, Any]) -> list[str]:
|
|
path_value = tag.get("path")
|
|
if not isinstance(path_value, str):
|
|
return []
|
|
path = self._resolve_path(path_value)
|
|
if not path.exists() or not path.is_dir():
|
|
return []
|
|
return [str(p) for p in self._collect_files(path)]
|
|
|
|
def _collect_files(self, root: Path) -> list[Path]:
|
|
entries = list(root.iterdir())
|
|
dirs = sorted([p for p in entries if p.is_dir()], key=lambda p: p.name)
|
|
files = sorted([p for p in entries if p.is_file()], key=lambda p: p.name)
|
|
result: list[Path] = []
|
|
for directory in dirs:
|
|
result.extend(self._collect_files(directory))
|
|
result.extend(files)
|
|
return result
|
|
|
|
def _resolve_path(self, path_value: str) -> Path:
|
|
path = Path(path_value)
|
|
if not path.is_absolute():
|
|
return (self._config_path.parent / path).resolve()
|
|
return path
|
|
|
|
def _store_progress(self, uid: str) -> None:
|
|
file_index = self._state.file_index if self._state.file_index is not None else 0
|
|
position = self._state.position if self._state.position is not None else 0
|
|
self._state._resume[uid] = (file_index, position)
|
|
|
|
def _duration_for(self, media_ref: str) -> int:
|
|
name = Path(media_ref).name
|
|
durations = {"01.mp3": 180, "02.mp3": 200, "03.mp3": 220}
|
|
if name in durations:
|
|
return durations[name]
|
|
if not name.lower().endswith(".mp3"):
|
|
return 0
|
|
digest = hashlib.md5(name.encode("utf-8")).hexdigest()
|
|
seed = int(digest[:8], 16)
|
|
return 120 + (seed % 241)
|
|
|
|
def play_pause(self) -> None:
|
|
if self._state.state in {BoxState.IDLE, BoxState.ERROR}:
|
|
return None
|
|
if self._state.state == BoxState.PLAYING:
|
|
self._state.state = BoxState.PAUSED
|
|
return None
|
|
if self._state.state == BoxState.PAUSED:
|
|
self._state.state = BoxState.PLAYING
|
|
return None
|
|
|
|
def next_track(self) -> None:
|
|
if self._state.state in {BoxState.IDLE, BoxState.ERROR}:
|
|
return None
|
|
if not self._state._playlist:
|
|
return None
|
|
if self._state.file_index is None:
|
|
return None
|
|
next_index = self._state.file_index + 1
|
|
if next_index >= len(self._state._playlist):
|
|
if self._state.active_uid:
|
|
self._store_progress(self._state.active_uid)
|
|
self.stop()
|
|
return None
|
|
self._jump_to_index(next_index, 0)
|
|
self._state.state = BoxState.PLAYING
|
|
|
|
def prev_track(self, threshold_seconds: int = 3) -> None:
|
|
if self._state.state in {BoxState.IDLE, BoxState.ERROR}:
|
|
return None
|
|
if self._state.file_index is None or self._state.position is None:
|
|
return None
|
|
if self._state.position > threshold_seconds:
|
|
self._state.position = 0
|
|
return None
|
|
prev_index = max(self._state.file_index - 1, 0)
|
|
self._jump_to_index(prev_index, 0)
|
|
self._state.state = BoxState.PLAYING
|
|
|
|
def volume_up(self, step: int = 5) -> None:
|
|
if self._state.state == BoxState.ERROR:
|
|
return None
|
|
self._state.volume = min(self._state.volume + step, self._state.max_volume)
|
|
|
|
def volume_down(self, step: int = 5) -> None:
|
|
if self._state.state == BoxState.ERROR:
|
|
return None
|
|
self._state.volume = max(self._state.volume - step, 0)
|
|
|
|
def _jump_to_index(self, file_index: int, position: int) -> None:
|
|
if not self._state._playlist:
|
|
return None
|
|
if file_index < 0 or file_index >= len(self._state._playlist):
|
|
return None
|
|
media_ref = self._state._playlist[file_index]
|
|
self._state.file_index = file_index
|
|
self._state.position = position
|
|
self._state.current_media = media_ref
|
|
self._state.current_file = Path(media_ref).name
|
|
self._state.current_duration = self._duration_for(media_ref)
|
|
self._player.play(media_ref)
|
|
|
|
def _trigger_error(self, code: str) -> None:
|
|
if self._state.state in {BoxState.PLAYING, BoxState.PAUSED}:
|
|
self._player.pause()
|
|
self._state.state = BoxState.ERROR
|
|
self._state.last_error = code
|
|
self._player.play(f"system:error:{code}")
|
|
self._clear_playback_state()
|
|
|
|
def _clear_playback_state(self) -> None:
|
|
self._state.state = BoxState.IDLE
|
|
self._state.active_uid = None
|
|
self._state.playback_type = None
|
|
self._state.playback_path = None
|
|
self._state.current_media = None
|
|
self._state.current_file = None
|
|
self._state.current_duration = None
|
|
self._state.file_index = None
|
|
self._state.position = None
|
|
self._state._playlist = []
|
|
|
|
def trigger_error(self, code: str) -> None:
|
|
self._trigger_error(code)
|