49 lines
1.4 KiB
Python
49 lines
1.4 KiB
Python
"""Stable MQTT contracts shared by the Controller adapters."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass
|
|
|
|
|
|
SLOT_IDS = tuple(range(1, 11))
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class Topics:
|
|
"""MQTT topic names.
|
|
|
|
Defaults preserve the established Player, Home Assistant, and Companion
|
|
integrations. Player ``state`` is fixed by the Player Node contract.
|
|
"""
|
|
|
|
player_command: str = "youtube/player/cmd"
|
|
player_status: str = "youtube/player/status"
|
|
player_state: str = "youtube/player/state"
|
|
player_telemetry: str = "youtube/player/telemetry"
|
|
controller_command: str = "youtube/controller/cmd"
|
|
ingest_progress: str = "youtube/ingest/progress"
|
|
playback_base: str = "youtube/media/playback"
|
|
router_mode_set: str = "audio/player/mode/set"
|
|
router_mode_state: str = "audio/player/mode/state"
|
|
controller_result: str | None = "youtube/controller/v2/events"
|
|
|
|
def slot_base(self, slot: int) -> str:
|
|
if slot not in SLOT_IDS:
|
|
raise ValueError(f"slot must be in 1..10, got {slot!r}")
|
|
return f"{self.playback_base}/{slot}"
|
|
|
|
|
|
PLAYER_COMMAND_QOS = 1
|
|
PLAYER_COMMAND_RETAIN = False
|
|
PLAYER_STATUS_QOS = 1
|
|
PLAYER_STATE_QOS = 0
|
|
PLAYER_TELEMETRY_QOS = 0
|
|
|
|
# Existing Controller-owned HA/Companion state was retained at QoS 0.
|
|
LEGACY_STATE_QOS = 0
|
|
LEGACY_STATE_RETAIN = True
|
|
|
|
# Router commands are ephemeral commands just like Player commands.
|
|
ROUTER_COMMAND_QOS = 1
|
|
ROUTER_COMMAND_RETAIN = False
|