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

2026-02-09

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

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

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

  • Сервисы Google Play: 26.02.34
  • Минимальные версии прошивки Google Hub:
    • Бросать:
      • Nest WiFi Pro: 3.76.508025
      • Все остальные хабы на базе Cast: 3.77.510748
    • Фуксия: 29.20251023.103.2100
    • Google TV Streamer, 4K: UTTK.250729.004
  • Android SDK: home.android.sdk_GHP_1_7
  • Приложение Google Home: 1.7
  • Библиотека androidx.core : работает с любой версией.
  • Версия Matter: 1.4.1.0 , с экспериментальной поддержкой версии 1.5.0 .

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

  • API разрешений
    • Запрос разрешений позволяет приложению определить, каким типам устройств пользователь предоставил доступ.

    • Другие важные изменения

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

    • API истории всегда возвращает nextPageToken , что приводит к бесконечному циклу.
    • Ошибка "Пользователь отменил поток разрешений" возникает при попытке входа в новую учетную запись.

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

    • Для камер Nest Cam Indoor/Outdoor (с батарейным питанием или проводным подключением) и дверных звонков Nest Doorbell (с батарейным питанием, 2-го поколения) опция «Оставшееся время работы от батареи» отсутствует в настройках батареи.
    • Настройка продолжительности звонка игнорируется.
    • Индикатор Philips BLE некорректно отображается как "В сети", даже когда устройство фактически находится в автономном режиме.
      • Временное решение: не полагайтесь исключительно на онлайн-статус типа устройства умного дома (SHDT). Вместо этого используйте карту состояния целевого устройства (TDSS) для устройств с источником LOCAL_SYNC .

    2025-12-22

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

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

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

    • Сервисы Google Play: 25.47.30
    • Минимальные версии прошивки Google Hub:
      • Бросать:
        • Nest WiFi Pro: 3.75.479819
        • Все остальные концентраторы на базе Cast: 3.77.505721
      • Фуксия: 28.20250723.103.2100300
      • Google TV Streamer, 4K: UTTK.250729.004
    • Android SDK: home.android.sdk_GHP_1_6
    • Приложение Google Home: 1.6
    • Библиотека androidx.core : работает с любой версией.
    • Версия Matter: 1.4.1.0

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

    • API автоматизации
    • API устройства
      • Поддержка дополнительных возможностей камер и дверных звонков:
        • Новые настройки:
          • Включение/выключение ночного видения.
          • Яркость индикатора состояния.
          • Окно просмотра камеры.
          • Ориентация изображения.
          • Чувствительность к пробуждению.
          • Максимальная продолжительность события.
          • Звуки колокольчика.

          Дополнительную информацию см. в руководстве по использованию камеры на Android .

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

      • Безступичный режим

        Теперь пользователи могут подключать и управлять некоторыми устройствами Matter без использования автономного концентратора.

    • Структура API
    • Пример приложения для Android
      • Настройки камеры и дверного звонка
        • Включение/выключение микрофона.
        • Включение/выключение аудиозаписи.
      • Предварительно настроенные автоматизации
      • Добавлена ​​поддержка типов устройств «Вентилятор» и «Акустическая система».
    • Вход в систему Google инициирован приложением.

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

    • Элементы управления устройства перестают работать после длительного использования.
      • Временное решение: перезапустите хаб.
    • Ввод в эксплуатацию устройства, работающего с материей, может завершиться неудачей.
    • Ошибка «Пользователь отменил поток разрешений» появляется при попытке добавить новую учетную запись в демонстрационном приложении для Android.
      • Временное решение: добавьте учетные записи Google через настройки устройства Android.
    • Проводная камера видеонаблюдения Walmart onn, настроенная с использованием SDK Android Home API, не может вести прямую трансляцию через приложение Google Home.

    2025-10-23

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

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

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

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

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

    • Структура API
      • API активации хаба позволяет программно обнаруживать и активировать хаб Google Home. См. API активации хаба на Android .
    • Пример приложения для Android
      • Поддерживаемые типы устройств дверного звонка:
        • Вкл.Выкл.
        • Прямая трансляция
        • Двусторонний разговор
      • API активации хабов: Активация хабов

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

    • В демонстрационном приложении статус устройства отображается некорректно в разделе «Устройство» .

    2025-09-26

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

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

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

    • Сервисы Google Play: 25.37.31
    • Минимальные версии прошивки Google Hub:
      • Состав: 3.76.492738
      • Фуксия: 27.20250422.103.3600
    • Android SDK: home.android.sdk_1_5
    • Приложение Google Home: работает с любой версией.
    • Библиотека androidx.core : работает с любой версией.
    • Версия Matter: 1.4.1.0

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

    • API автоматизации
      • Теперь начальные условия, условия и действия принимают структуры Matter в качестве параметров.
    • API устройства
      • Добавлен тип устройства «Камера» . Для типа устройства «Дверной звонок» также доступны следующие функции камеры:
        • Прямая трансляция с камеры.
        • Двусторонняя связь через камеру.
        • Камера начинает и останавливает запись.
    • Пример приложения для Android
      • Поддержка типа устройства «Камера»:
        • Прямая трансляция с камеры.
        • Двусторонняя связь через камеру.
        • Камера начинает и останавливает запись.
        • Ограниченные права доступа для различных типов устройств.
      • Ввод в эксплуатацию несколькими администраторами (совместное использование введенного в эксплуатацию устройства).
      • Предварительно заданные параметры автоматического OnOff .

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

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

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

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

    2025-09-08

    Выпущена демонстрационная версия приложения для Android — 1.4.1.

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

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

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

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

    2025-08-29

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

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

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

    • Сервисы 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 : работает с любой версией.
    • Версия Matter: 1.4.0.0

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

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

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

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

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

    2025-07-31

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

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

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

    • Сервисы 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 : работает с любой версией.
    • Версия Matter: 1.4.0.0

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

    • API устройства
    • Структура API
      • Теперь Home.hasPermissions() учитывает как состояние авторизации OAuth для пользователя (доступ к структуре), так и предоставленные приложению разрешения.
    • Пример приложения для Android
      • Заменены устаревшие вызовы API.
      • Переименовать устройство.
      • Удалите устройства, содержащие только материю.

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

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

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

    • Вакуумные устройства, которые были подключены к док-станции, не регистрируют состояние "Подключено".

    2025-07-08

    С версией прошивки Cast 3.76.479819 устройство Nest WiFi Pro теперь может функционировать как центр Home API.

    2025-06-26

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

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

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

    • Сервисы 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 : работает с любой версией.
    • Версия Matter: 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

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

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

    • Сервисы 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 : работает с любой версией.
    • Версия Matter: 1.4.0.0

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

    Черты

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

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

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

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

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

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

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

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

    2025-05-12

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

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

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

    • Сервисы 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 : работает с любой версией.
    • Версия Matter: 1.4.0.0

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

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

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

    • Временное решение: перед созданием автоматизаций проверьте наличие домашнего адреса с помощью API Discovery.

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

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

    2025-04-09

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

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

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

    • Сервисы 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
    • Версия Matter: 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

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

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

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

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

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

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

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

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

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

    2025-01-29

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

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

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

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

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

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

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

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

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

    2025-01-14

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

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

    2025-01-07

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

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

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

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

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

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

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

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

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