Как использовать образец приложения для iOS

В примере приложения показаны основные возможности доступа к устройствам и управления ими с помощью Home API для поддерживаемых типов устройств.

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

Если устройство находится в комнате, оно будет указано под ней. Пример приложения поддерживает следующие типы устройств:

  • Светильник с регулировкой цветовой температуры
  • Светильник с регулируемой яркостью
  • Дверной замок
  • Светильник с расширенной цветовой гаммой
  • Вентилятор
  • Пограничный маршрутизатор Google
  • Google Камера
  • Дверной звонок Google
  • Датчик присутствия
  • Включить/выключить свет
  • Подключаемый модуль включения/выключения
  • Датчик температуры
  • Термостат
  • Оконные покрытия

Действия с существующими устройствами и автоматизациями

В примере приложения есть две вкладки: Устройства и Автоматизации. На каждой вкладке представлена информация о структуре и доступны различные действия.

Вкладка "Устройства"

На вкладке Устройства (рис. 1) показаны комнаты в доме (ванная, гостиная, кабинет) и устройства в каждой комнате, а также статус каждого устройства. Вы также можете отключить устройство или изменить разрешения, нажав на значок more_horiz в правом верхнем углу экрана (рис. 2).

Вкладка "Устройства" в примере приложения Home iOS APIs.
Рисунок 1. Вкладка "Устройства"
Элементы управления устройствами в примере приложения Home iOS APIs.
Рисунок 2. Отключение устройства или изменение разрешений

Вкладка "Автоматизация"

На вкладке Автоматизации (рис. 3) показан список всех автоматизаций для дома. Для каждой автоматизации показаны ее триггеры и действия. Поддерживается несколько условий и действий.

Нажмите на автоматизацию, чтобы посмотреть сведения о ней, как показано на рисунке 4. В этом представлении вы можете увидеть подробное описание условий запуска, условий и действий.

Вкладка "Автоматизация" в примере приложения Home iOS APIs.
Рисунок 3. Вкладка "Автоматизация"
Подробные сведения о выбранной автоматизации.
Рисунок 4. Подробные сведения об автоматизации

Как создать автоматизацию

Чтобы создать автоматизацию, нажмите кнопку +Добавить в списке автоматизаций (рис. 3). На следующем экране вы увидите список рекомендуемых автоматизаций. Выберите нужную автоматизацию (рис. 5). Если ничего не заполнилось автоматически, значит в доме нет устройств, необходимых для автоматизации. Например, если вы хотите включить вентилятор и свет, в доме должны быть оба этих устройства, иначе автоматизация не будет показываться.

После выбора автоматизации вы увидите триггеры, условия и действия (рис. 6). Нажмите Сохранить, чтобы добавить автоматизацию (рис. 7).

Экран примера приложения с рекомендуемыми автоматизациями
Рисунок 5. Предложения по автоматизации
Пример экрана автоматизации в приложении.
Рисунок 6. Сохранение автоматизации
Пример экрана приложения с созданной автоматизацией.
Рисунок 7. Автоматизация создана

Как изменить автоматизацию

Чтобы изменить название и описание автоматизации, в подробном представлении автоматизации (рис. 4) нажмите на значок настроек и выберите Изменить название (рис. 8). Как показано на рисунке 9, измените название и описание, а затем вернитесь назад (рисунок 8). Чтобы сохранить изменения, нажмите на значок настроек и выберите Сохранить.

Экран примера приложения с кнопкой изменения названия.
Рисунок 8. Изменение названия автоматизации
Пример экрана приложения для изменения названия и описания автоматизации.
Рисунок 9. Редактор названия и описания

Как удалить автоматизацию

Чтобы удалить автоматизацию, перейдите к ее обзору (рис. 7). Проведите пальцем влево по автоматизации, которую хотите удалить, и нажмите на значок удаления (рис. 10).

Экран примера приложения для удаления автоматизации.
Рисунок 10. Удаление автоматизации

Редактор автоматизации общего назначения

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

Чтобы добавить общую автоматизацию, на экране "Рекомендации по автоматизации" нажмите Общая автоматизация (рис. 5).

На следующем экране вы можете изменить название и описание автоматизации.

Добавить условие запуска

Чтобы добавить условие, нажмите Добавить условие (рис. 11). На экране кандидатов на роль стартера отображаются доступные стартеры в структуре (рис. 12). Выберите один из вариантов, чтобы продолжить (рис. 13).

Экран редактора автоматизации с кнопкой "Добавить условие"
Рисунок 11. Экран редактора.
Список кандидатов на роль стартера.
Рисунок 12. Список кандидатов на роль стартера.
Экран выбора стартового покемона с доступными характеристиками для выбранного устройства
Рисунок 13. Выбор стартера.

Выберите Включается или выключается или Изменяет яркость (рис. 14 и 15) и установите переключатель в нужное положение или измените яркость. Завершив настройку, нажмите Готово, чтобы вернуться к экрану редактора. Выбранный шаблон появится на экране редактора (рис. 16).

Включать и выключать свет.
Рисунок 14. Включение и выключение света
Ползунок яркости для настройки стартера управления уровнем
Рисунок 15. Изменение яркости
Общий редактор автоматизации, в котором показан недавно добавленный стартер
Рисунок 16. Добавление условия запуска

Добавить действие-кандидат

Чтобы добавить действие, нажмите Добавить действие (рис. 17). На экране Варианты действий показаны доступные варианты действий (рис. 18). Выберите один из вариантов действий, чтобы продолжить (рис. 19).

Общий редактор программ, в котором под событием показана командная кнопка "Добавить действие"
Рисунок 17. Добавление действия
Список возможных действий
Рисунок 18. Список возможных действий
Экран выбора действий с поддерживаемыми функциями для выбранного устройства
Рисунок 19. Выбор действия
Включить или выключить свет
Рисунок 20. LevelControlTrait не поддерживается для действий.

Выберите Включается или выключается и укажите, что должно делать устройство. Нажмите Готово, чтобы вернуться к экрану редактора (рис. 21). Нажмите Сохранить, чтобы создать автоматизацию (рис. 22). Ваша автоматизация будет отображаться на вкладке автоматизации (рис. 23).

Включить или выключить свет
Рисунок 21. Включение и выключение света
Условие и действие добавлены.
Рисунок 22. Добавленные условие и действие
Вкладка "Автоматизация" с новой автоматизацией общего типа
Рисунок 23. Созданная автоматизация