Используйте пример приложения Android

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

После завершения авторизации учётной записи и выбора структуры приложение Sample App загружает все локальные устройства, найденные в этой структуре. Если устройство находится в комнате, оно будет указано в списке этой комнаты. Приложение Sample App поддерживает следующие типы устройств:

  • Цветовая температура света (вкл. и выкл., яркость)
  • Контактный датчик (булевое состояние)
  • Регулируемый свет (включение и выключение, яркость)
  • Расширенная цветовая подсветка (вкл./выкл., яркость)
  • Универсальный коммутатор
  • Google Камера
  • Датчик присутствия (определение присутствия)
  • Вкл./Выкл. Свет (вкл. и выкл., яркость)
  • Переключатель вкл/выкл света
  • Вставной блок включения/выключения (вкл. и выкл.)
  • Датчик вкл/выкл

Действия над существующими устройствами и автоматикой

Приложение-пример состоит из двух вкладок: «Устройства» и «Автоматизация» . Каждая вкладка предоставляет информацию о структуре и позволяет выполнять задачи.

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

На вкладке «Устройства» (рис. 1) отображаются комнаты в здании («Задний двор», «Чердак», «Транзит») и устройства в каждой комнате, а также их статус. Чтобы просмотреть или изменить характеристики устройства, коснитесь его имени. Откроется экран управления этим устройством (рис. 2).

Чтобы добавить устройство в структуру, нажмите « Добавить устройство» на вкладке «Устройства» (рис. 1), затем следуйте инструкциям по добавлению устройства с использованием QR-кода или без него.

Вкладка «Устройства» в примере приложения Home API.
Рисунок 1 : Пример экрана приложения: вкладка «Устройства»
Элементы управления устройствами примера приложения Home API.
Рисунок 2 : Примеры элементов управления устройством приложения

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

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

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

Кроме того, в подробном представлении автоматизации (рис. 4) можно включить или выключить автоматизацию, используя переключатель isActive . Поле isValid устанавливается SDK и принимает значение false в случае возникновения проблем с поддержкой устройства, трейта или других проблем.

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

Создать автоматизацию

Чтобы создать новую автоматизацию, нажмите кнопку «Создать» в списке автоматизаций (рис. 3). Откроется экран «Новая автоматизация» (рис. 5).

Используйте кнопки «+Добавить стартовое устройство» и «+Добавить действие» (рис. 5), чтобы добавить один или несколько стартовых устройств и действий в автоматизацию. На рисунках 6 и 7 показаны примеры выбора стартового устройства и действия соответственно. После того, как вы сделаете свой выбор и сохраните стартовое устройство или действие, вам будут доступны кнопки « Обновить стартовое устройство» и «Удалить стартовое устройство» для стартового устройства (и «Обновить действие» и «Удалить действие» для действия). Это даёт вам возможность отредактировать стартовое устройство или действие или удалить его перед сохранением самой автоматизации.

После завершения добавления стартеров и действий вы можете вернуться на экран «Новая автоматизация» и нажать «Создать автоматизацию» (рис. 8).

Пример экрана приложения для запуска новой автоматизации.
Рисунок 5 : Начало создания новой автоматизации
Пример экрана приложения для добавления стартера для автоматизации.
Рисунок 6 : Добавление пускателя к системе автоматизации
Пример экрана приложения для добавления действия для автоматизации.
Рисунок 7 : Добавление действия в автоматизацию
Пример экрана приложения для создания автоматизации.
Рисунок 8 : Создание автоматизации

Поиск неисправностей

Приложение отображает диалоговые сообщения о некоторых распространённых событиях. Информацию о том, как устранить эти события, можно найти в журналах adb .

Если у вас возникли проблемы при использовании примера приложения, см. раздел Устранение неполадок для Android .