Home-away-master-button-example

Назначение: централизованное управление состоянием дома (дома / ушёл) через Мастер кнопку в прихожей — с возможностью запуска сценариев, отключения оборудования и взаимодействия с голосовым помощником. Используется при входе и выходе из дома.

🏠 Общее описание

В XIOT дом — это виртуальное устройство со встроенными характеристиками я дома, я ушёл и др.

Эти характеристики:

• всегда присутствуют и активированы,
• используются как глобальные флаги во всех сценариях,
• используются без привязки к физическим адресам управления или состояния.

Состояние дома можно изменять из трёх мест:

• через интерфейс приложения — кнопка с иконкой домика в правом верхнем углу,

• 

• голосом — через Яндекс Алису (в систему добавляется переключатель с именем Я дома в комнате Мой дом),

• 

• через виртуальное устройство "Кнопка" и сценарий "Сценарные кнопки".

⚙ Настройка

1. Добавьте виртуальное устройство "Кнопка":

• Название: Мастер кнопка
• Разместите её в комнате Прихожая
• Подробности по настройке — см. Виртуальное устройство "Кнопка"

2. Создайте сценарий типа "Сценарные кнопки":

• Название: Мастер кнопка Я ушёл Я пришёл
• В разделе "Кнопка 1" — выберите созданную кнопку

3. Настройте действия для короткого и длинного нажатия:

Короткое нажатие:

Длинное нажатие:

Так мы настроили переключение состояния дома, теперь нужно добавить действия на смену состояния дома.

🔁 Добавляем действия при смене состояния дома

Добавляем сценарий "Я дома / Я ушёл"

Он подписан на изменение состояния дома и позволяет задать полный набор действий, зависящих от того, уходит пользователь или возвращается.

Сценарий включает следующие блоки:

• Действие когда я ухожу

• 

• Дополнительное действие когда я ухожу, выполняемое с задержкой

• 

• Действие когда я ухожу в отпуск, дополнительно к действию "я ушёл

• 

• Действие когда я прихожу

• 

• Дополнительное действие когда я прихожу если ночь

• 

• Дополнительное действие когда я прихожу если день

• 

• Действие когда я прихожу из отпуска, дополнительно к действию "я пришёл"

🛠 Настройка по пожеланиям Владельца

Действия при смене состояния дома настраиваются Интегратором по согласованию с Владельцем. Можно изначально задать примерное поведение (выключение света, активация охраны и т.д.), а после ввода системы в эксплуатацию — доработать сценарий по фактическим пожеланиям Владельца.

Все изменения можно внести удалённо, без выезда на объект.

🗣 Интеграция с Алисой

• Характеристика я дома отображается как переключатель в Яндекс Алисе
• Можно добавить сценарий в Алисе, и настроить включение/выключение переключателя (состояния дома) на нужные голосовые команды (например, Алиса мы пришли, Алиса мы уходим, Алиса я ушел
• Переключатель мгновенно возвращает состояние в Алису, и можно настроить действия Алисы на изменение переключателя. К примеру Вы пришли домой, нажила физический выключатель, состояние дома переключилось на Я дома, переключатель в алисе мгновенно изменилось, и Алиса поприветствовала вас фразой "Добрый день! В доме все в порядке, я за всем слежу" и включила музыку.

📲 Уведомления в Telegram

Для каждого изменения состояния дома уже активировано автоматическое уведомление в Telegram. Настройка выполняется в свойствах виртуального устройства Дом на вкладке Уведомления.

Доступные события:

• Когда прихожу домой — изменение состояния я дома
• Когда ухожу из дома — изменение состояния я ушёл
• Когда уезжаю в отпуск — изменение состояния я в отпуске

Для каждого события можно задать:

• Текст уведомления
• Раздел, к которому будет отнесено сообщение

Доступные категории (разделы) уведомлений:

• Выключено — уведомление не отправляется
• Отладка — используется для тестов и временных сообщений
• Информация — стандартные информационные события
• Предупреждение — требует внимания, но не критично
• Тревога — важное событие, требующее немедленного реагирования
• Ошибка — сбой в работе системы

💡 Рекомендации

• При желании можно ввести дополнительное состояние отпуск