Просмотр кода страницы Home-away-master-button-example

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

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

В XIOT дом — это виртуальное устройство со встроенными характеристиками '''я дома''', '''я ушёл''' и др.  
[[Файл:2025-05-13 01-50-59.png|без|мини|769x769пкс]]


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

'''Состояние дома можно изменять из трёх мест:'''
* через интерфейс приложения — кнопка с иконкой домика в правом верхнем углу,
* [[Файл:2025-05-13 01-53-32.png|без|мини]]
* голосом — через Яндекс Алису (в систему добавляется переключатель с именем '''Я дома''' в комнате '''Мой дом'''),
* [[Файл:Photo 2025-05-13 01-55-03.jpg|без|мини]]
* через виртуальное устройство "'''Кнопка"''' и сценарий "'''Сценарные кнопки"'''.

== ⚙ Настройка ==

'''1. Добавьте виртуальное устройство "Кнопка":'''
[[Файл:2025-05-13 01-58-20.png|без|мини|705x705пкс]]
* Название: '''Мастер кнопка'''
* Разместите её в комнате '''Прихожая'''
* Подробности по настройке — см. [[Виртуальное устройство "Кнопка"]]

'''2. Создайте сценарий типа "Сценарные кнопки":'''
[[Файл:12121212.png|без|мини|660x660пкс]]
* Название: '''Мастер кнопка Я ушёл  Я пришёл'''
* В разделе "Кнопка 1" — выберите созданную кнопку

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

'''Короткое нажатие:'''
[[Файл:434344344.png|без|мини|663x663пкс]]
 

'''Длинное нажатие:'''
[[Файл:653423.png|без|мини|663x663пкс]]Так мы настроили переключение состояния дома, теперь нужно добавить действия на смену состояния дома.

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


Добавляем сценарий '''"Я дома / Я ушёл"'''
[[Файл:65324.png|без|мини|939x939пкс]]

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

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

* '''Действие когда я ухожу'''
* [[Файл:213dasdasd.png|без|мини|916x916пкс]]
* '''Дополнительное действие когда я ухожу, выполняемое с задержкой'''
* [[Файл:Image324324.png|без|мини|917x917пкс]]
* '''Действие когда я ухожу в отпуск, дополнительно к действию "я ушёл'''
* [[Файл:Image12131432.png|без|мини|917x917пкс]]
* '''Действие когда я прихожу'''
*[[Файл:Image322432234.png|без|мини|915x915пкс]]
* '''Дополнительное действие когда я прихожу если ночь'''
* [[Файл:Image5432254342.png|без|мини|921x921пкс]]
* '''Дополнительное действие когда я прихожу если день'''
* [[Файл:Imageг453326324.png|без|мини|928x928пкс]]
* '''Действие когда я прихожу из отпуска, дополнительно к действию "я пришёл"'''

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

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

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

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

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

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

Доступные события:
* '''Когда прихожу домой''' — изменение состояния '''я дома'''
* '''Когда ухожу из дома''' — изменение состояния '''я ушёл'''
* '''Когда уезжаю в отпуск''' — изменение состояния '''я в отпуске'''

Для каждого события можно задать:
* Текст уведомления
* Раздел, к которому будет отнесено сообщение

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

== 💡 Рекомендации ==
* При желании можно ввести дополнительное состояние '''отпуск'''