Главная API Примечания к выпуску Android SDK

2025-09-08

Вышел пример приложения для Android версии 1.4.1.

Новые функции

  • Создание, переименование, обновление и удаление комнаты.
  • Ввод в эксплуатацию сторонней фабрики Matter.

Исправлены известные проблемы

  • Ссылка на страницу отзыва разрешений теперь работает.

29 августа 2025 г.

Главная API Публичная бета-версия 1.4.1

В этом выпуске исправлены ошибки и улучшено качество бета-версии Home APIs Android SDK.

Минимальные версии

  • Сервисы Google Play: 25.33.32
  • Минимальные версии прошивки Google Hub:
    • В ролях: 3.76.495998
    • Фуксия: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_4_1
  • Приложение Google Home: работает с любой версией
  • библиотека androidx.core : работает с любой версией
  • Версия вопроса: 1.4.0.0

Новые функции

Известные проблемы

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

Исправлены известные проблемы

  • Приложение Android Sample App аварийно завершает работу, когда пользователь пытается установить термостат в режим, который он не поддерживает.

2025-07-31

Главная API Публичная бета-версия 1.4.0

В этом выпуске исправлены ошибки и улучшено качество бета-версии Home APIs Android SDK.

Минимальные версии

  • Сервисы Google Play: 25.28.34
  • Минимальные версии прошивки Google Hub:
    • В ролях: 3.76.486931
    • Фуксия: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_4_0
  • Приложение Google Home: работает с любой версией
  • библиотека androidx.core : работает с любой версией
  • Версия вопроса: 1.4.0.0

Новые функции

Известные проблемы

  • После выхода из телефона и повторного входа приложение Home API не может управлять устройствами.
    • Обходной путь: закройте или переведите приложение в фоновый режим, затем подождите не менее 10 секунд, прежде чем повторить попытку.

Исправлены известные проблемы

  • Пристыкованные вакуумные устройства не регистрируют состояние «Пристыковано».

2025-07-08

Благодаря прошивке Cast версии 3.76.479819 Nest WiFi Pro теперь может функционировать как концентратор Home API.

2025-06-26

Главная API Публичная бета-версия 1.3.2

В этом выпуске исправлены ошибки и улучшено качество бета-версии Home APIs Android SDK.

Минимальные версии

  • Сервисы Google Play: 25.23.31
  • Минимальные версии прошивки Google Hub:
    • Бросать:
      • Google Home, Google Home Mini и Google Nest Mini: 3.75.468362
      • Google Nest Audio: 3.75.476451
    • Фуксия: 26.20250116.103.2900
  • Android SDK: home.android.sdk_1_3_2
  • Приложение Google Home: работает с любой версией
  • библиотека androidx.core : работает с любой версией
  • Версия вопроса: 1.4.0.0

Новые функции

  • Артефакт SDK был разделен на два отдельных артефакта:
    • Фреймворк Home APIs SDK ( play-services-home-17.0.0.aar )
    • Характеристики SDK и типы устройств ( play-services-home-types-17.0.0.aar )

    Начиная с этого выпуска разработчикам необходимо включить оба артефакта в пути к библиотекам времени компиляции и времени выполнения своего проекта.

Пример приложения для Android

  • Пользователи могут отключать и отзывать разрешения у приложения.
  • Обновлены артефакты SDK для включения play-services-home-17.0.0 и play-services-home-types-17.0.0 .

Известные проблемы

  • Пристыкованные вакуумные устройства не регистрируют состояние «Пристыковано».

2025-06-05

Главная API Публичная бета-версия 1.3.1

В этом выпуске исправлены ошибки и улучшено качество бета-версии Home APIs Android SDK.

Минимальные версии

  • Сервисы Google Play: 25.19.32
  • Минимальные версии прошивки Google Hub:
    • В ролях: 3.75.468222
    • Фуксия: 26.20250116.103.2201
  • Android SDK: home.android.sdk_202505_EAP_1_3_1_RC06
  • Приложение Google Home: работает с любой версией
  • библиотека androidx.core : работает с любой версией
  • Версия вопроса: 1.4.0.0

Новые функции

Черты

  • Представлена ​​функция SyntheticSwitch , которая упрощает обработку событий, генерируемых устройствами Matter Switch, и позволяет переключателям запускать пускатели автоматизации.
  • Трейт ExtendedDoorLock претерпел критическое изменение: тип данных поля user_id был изменён со String на Long . См.

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

Пример приложения для Android

Добавлены функции регистрации состояния структур, устройств, типов, характеристик и автоматики для упрощения отладки.

Известные проблемы

В приложении Android Sample App для срабатывания кнопки «Создать автоматизацию» иногда требуется несколько нажатий.

Исправлены известные проблемы

  • Приложение Google Home аварийно завершает работу с исключением FailedPreconditionException при создании автоматизаций, если местоположение дома не задано в приложении Google Home (GHA) (см. раздел Изменение адреса Google Home, чтобы узнать, как задать местоположение дома).
  • В приложении для Android Sample App устройство с connectivityState PARTIALLY_ONLINE ранее отображалось пользователю как «офлайн». Теперь это состояние отображается как «онлайн» .

