Яндекс Умный дом

Связывает ViON с Умным домом Яндекса и станциями Алисы. Датчики и реле хаба в Яндекс Станции становятся датчиками ViON, сценарии Умного дома запускаются из автоматизаций ViON, станции зачитывают уведомления вслух, а камеры Умного дома появляются в ViON.

Что умеет

• Датчики: движение, двери и окна, протечки, дым, газ, вибрация, кнопки, температура, влажность, освещённость и CO₂ Умного дома становятся датчиками ViON. Они могут запускать запись и распознавание на камерах и автоматизации
• Управление: реле, розетки, выключатели и освещение Умного дома становятся выключателями и освещением ViON, поэтому автоматизации ViON включают и выключают их
• Кондиционеры, телевизоры, ИК-пульты: кроме включения и выключения, режим, температура и вентилятор кондиционера, громкость, канал, вход и отключение звука телевизора, а также выученные кнопки ИК-пульта находятся в настройках их выключателя (страница Devices в ViON, More). Пульт только из кнопок становится отдельным выключателем
• Сценарии: каждый сценарий Умного дома предлагается как выключатель. Его включение запускает сценарий — из интерфейса или из автоматизации
• Речь на станциях: при входе через приложение Яндекс каждая станция становится получателем уведомлений. Включённая станция зачитывает уведомления вслух: «Движение. Камера во дворе»
• Ассистент: ассистент ViON может произнести фразу на станции, дать команду Алисе, запустить сценарий и узнать состояние устройств
• Камеры: камеры Умного дома предлагаются в разделе Cameras и показывают прямой эфир

Два способа входа

Плагин может использовать любой из способов входа или оба сразу.

Официальный API Умного дома. API, который Яндекс предоставляет владельцам Умного дома. Он читает устройства и сценарии и отправляет команды. Push-уведомлений у него нет: плагин опрашивает его с интервалом (по умолчанию 10 секунд). Нужно приложение в Яндекс ID с правами iot:view и iot:control:

1. Создайте приложение на сайте Яндекс ID (oauth.yandex.ru): платформа «Веб-сервисы», права «Просмотр списка устройств умного дома» и «Управление устройствами умного дома»
2. Введите его App ID и App secret в настройках плагина и нажмите Sign in with Yandex ID
3. Откройте ya.ru/device на телефоне или компьютере, введите код, который показывает окно, затем нажмите кнопку в окне

Без секрета окно вместо этого показывает страницу Яндекс ID: разрешите там доступ, скопируйте токен и вставьте его в окно. Яндекс ID показывает там токен, только если у приложения задан Redirect URI oauth.yandex.ru/verification_code (с https в начале): сначала укажите его в настройках приложения на oauth.yandex.ru.

Приложение Яндекс (ссылка или QR-код). Плагин входит так же, как приложения Яндекса. Этот вход нужен для речи на станциях, и он сразу сообщает об изменениях датчиков:

1. Нажмите Sign in with a link or QR code. Откроется окно со ссылкой и QR-кодом
2. Подтвердите вход одним из двух способов:
3. В браузере. Нажмите кнопку справа от ссылки: Яндекс откроется в новой вкладке и попросит подтвердить вход. Если в этом браузере вы не вошли в Яндекс, сначала он попросит войти
4. На телефоне. Отсканируйте код приложением Яндекс на телефоне, где выполнен вход в Яндекс, и подтвердите вход в приложении. Удобно, если в браузере с ViON вход в Яндекс не выполнен
5. Вернитесь в окно и нажмите Save. Окно покажет аккаунт, в который вошёл плагин. Если нажать до того, как пришло подтверждение, окно ждёт до 20 секунд, а затем просит нажать снова

Подтверждайте тем аккаунтом Яндекса, к которому относится ваш Умный дом: плагин видит устройства и станции аккаунта, который подтвердил вход. Яндекс каждый раз запрашивает это подтверждение, без него вход в аккаунт не проходит.

Если у вас уже есть x_token аккаунта, можно вместо этого вставить его в поле x_token.

Настройки

• Read devices through: Automatic использует официальный API, если по нему выполнен вход, иначе приложение Яндекс
• Reading interval: как часто опрашивается официальный API
• Offer scenarios: сценарии, предлагаемые как выключатели
• Speech on the stations: Local идёт напрямую на станцию в домашней сети и зачитывает текст любой длины. Cloud идёт через сценарий аккаунта, работает где бы ни находилась станция и зачитывает до 100 символов. Automatic сначала пробует Local
• Station addresses: только если станция не находится в сети, в виде Kitchen = 192.168.1.20
• Say on a station: проверяет речь фразой на ваш выбор
• Sign out: забывает оба входа и какие станции говорят. Добавленные датчики и камеры остаются

Добавление датчиков, камер и станций

1. Выполните вход, как описано выше
2. Откройте Sensors в ViON: устройства Умного дома предлагаются для добавления вместе с комнатами
3. Откройте Cameras: камеры Умного дома находятся в разделе Discovered
4. В настройках уведомлений ViON, в разделе Devices, станции появляются, когда плагин вошёл через приложение Яндекс. Ни одна из них не говорит, пока вы её не включите: включите Active у тех, что должны говорить. Это может сделать только администратор ViON

Полезно знать

• Читаются только устройства ваших собственных домов; дома, к которым вам дали доступ, — нет
• Когда Яндекс перестаёт принимать вход (пароль сменили, доступ отозвали), плагин один раз сообщает об этом в журнале, забывает этот вход и ждёт нового. Другой вход, если он есть, продолжает работать
• Устройство, которое даёт несколько датчиков, называет каждый по себе и по тому, что он показывает, на английском: "Hall sensor: Motion". Переименуйте их в ViON как удобно
• Речь и вход по QR-коду — не официальный интерфейс Яндекса. Изменения на стороне Яндекса могут потребовать обновления плагина. Для речи через облако плагин хранит по одному сценарию на станцию с названием "ViON" и id станции; не удаляйте его
• Микрофон станции недоступен сторонним системам: Алиса слушает только Яндекс. Чтобы говорить с ViON голосом, используйте навык ViON для Алисы в облаке ViON
• Видео с камеры Умного дома приходит из облака Яндекса