# Yandex Smart Home — plugins do ViON

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

Liga o ViON à Casa Inteligente Yandex e às estações Alice: sensores e relés do hub viram sensores do ViON, cenários rodam a partir de automações, as estações falam as notificações e as câmeras da Casa Inteligente aparecem no ViON.

- Pacote: @vionvision/camera-ui-yandex
- Grupo: Casa inteligente
- Versão: 0.2.4
- Requer: ViON 2.3.4 ou mais recente
- Licença: MIT
- https://npm.vionvision.tech/-/web/detail/@vionvision/camera-ui-yandex
- https://github.com/atva0408-create/Vion-plagin/tree/main/camera-ui-yandex#readme

## Descrição técnica

Conecta o ViON à Casa Inteligente Yandex e às estações Alice. Sensores e relés do hub de uma estação Yandex viram sensores do ViON, cenários da Casa Inteligente rodam a partir de automações do ViON, as estações leem notificações em voz alta e as câmeras da Casa Inteligente aparecem no ViON.

## O que faz

- **Sensores**: movimento, portas e janelas, vazamentos, fumaça, gás, vibração, botões, temperatura, umidade, luminosidade e CO₂ da Casa Inteligente viram sensores do ViON. Eles podem iniciar a gravação e a detecção nas câmeras e disparar automações
- **Controle**: relés, tomadas, interruptores e luzes da Casa Inteligente viram interruptores e luzes do ViON, para que as automações do ViON os liguem e desliguem
- **Ar-condicionado, TVs, controles IR**: além de ligar e desligar, o modo, a temperatura e o ventilador de um ar-condicionado, o volume, o canal, a entrada e o mudo de uma TV e os botões aprendidos de um controle IR ficam nas configurações do respectivo interruptor (página Devices do ViON, More). Um controle só de botões vira um interruptor próprio
- **Cenários**: cada cenário da Casa Inteligente é oferecido como interruptor. Ligá-lo executa o cenário, pela interface ou por uma automação
- **Fala nas estações**: com o login como o app Yandex, cada estação é um destino de notificação. Uma estação que você ativar lê as notificações em voz alta: "Movimento. Câmera do quintal"
- **Assistente**: o assistente do ViON pode falar uma frase em uma estação, dar um comando à Alice, executar um cenário e ler o estado dos dispositivos
- **Câmeras**: câmeras da Casa Inteligente são oferecidas em Cameras e mostram a transmissão ao vivo

## Duas formas de entrar

O plugin pode usar qualquer um dos logins, ou os dois juntos.

**API oficial da Casa Inteligente.** A API que a Yandex oferece aos donos de uma Casa Inteligente. Ela lê os dispositivos e cenários e envia comandos. Não tem push: o plugin a consulta em intervalos (10 segundos por padrão). Você precisa de um app no Yandex ID com as permissões iot:view e iot:control:

1. Crie o app no site do Yandex ID (oauth.yandex.ru): plataforma "Serviços web", permissões "Ver a lista de dispositivos da casa inteligente" e "Controlar os dispositivos da casa inteligente"
2. Digite o **App ID** e o **App secret** nas configurações do plugin e clique em **Sign in with Yandex ID**
3. Abra ya.ru/device em um telefone ou computador, digite o código que a janela mostra e clique no botão da janela

Sem um secret, a janela mostra uma página do Yandex ID: permita o acesso lá, copie o token e cole na janela. O Yandex ID só mostra o token ali quando o app tem o Redirect URI oauth.yandex.ru/verification_code (com https na frente): informe-o antes nas configurações do app em oauth.yandex.ru.

**App Yandex (link ou QR code).** O plugin entra do jeito que os apps da Yandex fazem. Esse login é necessário para a fala nas estações e informa as mudanças dos sensores na hora:

1. Clique em **Sign in with a link or QR code**. Abre uma janela com um link e um QR code
2. Confirme o login de uma destas duas formas:
   - **No navegador.** Clique no botão à direita do link: a Yandex abre em uma nova aba e pede para confirmar o login. Se este navegador não estiver conectado à Yandex, ela pede para entrar primeiro
   - **No telefone.** Escaneie o código com o app Yandex em um telefone conectado à Yandex e confirme o login no app. Prático quando o navegador com o ViON não está conectado à Yandex
3. Volte à janela e clique em **Save**. A janela mostra a conta em que o plugin entrou. Se você clicar antes de a confirmação chegar, ela espera até 20 segundos e depois pede para clicar de novo

Confirme com a conta Yandex à qual sua Casa Inteligente pertence: o plugin vê os dispositivos e estações da conta que confirmou. A Yandex pede essa confirmação todas as vezes; sem ela, o login em uma conta não é concluído.

Se você já tem um x_token da conta, pode colá-lo no campo **x_token**.

## Configurações

- **Read devices through**: Automatic usa a API oficial quando há login nela; caso contrário, o app Yandex
- **Reading interval**: com que frequência a API oficial é consultada
- **Offer scenarios**: cenários oferecidos como interruptores
- **Speech on the stations**: Local vai direto para a estação na rede doméstica e fala textos de qualquer tamanho. Cloud passa por um cenário da conta, funciona onde quer que a estação esteja e fala até 100 caracteres. Automatic tenta Local primeiro
- **Station addresses**: só se uma estação não for encontrada na rede, no formato `Kitchen = 192.168.1.20`
- **Say on a station**: testa a fala com uma frase à sua escolha
- **Sign out**: esquece os dois logins e quais estações falam. Sensores e câmeras adicionados permanecem

## Adicionando sensores, câmeras e estações

1. Entre como descrito acima
2. Abra **Sensors** no ViON: os dispositivos da Casa Inteligente são oferecidos para adição com seus cômodos
3. Abra **Cameras**: as câmeras da Casa Inteligente estão em **Discovered**
4. Nas configurações de notificação do ViON, em Devices, as estações aparecem quando o plugin entrou como o app Yandex. Nenhuma fala até você ativá-la: ative Active nas que devem falar. Só um administrador do ViON pode fazer isso

## Bom saber

- Só são lidos os dispositivos das suas próprias casas; casas compartilhadas com você não
- Quando a Yandex deixa de aceitar um login (a senha foi trocada, o acesso foi revogado), o plugin avisa uma vez no log, esquece esse login e espera um novo. O outro login, se houver, continua funcionando
- Um dispositivo que fornece vários sensores nomeia cada um pelo próprio nome e pelo que mostra, em inglês: "Hall sensor: Motion". Renomeie-os no ViON como preferir
- A fala e o login por QR não são uma interface oficial da Yandex. Uma mudança do lado da Yandex pode exigir uma atualização do plugin. Para a fala pela nuvem, o plugin mantém um cenário por estação chamado "ViON" com o id da estação; não o apague
- O microfone de uma estação não fica disponível para outros sistemas: a Alice só ouve a Yandex. Para falar com o ViON por voz, use a skill do ViON para a Alice na nuvem do ViON
- O vídeo de uma câmera da Casa Inteligente vem da nuvem da Yandex