2025-05-12

Главная API Публичная бета-версия 1.3

В этом выпуске исправлены ошибки и улучшено качество бета-версии Home APIs Android SDK.

Минимальные версии

  • Сервисы Google Play: 25.16.33
  • Минимальные версии прошивки Google Hub:
    • В ролях: 3.75.468222
    • Фуксия: 26.20250116.103.2201
  • Android SDK: home.android.sdk_202504_EAP_1_3_RC00
  • Приложение Google Home: работает с любой версией
  • библиотека androidx.core : работает с любой версией
  • Версия вопроса: 1.4.0.0

Новые функции

Известные проблемы

Приложение Google Home аварийно завершает работу с исключением FailedPreconditionException при создании автоматизаций, если местоположение дома не задано в приложении Google Home (GHA) (см. раздел Изменение домашнего адреса Google, чтобы узнать, как это сделать).

  • Обходной путь: проверьте наличие домашнего адреса с помощью Discovery API, прежде чем пытаться создавать автоматизацию.

Исправлены известные проблемы

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

2025-04-09

Главная API Публичная бета-версия 1.2.1

В этом выпуске исправлены ошибки и улучшено качество бета-версии Home APIs Android SDK.

Минимальные версии

  • Сервисы Google Play: 25.09.33
  • Минимальные версии прошивки Google Hub:
    • В ролях: 3.75.468222
    • Фуксия: 24.20241009.103.1900601 1
  • Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
  • Приложение Google Home: работает с любой версией
  • библиотека androidx.core : 1.10.0
  • Версия вопроса: 1.4.0.0
1. Эта сборка в настоящее время внедряется в производство и будет доступна для всех устройств к 22 апреля 2025 года.

Новые функции

  • Улучшена производительность при загрузке объектов из домашнего графика.
  • API автоматизации
    • Добавлена ​​поддержка фильтров сущностей , которые позволяют автоматике динамически выбирать устройства на основе критериев, указанных в автоматизации.
  • API устройства
    • Информация об устройствах, передающих данные из облака в облако, теперь доступна в BasicInformationTrait .

Известные проблемы

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

Исправлены известные проблемы

  • Если API Discovery вызывается до инициализации или до ее завершения, возникает исключение HomeException с code 14: UNKNOWN и сообщением «Маршрут не найден».
  • В среде, содержащей несколько структур и несколько пользователей, переключение между структурами и пользователями может привести к тому, что устройства не будут возвращены.

2025-03-14

Главная API Публичная бета-версия 1.2.0

В этом выпуске исправлены ошибки и улучшено качество бета-версии Home APIs Android SDK.

Минимальные версии

  • Минимальная версия Google Play Services: 25.06.32
  • Минимальные версии прошивки Google Hub:
    • Версия в ролях: 3.75.456944
    • Минимальная версия Fuchsia: 24.20241009.103.1900601
  • Android SDK: home.android.sdk_1_2_0_RC06
  • Минимальная версия приложения Google Home: работает с любой версией
  • Минимальная версия библиотеки androidx.core : 1.10.0
  • Версия вопроса: 1.3.0.0
    • Примечание: типы устройств и кластеры Provisional Matter не поддерживаются.

Новые функции

  • API автоматизации:
    • Поддержка диапазонов дат и частичных дат в условиях автоматизации. См. раздел Использование дат с интервалом между ними .
    • В предыдущих версиях API Discovery возвращал NumberSetConstraint для некоторых полей растровых изображений, хотя должен был возвращать BitmapConstraint . Теперь эти поля возвращают BitmapConstraint , как и ожидалось. Это касается только растровых изображений optionsMask и optionsOverride в командах типажа LevelControl .

Известные проблемы

  • При переключении с Wi-Fi на мобильную сеть может наблюдаться увеличенная задержка управления устройством.
  • После сброса настроек концентратора до заводских настроек устройства могут отображаться как отключенные.
  • Если API Discovery вызывается до инициализации или до ее завершения, возникает исключение HomeException с code 14: UNKNOWN и сообщением «Маршрут не найден».
    • Обходной путь: вызывайте Discovery API только тогда, когда вам действительно нужны кандидаты для автоматизации. Не выполняйте предварительную выборку и кэширование сущностей-кандидатов. Перед вызовом методов Discovery API убедитесь, что сущность доступна онлайн.
  • В среде, содержащей несколько структур и несколько пользователей, переключение между структурами и пользователями может привести к тому, что устройства не будут возвращены.

Исправлены известные проблемы

  • При первом вызове HomeManager.structures() приложением Home API после запуска оно не получает ни одной структуры, даже если присутствует одна или несколько структур. Это создаёт ложное впечатление, что с учётной записью Google не связаны структуры.
  • При загрузке, создании и редактировании автоматизаций пользователи могут сталкиваться с длительным временем ожидания.
  • Пользователям, которые начинают процесс настройки из приложения «Камера», необходимо дважды отсканировать QR-код, чтобы завершить настройку Matter.
  • В структуре, содержащей более 200 устройств, API Discovery может просто не вернуть ни одного кандидата.

