Amazon Alexa Flash Briefing

Požadavky před nastavením

Připravte si veřejnou HTTPS adresu RichPear Home, vlastní Amazon Developer účet a heslo, které bude chránit briefing feed. Lokální adresa http://rphome.local:8123 slouží pro správu doma, ale Alexa k ní z internetu nepřistoupí.

Amazon očekává feed dostupný přes standardní HTTPS port 443. Pokud RichPear Home běží doma na portu 8123, nastavte na routeru nebo reverzní proxy přesměrování z veřejného portu 443 na interní službu.

Konfigurace feedu v RichPear Home

Feed se nastavuje ručně v configuration.yaml pod sekcí alexa.flash_briefings. Povinné je společné password, název briefing feedu a u každé položky title. Text je podporovaný přes text, audio přes audio a odkaz pro zobrazení přes display_url.

alexa:
  flash_briefings:
    password: "DLOUHE_NAHODNE_HESLO"
    ranni_prehled:
      - title: "Ranní přehled domácnosti"
        text: >
          Teplota v obýváku je {{ states('sensor.obyvak_teplota') }} stupňů.
          Dveře jsou {{ states('binary_sensor.vchodove_dvere') }}.
        display_url: "https://VASE-DOMENA/"

Klíč ranni_prehled je zároveň identifikátor feedu, který později vložíte do Amazon Developer Console. Můžete přidat i více položek pod stejný feed; Amazon běžně zpracovává nejvýše pět aktuálních položek.

Sestavení veřejné URL

URL feedu má tento tvar:

https://VASE-DOMENA/api/alexa/flash_briefings/BRIEFING_ID?password=HESLO

Pro ukázkovou konfiguraci výše bude BRIEFING_ID hodnota ranni_prehled. Heslo v URL musí přesně odpovídat hodnotě password z konfigurace.

Než budete pokračovat do Amazonu, otevřete URL z mobilních dat nebo jiné sítě mimo domácnost. Odpověď má být JSON seznam položek. Pokud dostanete chybu 401, nesedí heslo; pokud 404, nesedí identifikátor briefing feedu.

Nastavení v Amazon Developer Console

Přihlaste se do Amazon Developer Console vlastním účtem a vytvořte nový Alexa skill. Jako model vyberte Flash Briefing, vyplňte název skillu a pokračujte do nastavení feedu.

Přidejte nový feed, nastavte krátký úvod, název, žánr a typ obsahu. Pro textový přehled zvolte textový obsah a do pole pro feed vložte veřejnou URL z předchozího kroku. Nepoužívejte nestandardní port v URL.

Amazon vyžaduje správný formát feedu. Textové položky mají být prostý text bez HTML značek a mají být napsané tak, aby dávaly smysl při hlasitém čtení. Audio položky musí odkazovat na dostupný MP3 soubor přes HTTPS.

Zapnutí v aplikaci Alexa

Po uložení skillu otevřete aplikaci Alexa nebo webové nastavení Alexy, najděte vlastní skill mezi svými skills a povolte ho. V nastavení Flash Briefingu potom upravte pořadí zdrojů podle toho, kdy má být váš domácí přehled přečten.

Ověřte běžným dotazem na zprávy nebo briefing. Pokud Alexa přečte starší obsah, chvíli počkejte; Amazon feed průběžně ukládá do mezipaměti a změna se nemusí projevit okamžitě.

Provoz a bezpečnost

Heslo ve feed URL považujte za citlivý údaj. Když ho pošlete někomu mimo správce domácnosti nebo se objeví v logu či sdíleném záznamu obrazovky, změňte ho v konfiguraci i v Amazon Developer Console.

Text držte krátký, aktuální a bez citlivých detailů. Flash Briefing se hodí pro stav domácnosti, počasí, energii nebo připravený denní souhrn; nehodí se pro jednorázové výstrahy, které mají dorazit okamžitě.

Řešení problémů

Když Amazon feed odmítá, nejdřív zkontrolujte veřejnou dostupnost přes HTTPS na portu 443, platnost certifikátu, správný identifikátor feedu a heslo v URL. Adresa http://rphome.local:8123 je užitečná doma, ale do Amazon Developer Console nepatří.

Když se feed načte, ale Alexa nic smysluplného nepřečte, ověřte šablony v konfiguraci. Výsledkem má být běžný text bez HTML, XML nebo speciálního značkování. U audia ověřte veřejnou HTTPS dostupnost MP3 souboru.