Авторизация аккаунта на устройстве Android

Прежде чем авторизовать аккаунт, убедитесь, что у вас есть:

1. На вашем мобильном устройстве Android установлено Google Home app (GHA).
2. В доме должно быть хотя бы одно из следующих поддерживаемых устройств для примера приложения:
   • Лампа с регулируемой цветовой температурой (включение и выключение, яркость)
   • Датчик контакта (логическое значение)
   • Светильник с регулируемой яркостью (включение, выключение, яркость)
   • Дверной замок
   • Расширенная цветовая подсветка (включение и выключение, яркость)
   • Обычный переключатель
   • Пограничный маршрутизатор Google
   • Google Камера
   • Дверной звонок Google
   • Датчик присутствия
   • Включить/выключить свет (включение и выключение, яркость)
   • Выключатель освещения
   • Включаемое/выключаемое устройство с вилкой
   • Датчик включения/выключения
3. Два устройства для тестирования автоматизации.

Прежде чем использовать устройства через Home API, необходимо убедиться, что ими можно управлять из GHA.

Как запустить пример приложения для Android

Прежде чем авторизовать аккаунт, убедитесь, что в примере приложения настроена подходящая область действия OAuth для вашего проекта. По умолчанию в исходном коде примера приложения используется область действия https://www.googleapis.com/auth/home.platform.v2. Многие функции в примере приложения ограничены областью действия home.platform.v2 и требуют одобрения партнера. Чтобы авторизовать и использовать пример приложения со стандартной областью действия https://www.googleapis.com/auth/home.platform.selected.devices, вручную замените homePlatformScope на HOME_PLATFORM_SCOPE_VERSION_1 в HomeModule.kt, как описано в разделе Создание приложения.

Запустите образец приложения для Android. При первом запуске вам будет предложено разрешить доступ к дому в аккаунте Google. Это позволит приложению Sample App получать доступ к домам и устройствам и управлять ими.

Если у вас нет дома, пользователь может создать его в процессе предоставления разрешений, не используя GHA.

Поведение приложения по умолчанию зависит от того, зарегистрировано ли оно в Google Home Developer Console.

Если приложение не зарегистрировано в Developer Console, оно будет иметь статус неподтвержденного. Для тестирования API Home рекомендуется следующее:

• Предоставлять разрешения приложению могут только пользователи, зарегистрированные в качестве тестировщиков в консоли OAuth. Для непроверенного приложения можно зарегистрировать не более 100 тестировщиков.

• Непроверенное приложение будет иметь доступ к устройствам любых типов, поддерживаемых OAuth для Home API (список типов устройств в Developer Console). Доступ будет предоставлен ко всем устройствам в доме.

Если приложение зарегистрировано в Developer Console и ему разрешен доступ к одному или нескольким типам устройств, а также подтвержден бренд для OAuth, оно получит статус подтверждено. Это состояние необходимо для запуска рабочей версии приложения.

• Ограничения на количество тестировщиков больше не действуют. Любой пользователь может предоставить разрешение приложению.
• Пользователь может предоставить разрешение только для тех типов устройств, которые были одобрены в Developer Console.

Нажмите Разрешить доступ к выбранному дому:

• Если с вашим аккаунтом связаны дома, выберите, какому из них предоставить разрешение. Если в выбранном доме не найдено устройств, вы можете:
  1. Чтобы выбрать другой дом, нажмите Предоставить доступ к другому дому.
  2. Настройте устройство в этом доме с помощью приложения Google Home app (GHA). Помните, что в этом примере приложения поддерживается управление только следующими типами устройств:
     • Лампа с регулируемой цветовой температурой (включение и выключение, яркость)
     • Датчик контакта (логическое значение)
     • Светильник с регулируемой яркостью (включение, выключение, яркость)
     • Дверной замок
     • Расширенная цветовая подсветка (включение и выключение, яркость)
     • Обычный переключатель
     • Пограничный маршрутизатор Google
     • Google Камера
     • Дверной звонок Google
     • Датчик присутствия
     • Включить/выключить свет (включение и выключение, яркость)
     • Выключатель освещения
     • Включаемое/выключаемое устройство с вилкой
     • Датчик включения/выключения
• Если с вашим аккаунтом не связан ни один дом, вы увидите сообщение Для выбранного аккаунта нет домов.
  1. Проведите пальцем назад, чтобы вернуться к основному представлению приложения Sample App.
  2. Чтобы настроить дом, используйте GHA. Затем попробуйте предоставить разрешение приложению Sample App ещё раз.

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

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