# Yandex Smart Home — plugin ViON

Fonte: https://vionvision.tech/it/plugins/smart-home/yandex

Collega ViON alla casa intelligente Yandex e agli speaker Alice: sensori e relè dell’hub diventano sensori di ViON, gli scenari partono dalle automazioni, gli speaker leggono le notifiche e le telecamere della casa intelligente compaiono in ViON.

- Pacchetto: @vionvision/camera-ui-yandex
- Gruppo: Casa intelligente
- Versione: 0.2.4
- Richiede: ViON 2.3.4 o successiva
- Licenza: MIT
- https://npm.vionvision.tech/-/web/detail/@vionvision/camera-ui-yandex
- https://github.com/atva0408-create/Vion-plagin/tree/main/camera-ui-yandex#readme

## Descrizione tecnica

Collega ViON alla casa intelligente Yandex e agli smart speaker Alice. Sensori e relè dell’hub di uno speaker Yandex diventano sensori di ViON, gli scenari della casa intelligente partono dalle automazioni di ViON, gli speaker leggono ad alta voce le notifiche e le telecamere della casa intelligente compaiono in ViON.

## Cosa fa

- **Sensori**: movimento, porte e finestre, perdite, fumo, gas, vibrazioni, pulsanti, temperatura, umidità, luminosità e CO₂ della casa intelligente diventano sensori di ViON. Possono avviare la registrazione e il rilevamento sulle telecamere e attivare automazioni
- **Comandi**: relè, prese, interruttori e luci della casa intelligente diventano interruttori e luci di ViON, così le automazioni di ViON li accendono e li spengono
- **Condizionatori, TV, telecomandi IR**: oltre ad accendere e spegnere, la modalità, la temperatura e la ventola di un condizionatore, il volume, il canale, l’ingresso e il muto di una TV e i pulsanti appresi di un telecomando IR si trovano nelle impostazioni del rispettivo interruttore (pagina Devices di ViON, More). Un telecomando con soli pulsanti diventa un interruttore a sé
- **Scenari**: ogni scenario della casa intelligente viene proposto come interruttore. Attivarlo avvia lo scenario, dall’interfaccia o da un’automazione
- **Voce sugli speaker**: con l’accesso come app Yandex ogni speaker diventa un destinatario di notifiche. Uno speaker che attivate legge ad alta voce le notifiche: «Movimento. Telecamera del cortile»
- **Assistente**: l’assistente di ViON può pronunciare una frase su uno speaker, dare un comando ad Alice, avviare uno scenario e leggere lo stato dei dispositivi
- **Telecamere**: le telecamere della casa intelligente vengono proposte in Cameras e mostrano la visione in diretta

## Due modi di accesso

Il plugin può usare uno qualsiasi dei due accessi, oppure entrambi insieme.

**API ufficiale della casa intelligente.** L’API che Yandex offre ai proprietari di una casa intelligente. Legge dispositivi e scenari e invia comandi. Non ha push: il plugin la interroga a intervalli (10 secondi per impostazione predefinita). Serve un’app in Yandex ID con i permessi iot:view e iot:control:

1. Create l’app sul sito di Yandex ID (oauth.yandex.ru): piattaforma «Servizi web», permessi «Visualizzare l’elenco dei dispositivi della casa intelligente» e «Controllare i dispositivi della casa intelligente»
2. Inserite il suo **App ID** e il suo **App secret** nelle impostazioni del plugin e fate clic su **Sign in with Yandex ID**
3. Aprite ya.ru/device su un telefono o un computer, inserite il codice mostrato dalla finestra, poi fate clic sul pulsante nella finestra

Senza secret, la finestra mostra invece una pagina di Yandex ID: consentite lì l’accesso, copiate il token e incollatelo nella finestra. Yandex ID mostra lì il token solo se l’app ha il Redirect URI oauth.yandex.ru/verification_code (preceduto da https): inseritelo prima nelle impostazioni dell’app su oauth.yandex.ru.

