Интеграции

Домовёнок Кузя и Алиса

Используется HTTPS-адрес https://kuzya.blynk.aravix.ru. Адаптер преобразует чтение из формата Blynk ["22.875"] в {"value":22.875}.

Для настройки требуются Auth Token устройства, назначение пинов в вашей прошивке и учётная запись Домовёнка Кузи. В шаблонах <TOKEN> и <PIN...> замените обозначения полностью, без угловых скобок. Примеры ниже используют вымышленный токен 0123456789abcdef0123456789abcdef и условные пины: V3 — температура, V21 — команда, V22 — состояние (0/1).

Проверка API

Как проверить: в адресах ниже замените вымышленный токен 0123456789abcdef0123456789abcdef своим и откройте каждый адрес отдельно в браузере. При необходимости замените V3 на виртуальный пин, который передаёт числовое значение.

Браузер · проверка подключения и чтения

https://api.blynk.aravix.ru/0123456789abcdef0123456789abcdef/isHardwareConnected
https://kuzya.blynk.aravix.ru/0123456789abcdef0123456789abcdef/get/V3

Первый запрос — true при подключённом устройстве. Второй — объект с полем value при совместимом ответе чтения, например {"value":22.875}.

Поля HTTP-правила

Порядок полей формы «Правило HTTP» на alexstar.ru/smarthome:

№	Поле	Значение
1	Активационная фраза	Собственная команда навыка или служебная фраза
2	Ответ Кузи	Текст ответа; для показаний доступно `{value}`
3	URL управления устройством	Полный HTTPS-адрес нужного API-запроса
4	Перекодировать URL	НЕТ
5	Тип запроса	GET
6	Поиск значений в фразе	Не искать
7	Ждать ответ от сервера	ДА для чтения, НЕТ для простой команды
8	Проверять SSL сертификат сервера	ДА
9	Выход из навыка после выполнения	ДА для одиночной команды; НЕТ для серии
10	Правило включено	ВКЛ
11	Выполнять на выбранных устройствах	Нужные устройства/сеансы

«Приветственная фраза» задаётся отдельно в общих настройках и не является полем HTTP-правила.

Способ 1. Голосовой навык

В Алисе: «Запусти навык Домовёнок Кузя». При необходимости выполните привязку десятизначным кодом из настроек Кузи (это не Auth Token Blynk). Затем произносите заданные активационные фразы.

Создайте три правила. Для всех: GET, перекодирование URL НЕТ, поиск значений Не искать, проверка SSL ДА, правило ВКЛ, выбраны нужные сеансы. «Выход из навыка» — НЕТ, если хотите давать несколько команд подряд.

Включить реле

Активационная фразавключить реле

Ответ КузиКоманда включения отправлена

Ждать ответНЕТ

URL правила · GET

https://kuzya.blynk.aravix.ru/<TOKEN>/update/<PIN_CTRL>?value=1

Пример · URL с вымышленным токеном

https://kuzya.blynk.aravix.ru/0123456789abcdef0123456789abcdef/update/V21?value=1

Выключить реле

Активационная фразавыключить реле

Ответ КузиКоманда выключения отправлена

Ждать ответНЕТ

URL правила · GET

https://kuzya.blynk.aravix.ru/<TOKEN>/update/<PIN_CTRL>?value=0

Пример · URL с вымышленным токеном

https://kuzya.blynk.aravix.ru/0123456789abcdef0123456789abcdef/update/V21?value=0

Температура дома

Активационная фразатемпература дома

Ответ КузиСейчас {value} градусов

Ждать ответДА

URL правила · GET

https://kuzya.blynk.aravix.ru/<TOKEN>/get/<PIN_READ>

Пример · URL с вымышленным токеном

https://kuzya.blynk.aravix.ru/0123456789abcdef0123456789abcdef/get/V3

Проверяйте физическое переключение реле, а не только произнесённый ответ. Если автоматика прошивки запрещает ручное управление, предварительно переключите её в соответствующий режим.

Способ 2. «Дом с Алисой»

На странице устройств Кузи создайте виртуальную «Розетку».
Создайте два HTTP-правила: управление и чтение состояния.
В свойствах розетки назначьте правило управления для включения и выключения, правило чтения — для запроса состояния.
В приложении «Дом с Алисой» подключите сервис «Домовёнок Кузя» с тем же Яндекс ID. Обновите список устройств и присвойте розетке удобное имя.

Для обоих правил: GET, перекодирование URL НЕТ, поиск значений «Не искать», SSL ДА, правило ВКЛ; выбрать нужные сеансы.

У1 · управление

Активационная фразауправление устройством

Ответ КузиКоманда отправлена

Ждать ответНЕТ

URL правила · GET

https://kuzya.blynk.aravix.ru/<TOKEN>/update/<PIN_CTRL>?value={value}

Пример · URL с вымышленным токеном

https://kuzya.blynk.aravix.ru/0123456789abcdef0123456789abcdef/update/V21?value={value}

У2 · чтение состояния

Активационная фразасостояние устройства

Ответ КузиСостояние устройства

Ждать ответДА

URL правила · GET

https://kuzya.blynk.aravix.ru/<TOKEN>/get/<PIN_STATE>

Пример · URL с вымышленным токеном

https://kuzya.blynk.aravix.ru/0123456789abcdef0123456789abcdef/get/V22

Важно: в У1 сохраните буквальную запись {value} с фигурными скобками: Кузя подставит 1 или 0. В отличие от этого, в правилах голосового навыка выше значения фиксированы.

Только в правиле управления виртуальной розеткой сохраните {value} без изменений: значение подставляет Кузя. В остальных примерах управляющее значение указывается прямо в URL.

Важно для проверки: {value} — подстановка самого Кузи. Не вставляйте такой адрес в браузер для ручной проверки. Для пробного управляющего запроса укажите конкретное безопасное значение, например 0 или 1, если ваша прошивка использует именно их. Запрос может изменить состояние оборудования.

Для <PIN_STATE> используйте пин фактического состояния, если он есть. Виртуальная розетка должна получать совместимое значение включено/выключено (обычно 0/1). При кодировании статуса 0/255 отдельно проверьте отображение.

Проверка управления

Включите и выключите виртуальную розетку из «Дома с Алисой», затем голосом: «Алиса, включи [имя устройства]». Проверьте реальное состояние исполнительного устройства. Измените его состояние из Blynk и убедитесь, что статус в «Доме с Алисой» обновляется.