Используйте пример приложения 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).

Use the +Add Starter and +Add Action buttons (Figure 5) to add one or more starter and action to your automation. Figures 6 and 7 show examples of selecting a starter and an action, respectively. After you have made your selections, and you save the starter or action, you are then presented with the Update Starter and Remove Starter buttons for the starter (and Update Action and Remove Action for the action). This gives you the opportunity to edit the starter or action, or remove it, before you save the automation itself.

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

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

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

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

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