Integrace RichPear Home
Music Assistant
Music Assistant propojí RichPear Home s Music Assistant Serverem a zpřístupní přehrávače, fronty, oblíbené skladby a mediální akce pro scény i automatizace.
- Doména
music_assistant- Kategorie
- Přehrávač médií
- Komunikace
- local-push
- Kvalita
- bronze
Příprava
Nejdřív připravte vše, co integrace Music Assistant potřebuje mimo RichPear Home: běžící Music Assistant Server, síťovou dostupnost serveru a hotové přihlášení hudebních služeb přímo v Music Assistant. Bez této přípravy se průvodce může dokončit jen částečně nebo se entity budou tvářit jako nedostupné.
Uživatelé obvykle otevírají systém na http://rphome.local:8123. Pokud tato adresa nefunguje, použijte http://IP-ADRESA:8123. Nastavení provádějte z účtu správce, aby bylo možné vytvářet zařízení, oblasti a případné pomocné entity.
Nastavení
V RichPear Home otevřete Nastavení -> Zařízení a služby, zvolte Přidat integraci a vyhledejte Music Assistant. Pokud je zařízení nebo služba nalezená automaticky, dokončete nabídnuté nastavení z objevené karty.
Průvodce obvykle vyžaduje přihlašovací údaje, API klíč, adresu zařízení nebo výběr konkrétního účtu podle typu integrace. Pokud se server nenajde automaticky, použijte ruční adresu serveru a po připojení zkontrolujte seznam přehrávačů. Po dokončení pojmenujte zařízení podle místnosti a zkontrolujte, že vytvořené entity odpovídají skutečnému zařízení nebo službě.
Přehrávače
Každý přehrávač z Music Assistant se v RichPear Home zobrazí jako mediální entita. Ovládání hlasitosti, přehrávání a fronty závisí na schopnostech konkrétního playeru.
Přehrávače pojmenujte podle místností. Pokud stejný reproduktor existuje i přes jinou integraci, nastavte názvy tak, aby uživatel neovládal špatnou entitu.
Oblíbená skladba
Integrace může nabídnout tlačítko pro označení aktuální skladby jako oblíbené. Hodí se pro jednoduché scény a dashboardy bez otevírání celé hudební aplikace.
Funkci testujte u každého poskytovatele hudby zvlášť, protože možnosti knihovny a oblíbených položek se mezi službami liší.
Akce přehrávání
Pro automatizace jsou důležité akce pro přehrání média, oznámení, přesun fronty, vyhledávání knihovny a čtení aktuální fronty.
U oznámení nastavte hlasitost a návrat k původnímu přehrávání opatrně. Uživatel nemá přijít o frontu jen proto, že se přehrálo krátké oznámení.
Podporovaná zařízení
Music Assistant podporuje více typů přehrávačů, ale konkrétní funkce se liší. Multiroom, synchronizace a přenos fronty ověřujte na reálné skupině zařízení.
Pokud přehrávač reaguje pomalu, nejdřív zkontrolujte Music Assistant Server a jeho připojení ke službám, teprve potom automatizace v RichPear Home.
Známá omezení
Některé akce vyžadují správně načtenou knihovnu a dostupného poskytovatele hudby. Výpadek účtu nebo služby se projeví jako prázdné výsledky nebo neúspěšné přehrání.
U lokálních oznámení počítejte se zpožděním mezi serverem, přehrávačem a sítí. Kritická oznámení proto nedávejte jen do hudebního systému.
Kontrola po nasazení
Po prvním dni provozu projděte historii entit integrace Music Assistant. Sledujte, jestli se hodnoty aktualizují podle očekávané komunikace, zda příkazy nemají zpoždění a jestli se v logu neopakují chyby přihlášení, odmítnuté požadavky nebo výpadky dostupnosti.
U zařízení s přímým dopadem na provoz domácnosti nechte správcům jasný postup pro ruční ovládání, vypnutí automatizace a bezpečný návrat do původního stavu. Zapište také místo, kde se spravuje token, heslo, API klíč, adresa zařízení, topic struktura nebo konfigurační soubor.