Используйте образец приложения для Android

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

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

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

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

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

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

Вкладка «Устройства» (рисунок 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 .