Yandex Smart Home
@vionvision/camera-ui-yandexv0.2.4
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.
- Versão
- 0.2.4
- Atualizado
- 17 de outubro de 2026
- Requer
- ViON 2.3.4 ou mais recente
- Licença
- MIT
- Grupo
- Casa inteligente
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:
- 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"
- Digite o App ID e o App secret nas configurações do plugin e clique em Sign in with Yandex ID
- 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:
- Clique em Sign in with a link or QR code. Abre uma janela com um link e um QR code
- 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
- 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
- Entre como descrito acima
- Abra Sensors no ViON: os dispositivos da Casa Inteligente são oferecidos para adição com seus cômodos
- Abra Cameras: as câmeras da Casa Inteligente estão em Discovered
- 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