**App Yandex (link o QR code).** Il plugin accede come fanno le app Yandex. Questo accesso è necessario per la voce sugli speaker e segnala subito le modifiche dei sensori:

1. Fate clic su **Sign in with a link or QR code**. Si apre una finestra con un link e un QR code
2. Confermate l’accesso in uno dei due modi:
   - **Nel browser.** Fate clic sul pulsante a destra del link: Yandex si apre in una nuova scheda e chiede di confermare l’accesso. Se questo browser non ha effettuato l’accesso a Yandex, prima vi chiede di accedere
   - **Sul telefono.** Scansionate il codice con l’app Yandex su un telefono collegato a Yandex e confermate l’accesso nell’app. Comodo quando il browser con ViON non ha effettuato l’accesso a Yandex
3. Tornate alla finestra e fate clic su **Save**. La finestra mostra l’account a cui il plugin ha effettuato l’accesso. Se fate clic prima che arrivi la conferma, aspetta fino a 20 secondi e poi vi chiede di fare clic di nuovo

Confermate con l’account Yandex a cui appartiene la vostra casa intelligente: il plugin vede i dispositivi e gli speaker dell’account che ha confermato. Yandex chiede questa conferma ogni volta; senza di essa l’accesso a un account non va a buon fine.

Se avete già un x_token dell’account, potete incollarlo invece nel campo **x_token**.

## Impostazioni

- **Read devices through**: Automatic usa l’API ufficiale quando è collegata, altrimenti l’app Yandex
- **Reading interval**: ogni quanto viene interrogata l’API ufficiale
- **Offer scenarios**: scenari proposti come interruttori
- **Speech on the stations**: Local va direttamente allo speaker nella rete di casa e legge testi di qualsiasi lunghezza. Cloud passa da uno scenario dell’account, funziona ovunque si trovi lo speaker e legge fino a 100 caratteri. Automatic prova prima Local
- **Station addresses**: solo se uno speaker non viene trovato nella rete, nella forma `Kitchen = 192.168.1.20`
- **Say on a station**: prova la voce con una frase a vostra scelta
- **Sign out**: dimentica entrambi gli accessi e quali speaker parlano. Sensori e telecamere aggiunti restano

## Aggiungere sensori, telecamere e speaker

1. Accedete come descritto sopra
2. Aprite **Sensors** in ViON: i dispositivi della casa intelligente vengono proposti per l’aggiunta con le loro stanze
3. Aprite **Cameras**: le telecamere della casa intelligente sono in **Discovered**
4. Nelle impostazioni delle notifiche di ViON, sotto Devices, gli speaker compaiono quando il plugin ha effettuato l’accesso come app Yandex. Nessuno parla finché non lo attivate: attivate Active per quelli che devono parlare. Solo un amministratore di ViON può farlo

## Da sapere

- Vengono letti solo i dispositivi delle vostre case; quelle condivise con voi no
- Quando Yandex non accetta più un accesso (password cambiata, accesso revocato), il plugin lo segnala una volta nel suo registro, dimentica quell’accesso e ne attende uno nuovo. L’altro accesso, se c’è, continua a funzionare
- Un dispositivo che fornisce più sensori dà a ciascuno il proprio nome e ciò che mostra, in inglese: "Hall sensor: Motion". Rinominateli in ViON come preferite
- La voce e l’accesso tramite QR non sono un’interfaccia ufficiale di Yandex. Un cambiamento da parte di Yandex può richiedere un aggiornamento del plugin. Per la voce via cloud il plugin mantiene uno scenario per speaker chiamato "ViON" con l’id dello speaker; non eliminatelo
- Il microfono di uno speaker non è disponibile per altri sistemi: Alice ascolta solo Yandex. Per parlare con ViON a voce, usate la skill di ViON per Alice nel cloud di ViON
- Il video di una telecamera della casa intelligente arriva dal cloud di Yandex