Integrace RichPear Home

ColorExtractor

ColorExtractor najde převládající barvu v obrázku a může ji použít pro nastavení barvy vybraného světla.

Doména: color_extractor
Kategorie: zpracování obrazu
Komunikace: lokální zpracování obrázku
Nastavení: průvodce v rozhraní
Výstup: barva obrázku pro světlo

Co integrace přidá

Integrace nepřidává klasické senzory pro každé světlo. Přidá akce, které vezmou obrázek z URL nebo lokální cesty, spočítají převládající RGB barvu a vrátí ji nebo ji rovnou předají světlu.

Akce color_extractor.get_color vrátí nalezenou barvu jako RGB hodnotu. Akce color_extractor.turn_on nastaví vybrané světlo na nalezenou barvu a může přijmout i běžné parametry zapnutí světla, kromě RGB barvy, kterou doplní integrace.

Obrázek lze zadat jako color_extract_url nebo color_extract_path. V jednom volání používejte vždy jen jeden z těchto zdrojů.

Kontrolní témata

Akce get_color
Akce turn_on
Povolené externí URL
Povolené lokální cesty k souborům

Příprava před přidáním

Připravte světlo, které umí měnit RGB barvu. Pokud světlo neumí barvu, akce pro nastavení barvy nebude dávat praktický smysl.

Rozmyslete, odkud se bude obrázek číst. U URL musí být adresa povolená mezi externími URL instalace. U lokálního souboru musí být cesta povolená mezi povolenými lokálními adresáři.

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.

Nepoužívejte neznámé nebo nestabilní zdroje obrázků. Výpadek URL, nepovolená cesta nebo soubor, který není obrázek, způsobí selhání akce.

Nastavení v RichPear Home

Otevřete http://rphome.local:8123, přejděte na Nastavení → Zařízení a služby → Přidat integraci, vyhledejte ColorExtractor a dokončete průvodce.

Po přidání zkontrolujte dostupné akce v části pro vývojářské nástroje nebo při tvorbě automatizace. Integrace je určená hlavně pro akce, ne pro ruční ovládání na dashboardu.

action: color_extractor.turn_on
target:
  entity_id: light.police_led
data:
  color_extract_url: "https://example.com/images/cover.jpg"
  brightness_pct: 70

Kontrola entit a funkcí

Nejdřív spusťte color_extractor.get_color na známém obrázku a ověřte, že vrací RGB hodnotu. Potom otestujte color_extractor.turn_on na jednom bezpečně vybraném světle.

U URL počítejte s desetisekundovým limitem stažení obrázku. U souborové cesty ověřte, že je cesta dostupná pro RichPear Home a soubor je skutečně obrázek.

Po nastavení

Ověřte akci get_color na známém obrázku.
Otestujte turn_on na jednom světle.
Zkontrolujte povolené URL nebo lokální adresáře.
Teprve potom akci vložte do automatizace.

Použití v automatizacích

Typické použití je sladění světla s obrázkem alba, filmovým plakátem, kamerovým snímkem nebo statickým obrázkem scény. Spouštěč volte podle změny zdroje obrázku, ne podle každé drobné změny stavu světla.

U akce turn_on můžete doplnit další parametry zapnutí světla, například jas nebo přechod. RGB barvu nenastavujte ručně, protože ji doplní výsledek extrakce.

Provoz a údržba

Po změně zdroje obrázku, adresy URL, lokální cesty nebo světla znovu spusťte ruční test obou akcí. U dynamických obrázků ověřte, že adresa vrací přímo obrázek, ne přihlašovací stránku nebo HTML odpověď.

Automatizace chraňte proti příliš častému spouštění. Časté stahování obrázků může zbytečně zatěžovat síť i cílovou službu.

Řešení problémů

Když akce selže u URL, ověřte povolení externí URL, dostupnost adresy, odpověď do deseti sekund a to, že adresa vrací obrázek. U lokální cesty ověřte povolený adresář a existenci souboru.

Když světlo nezmění barvu, otestujte nejdřív běžné zapnutí světla a podporu RGB. Další chyby hledejte v Nastavení → Systém → Logy podle domény color_extractor.