Integrace RichPear Home

Browser

Browser přidá akci pro otevření zadané URL ve výchozím prohlížeči zařízení, na kterém běží RichPear Home. Nepřidává vlastní entity ani běžný průvodce v nastavení.

Doména
browser
Typ
Akce bez entit
Komunikace
Lokální spuštění na hostiteli
Nastavení
configuration.yaml
Akce
browser.browse_url
01

Počítejte s tím, kde se URL otevře

Akce otevírá adresu na hostitelském zařízení RichPear Home. Není to zkratka pro otevření stránky v prohlížeči telefonu nebo počítače, ze kterého právě ovládáte dashboard.

Praktické použití dává smysl hlavně u instalací, kde má hostitelské zařízení dostupný výchozí prohlížeč. Na čistě serverové instalaci bez grafického prostředí nemusí být vidět žádné okno prohlížeče.

Před zapnutím

  1. Máte přístup ke konfiguraci RichPear Home.
  2. Znáte URL, kterou chcete z akce otevírat.
  3. Rozumíte tomu, že otevření probíhá na hostiteli RichPear Home.
02

Zapněte integraci v konfiguraci

Browser se zapíná ručním zápisem do configuration.yaml. Po uložení konfigurace restartujte RichPear Home, aby se doména browser načetla.

Základní zápis

browser:
03

Spusťte otevření adresy

Po restartu je dostupná akce browser.browse_url. Vyžaduje parametr url a hodnota musí být platná webová adresa včetně protokolu, například https:// nebo http://.

Akci můžete vyzkoušet v části Nástroje pro vývojáře → Akce. Pro lokální RichPear Home můžete jako test použít adresu http://rphome.local:8123 nebo náhradní adresu s IP.

Příklad akce

action: browser.browse_url
data:
  url: "http://rphome.local:8123"
04

Použití v automatizacích

Browser nepředává stav zpět do RichPear Home. Automatizace tedy nemá potvrzení, že se stránka opravdu zobrazila nebo že ji někdo viděl.

Používejte jej pro jednoduché lokální scénáře, například otevření místního panelu na zařízení, které slouží jako stálý domácí displej. Pro upozornění uživatelům použijte raději notifikace nebo dashboardové karty.

05

Provoz a údržba

Po úpravě konfigurace zkontrolujte, že se RichPear Home spustí bez chyby a že je v akcích dostupná doména browser. Pokud měníte URL v automatizacích, vždy ponechte kompletní adresu včetně protokolu.

Browser nevytváří zařízení, senzory ani přepínače. V seznamu entit proto po zapnutí nečekejte nové položky.

Řešení problémů

Když se stránka neotevře

Akce v seznamu chybí

Zkontrolujte zápis browser: v configuration.yaml, restart RichPear Home a logy podle domény browser.

URL je odmítnutá

Zadejte celou adresu včetně http:// nebo https://. Samotný název hostitele bez protokolu nestačí.

Nic se vizuálně nestane

Akce běží na hostitelském zařízení RichPear Home. Pokud tam není dostupný výchozí prohlížeč nebo grafická relace, nemusí se zobrazit žádné okno.

URL

Lokální adresa systému

RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa v dané síti neodpoví, použijte http://IP-ADRESA:8123.