29 января 2025 г.

Главная API Публичная бета-версия 1.1.0

В этом выпуске исправлены ошибки и улучшено качество бета-версии Home APIs Android SDK.

Минимальные версии

  • Минимальная версия Google Play Services: 25.02.32
  • Минимальные версии прошивки Google Hub:
    • Версия в ролях: 3.75.456944
    • Минимальная версия Fuchsia: 24.20241009.103.1900500
  • Android SDK: home.android.sdk_202412_EAP_1_1_RC04
  • Минимальная версия приложения Google Home: работает с любой версией
  • Минимальная версия библиотеки androidx.core : 1.10.0
  • Версия вопроса: 1.3.0.0
    • Примечание: типы устройств и кластеры Provisional Matter не поддерживаются.

Новые функции

Известные проблемы

  • При загрузке, создании и редактировании автоматизаций пользователи могут сталкиваться с длительным временем ожидания.
  • Пользователям, которые начинают процесс настройки из приложения «Камера», необходимо дважды отсканировать QR-код, чтобы завершить настройку Matter.
  • В структуре, содержащей более 200 устройств, API Discovery может просто не вернуть ни одного кандидата.

Исправлены известные проблемы

  • Переключение зарегистрированной учетной записи Google может завершиться неудачей и привести к ошибке.
  • Устройства Google TV могут не работать для автоматизаций, использующих функцию MediaPlayback .
  • В структуре, содержащей только Google-хаб:
    • Устройства Matter могут отображаться в приложении Google Home как отключенные.
    • Google Assistant не может управлять устройствами Matter.
    • Умные дисплеи не могут управлять устройствами Matter или отображать состояние любого устройства Matter.
  • На некоторых устройствах приложение может не всегда точно отражать состояние, и ваше приложение может сообщать состояние, отличное от того, которое сообщает приложение Google, например, Google Home. Обычно это происходит из-за того, что устройства не передают данные о состоянии в Google.
    • Обходной путь: проверка состояния с помощью приложения Google устраняет несоответствие.

2025-01-14

Обновлено руководство по инициализации Home API.

Мы чётко указали, что экземпляр Home должен быть инициализирован как контекстный синглтон . Это обеспечивает более плавный пользовательский опыт в вашем приложении и позволяет избежать ошибок, связанных с недействительными сеансами.

2025-01-07

Главная API Публичная бета-версия

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

В этом выпуске исправлены ошибки и улучшено качество бета-версии Home APIs Android SDK, включая улучшенную поддержку устройств Google Nest Audio и Google TV.

Минимальные версии

  • Минимальная версия сервисов Google Play: 24.45.34
  • Минимальные версии прошивки Google Hub:
    • Версия в ролях: 3.74.444798
    • Минимальная версия Fuchsia: 22.20240805.103.161
  • Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
  • Минимальная версия приложения Google Home (GHA): работает с любой версией
  • Минимальная версия библиотеки androidx.core : 1.10.0
  • Версия вопроса: 1.3.0.0
    • Примечание: типы устройств и кластеры Provisional Matter не поддерживаются.

Известные проблемы

  • Переключение зарегистрированной учетной записи Google может завершиться неудачей и привести к ошибке.
    • Обходной путь: повторно запустите процесс предоставления разрешений или перезапустите приложение.
  • Устройства Google TV могут не работать для автоматизаций, использующих функцию MediaPlayback .
  • В структуре, содержащей только Google-хаб:
    • Устройства Matter могут отображаться в приложении Google Home (GHA) как отключенные от сети.
    • Google Assistant не может управлять устройствами Matter.
    • Умные дисплеи не могут управлять устройствами Matter или отображать состояние любого устройства Matter.
  • На некоторых устройствах приложение может не всегда точно отражать состояние, и ваше приложение может сообщать состояние, отличное от того, которое сообщает приложение Google, например, приложение Google Home (GHA). Обычно это происходит из-за того, что устройства не передают данные о состоянии в Google.
    • Обходной путь: проверка состояния с помощью приложения Google устраняет несоответствие.

Исправлены известные проблемы

  • Ввод в эксплуатацию может завершиться неудачей, если во время процесса приложение будет свернуто.
    • Обходной путь: используйте API suppressHalfSheetNotification() для подавления уведомлений о половинных листах, когда в вашем приложении используется API Commissioning.
  • Проблема на стороне сервера может помешать работе стартеров OkGoogle в автоматизациях.
  • При использовании концентратора под управлением Fuchsia, в структуре которого нет устройств Matter, если концентратор остается бездействующим более 3 часов, ввод в эксплуатацию первого устройства Matter приводит к тому, что устройство Matter переходит в автономный режим.
  • После сброса настроек концентратора к заводским настройкам команды для вновь подключенных устройств могут не выполняться, несмотря на то, что устройство сообщается как подключенное к сети.