2026-10-22
Общедоступная версия Home API 1.11.1В этом выпуске исправлены ошибки и улучшено качество общедоступной версии Home APIs Android SDK.
Минимальные версии
- Сервисы Google Play: 26.40.32
- Встроенное ПО Google Hub, Cast, Nest WiFi Pro: 3.78.556638
- Встроенное ПО Google Hub, Cast, все остальные хабы на основе Cast: 3.79.558061
- Встроенное ПО Google Hub, Fuchsia: 31.20260429.103.8713700
- Встроенное ПО контроллера Google, Google TV Streamer (4K): UTTK.260317.003.
- Android SDK: home.android.sdk_1_11_1.zip
- Приложение Google Home: работает с любой версией.
-
Библиотека
androidx.core: работает с любой версией. - Версия Matter: 1.4.1.0
- Версия Matter: экспериментальная поддержка 1.5.0
Новые функции
- Поддержка создания, обновления и удаления автоматических кривых освещения, которые регулируют яркость и цветовую температуру в течение дня в комнатах или на определенных осветительных устройствах.
- Добавлены инструкции о том, как платформа обрабатывает автоматическое удаление пользовательских данных, когда пользователь покидает структуру или удаляет свой аккаунт Google, и как пользователи могут экспортировать свои данные с помощью Google Архиватора.
-
Поддержка настройки и получения языкового стандарта приложения с помощью
setLocale()иgetLocale()для интерфейсов, размещенных в SDK, а также локализованных текстовых полей (localizedTextsиlocalizedBodies) в облачных событиях ИИ-подписей и обзоров от ИИ. -
Поддержка управления
DeviceGroupкак единым объектом через его компоненты, а также проверки участия в группах на отдельных устройствах и пакетной обработки команд для участников группы.
Другие изменения
Известные проблемы
-
После перезапуска камеры ее статус подключения может отображаться как
PARTIAL_ONLINEвместоONLINE. Все функции облачной камеры продолжают работать в обычном режиме, за исключением вывода из эксплуатации Matter.
2026-09-23
Общедоступный выпуск Home API 1.11В этом выпуске исправлены ошибки и улучшено качество общедоступной версии Home APIs Android SDK.
Минимальные версии
- Сервисы Google Play: 26.36.25
- Встроенное ПО Google Hub, Cast, Nest WiFi Pro: 3.78.548779
- Встроенное ПО Google Hub, Cast и всех остальных хабов на основе Cast: 3.79.550760
- Встроенное ПО Google Hub, Fuchsia: 31.20260429.103.8712702
- Встроенное ПО контроллера Google, Google TV Streamer (4K): UTTK.260317.003.
- Android SDK: home.android.sdk_GHP_1_11
- Приложение Google Home: работает с любой версией.
-
Библиотека
androidx.core: работает с любой версией. - Версия Matter: 1.4.1.0
- Версия Matter: экспериментальная поддержка 1.5.0
Важные обновления
-
Начиная с версии 1.11, для Home API требуется Kotlin 2.4.0. Если вы компилируете приложение Home API с более ранней версией Kotlin,
-Xskip-metadata-version-checkиспользуйте параметр компилятора, чтобы подавить ошибки, связанные с метаданными. - Начиная с версии 1.11, чтобы поддерживать последние сопрограммы Kotlin, разработчикам необходимо обновить файл gradle и импортировать библиотеки kotlinx.coroutines. Если этого не сделать, во всех приложениях Kotlin, использующих Home API, возникнет ошибка выполнения.
Новые функции
Другие изменения
2026-09-16
Мы запустили два новых сервера MCP. Home MCP позволяет персональным агентам безопасно взаимодействовать с вашим умным домом, а Home Developer MCP предоставляет документацию из Центра разработчиков Google Home и других ресурсов умного дома для поиска и запросов вашим любимым агентам.
Новые функции
2026-09-16
Пример приложения Android для Home API обновлен для выпуска Home API 1.10.1.
Пример приложения
2026-08-28
Общедоступная версия Home API 1.10.1В этом выпуске исправлены ошибки и улучшено качество общедоступной версии Home APIs Android SDK.
Минимальные версии
- Сервисы Google Play: 26.34.30
- Встроенное ПО Google Hub, Cast, Nest WiFi Pro: 3.78.548779
- Встроенное ПО Google Hub, Cast, все остальные концентраторы на основе Cast: 3.79.547681.
- Встроенное ПО Google Hub, Fuchsia: 31.20260429.103.8712702
- Встроенное ПО контроллера Google, Google TV Streamer (4K): UTTK.260317.003.
- Android SDK: home.android.sdk_GHP_1_10_1
- Приложение Google Home: работает с любой версией.
-
Библиотека
androidx.core: работает с любой версией. - Версия Matter: 1.4.1.0
- Версия Matter: экспериментальная поддержка 1.5.0
Важные обновления
Новые функции
- В Automation API теперь поддерживаются динамические параметры команд.
- В Automation API теперь поддерживается логика if/else.
Другие изменения
2026-08-07
Пример приложения Home API для Android обновлен для выпуска Home API 1.10.
Пример приложения
2026-08-03
Общедоступная версия Home API 1.10В этом выпуске исправлены ошибки и улучшено качество Home APIs Android SDK до уровня GA.
Минимальные версии
- Сервисы Google Play: 26.28.31
- Встроенное ПО Google Hub, Cast, Nest WiFi Pro: 3.78.518349
- Встроенное ПО Google Hub, Cast, все остальные хабы на основе Cast: 3.78.540761
- Встроенное ПО Google Hub, Fuchsia: 30.20260121.103.1602904
- Встроенное ПО контроллера Google, Google TV Streamer (4K): UTTK.260317.003.
- Android SDK: home.android.sdk_GHP_1_10
- Приложение Google Home: работает с любой версией.
-
Библиотека
androidx.core: работает с любой версией. - Версия Matter: 1.4.1.0
- Версия Matter: экспериментальная поддержка 1.5.0
2026-07-09
Поддержка флага forceLaunch прекращена. В приложениях следует перейти на перечисление ForcePermissionFlow, чтобы задать поведение интерфейса запроса согласия.
Предстоящие изменения
-
Устаревший API. Метод
requestPermissions(forceLaunch: Boolean, ...)больше не поддерживается в Android Google Home SDK. -
Шаг переноса. Замените логические флаги на
ForcePermissionFlow.FORCE_LAUNCH(дляtrue) илиForcePermissionFlow.DO_NOT_FORCE_LAUNCH(дляfalse).
2026-07-08
Доступно руководство по пограничным маршрутизаторам для Android.
Новый контент
2026-07-07
Пример приложения Home API для Android обновлен для выпуска Home API 1.9.1.
Пример приложения
2026-06-26
Общедоступная бета-версия Home API 1.9.1В этом выпуске исправлены ошибки и улучшено качество бета-версии Home API Android SDK.
Минимальные версии
- Сервисы Google Play: 26.24.22
- Встроенное ПО Google Hub, Cast, Nest WiFi Pro: 3.78.518349
- Встроенное ПО Google Hub, Cast и всех остальных концентраторов на основе Cast: 3.78.538123
- Встроенное ПО Google Hub, Fuchsia: 30.20260121.103.1602904
- Встроенное ПО Google Hub, Google TV Streamer (4K): UTTK.250729.004 (14748786)
- Android SDK: home.android.sdk_1_9_1.zip
- Приложение Google Home: работает с любой версией.
-
Библиотека
androidx.core: работает с любой версией. - Версия Matter: 1.4.1.0
- Версия Matter: экспериментальная поддержка 1.5.0
Новые функции
- Камера и дверной звонок: статус замены батареи
- Поддержка снимков с камер и дверных звонков для предварительного просмотра при настройке зон слежения и трансляций.
Устраненные известные проблемы
- Ввод в эксплуатацию с помощью быстрого подключения не поддерживается для следующих моделей устройств: Google Nest Cam Outdoor (проводная, 2-го поколения), Google Nest Cam для помещений (проводная, 3-го поколения) и дверной звонок (проводной, 3-го поколения).
2026-06-09
Пример приложения Home APIs для Android обновлен для выпуска Home APIs 1.9.0.
Пример приложения
2026-05-29
Общедоступная бета-версия Home API 1.9В этом выпуске исправлены ошибки и улучшено качество бета-версии Home API Android SDK.
Минимальные версии
- Сервисы Google Play: 26.20.31
- Встроенное ПО Google Hub, Cast, Nest WiFi Pro: 3.78.518349
- Встроенное ПО Google Hub, Cast, все остальные хабы на основе Cast: 3.78.526062
- Встроенное ПО Google Hub, Fuchsia: 30.20260121.103.1602904
- Встроенное ПО Google Hub, Google TV Streamer (4K): UTTK.250729.004 (14748786)
- Android SDK: home.android.sdk_GHP_1_9
- Приложение Google Home: работает с любой версией.
-
Библиотека
androidx.core: работает с любой версией. - Версия Matter: 1.4.1.0
- Версия Matter: экспериментальная поддержка 1.5.0
Новые функции
- Настройки камеры и дверного звонка: тип крепления камеры
- Настройки камеры и дверного звонка: уведомления о посетителях
- Настройки камеры и дверного звонка: качество трансляции
- Быстрые ответы дверного звонка
- Подсказки по выбору дома, позволяющие партнерам заранее выбирать дома в процессе предоставления разрешений
- Поддержка составных устройств в автоматизациях
-
Обновления следующих специальных характеристик Google:
ExtendedFanControl,ExtendedThermostat. -
Обновлены следующие характеристики Matter:
ArmDisarm,FanControl,Thermostat,ThermostatFanControl,ThermostatUserInterfaceConfiguration.
Известные проблемы
- Ввод в эксплуатацию с помощью быстрого подключения не поддерживается для следующих моделей устройств: Google Nest Cam Outdoor (проводная, 2-го поколения), Google Nest Cam для помещений (проводная, 3-го поколения) и дверной звонок (проводной, 3-го поколения).
2026-05-26
Пример приложения Home APIs для Android обновлен для Home APIs версии 1.8.1.
Пример приложения
2026-05-01
Общедоступная бета-версия Home API 1.8.1В этом выпуске исправлены ошибки и улучшено качество бета-версии Home API Android SDK.
Минимальные версии
- Сервисы Google Play: 26.16.31
- Встроенное ПО Google Hub, Cast, Nest WiFi Pro: 3.78.518349
- Встроенное ПО Google Hub, Cast, все остальные хабы на основе Cast: 3.78.526062
- Встроенное ПО Google Hub, Fuchsia: 30.20260121.103.1602802
- Встроенное ПО Google Hub, Google TV Streamer, 4K: UTTK.250729.004
- Android SDK: home.android.sdk_GHP_1_8_1
- Приложение Google Home: 4.8 или более поздняя версия.
-
Библиотека
androidx.core: работает с любой версией. - Версия Matter: 1.4.1.0
- Версия Matter: экспериментальная поддержка 1.5.0
Новые функции
- Типаж Thermostat теперь поддерживает возможности Read/Update, On/Off и Timer.
Устраненные известные проблемы
- Инициализация устройства Matter может завершиться ошибкой.
- Светильник Philips BLE показывает неправильный статус.
- Задержка, вызывающая нестабильность сети и медленный отклик.
Известные проблемы
- Не удается ввести в эксплуатацию некоторые устройства с помощью Google TV Streamer (4K).
- Если в качестве контроллера используется Nest Wifi Pro, Google Nest Hub или Google Nest Hub Max, то в приложении Google Home составные устройства отображаются в виде нескольких карточек.
2026-04-10
Пример приложения Home API для Android обновлен для версии Home API 1.8.
Пример приложения
2026-04-09
Общедоступная бета-версия Home API 1.8В этом выпуске исправлены ошибки и улучшено качество бета-версии Home API Android SDK.
Минимальные версии
- Сервисы Google Play: 26.12.32
- Встроенное ПО Google Hub, Cast, Nest WiFi Pro: 3.78.518349
- Встроенное ПО Google Hub, Cast, все остальные хабы на основе Cast: 3.78.526062
- Встроенное ПО Google Hub, Fuchsia: 29.20251023.103.2101601
- Встроенное ПО Google Hub, Google TV Streamer, 4K: UTTK.250729.004
- Android SDK: home.android.sdk_GHP_1_8_0
- Приложение Google Home: работает с любой версией.
-
Библиотека
androidx.core: работает с любой версией. - Версия Matter: 1.4.1.0
- Версия Matter: экспериментальная поддержка 1.5.0
Новые функции
- Предлагаемые автоматизации в Automations API.
- Поддержка составных устройств в Device API.
- Настройка зон слежения камеры и дверного звонка в Device API.
- Настройка распознавания звуков камерой и дверным звонком в Device API
- Режим записи камеры и дверного звонка (НЗ/запись событий/без истории) в Device API.
Устраненные известные проблемы
- Не удается изменить единицы измерения температуры (C/F) на Google Nest Learning Thermostat (4-е поколение).
- В мобильной версии веб-версии Google Home верхний значок и кнопка "Назад" скрыты заголовком. Пользователи могут не иметь возможности вернуться назад или увидеть ключевые элементы пользовательского интерфейса.
- Концентратор Android TV может неправильно сообщать, что устройства Matter находятся не в сети.
Известные проблемы
- Инициализация устройства Matter может завершиться ошибкой.
2026-03-13
Общедоступная бета-версия Home API 1.7.1В этом выпуске исправлены ошибки и улучшено качество бета-версии Home API Android SDK.
Минимальные версии
- Сервисы Google Play:
- Встроенное ПО Google Hub, Cast, Nest WiFi Pro: 3.78.518349
- Встроенное ПО Google Hub, Cast, все остальные хабы на основе Cast: 3.78.516526
- Встроенное ПО Google Hub, Fuchsia: 29.20251023.103.2201
- Встроенное ПО Google Hub, Google TV Streamer, 4K: UTTK.250729.004
- Android SDK: home.android.sdk_GHP_1_7_1
- Приложение Google Home: 1.7.1
-
Библиотека
androidx.core: работает с любой версией. - Версия Matter: 1.4.1.0
- Версия Matter: экспериментальная поддержка 1.5.0
Новые функции
- Согласие на сбор аналитических данных с камер и дверных звонков в Device API.
- Время последнего подключения камеры и дверного звонка в Device API.
- Состояние подключения камеры и дверного звонка в Device API.
- Атомарные запросы термостата в Device API.
Другие изменения
- Режим без концентратора удален.
Пример приложения
Устраненные известные проблемы
- Для Nest Cam Indoor/Outdoor (с батареей или проводная) и Nest Doorbell (с батареей, 2-е поколение) параметр "Оставшееся время работы от батареи" отсутствует в настройках батареи.
- Настройка длительности звонка игнорируется.
- Светильник Philips BLE ошибочно отображается как подключенный к сети, даже если он не подключен.
Известные проблемы
- Не удается изменить единицы измерения температуры (C/F) на Google Nest Learning Thermostat (4-е поколение).
- Возможны задержки в работе сети и отклике устройства.
- В мобильной версии веб-версии Google Home верхний значок и кнопка "Назад" скрыты заголовком. Пользователи могут не иметь возможности вернуться назад или увидеть ключевые элементы пользовательского интерфейса.
- После настройки в режиме федерации Hub может зависнуть в состоянии "Подключение…".
- Инициализация устройства Matter может завершиться ошибкой.
- Устройства Matter могут ошибочно отображаться как офлайн в хабе Android TV.
- В поле "Текущая версия ПО камеры" может быть указана неверная версия.
- Ползунок в интерфейсе термостата показывает температуру за пределами диапазона.
- Если задана продолжительность звонка, устройство не звонит в течение указанного времени.
2026-02-13
Пример приложения Home APIs для Android обновлен для Home APIs версии 1.7.
Пример приложения
2026-02-09
Общедоступная бета-версия Home API 1.7В этом выпуске исправлены ошибки и улучшено качество бета-версии Home API Android SDK.
Минимальные версии
- Сервисы Google Play: 26.02.34
- Встроенное ПО Google Hub, Cast, Nest WiFi Pro: 3.76.508025
- Встроенное ПО Google Hub, Cast и всех остальных хабов на основе Cast: 3.77.510748.
- Встроенное ПО Google Hub, Fuchsia: 29.20251023.103.2100
- Встроенное ПО Google Hub, 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
- Версия Matter: экспериментальная поддержка 1.5.0
Новые функции
- Локальные автоматизации. В зависимости от условий, таких как подключение, типы устройств и характеристики, некоторые автоматизации теперь могут выполняться локально в Automations API.
- Включение OOBE камеры в приложениях в Device API.
- Темы звонков для камер и дверных звонков в Device API.
- Автоматический режим энергосбережения для камер и дверных звонков в Device API.
- Настройки расхода заряда батареи камеры и дверного звонка в Device API.
- Состояние зарядки батареи камеры и дверного звонка в Device API.
- Уровень заряда батареи камеры и дверного звонка в Device API.
- Серийный номер камеры и дверного звонка в Device API.
- Модель камеры и дверного звонка в Device API.
- Версия ПО камеры и дверного звонка в Device API.
- Пользовательский API ключ-значение в Device API.
- Запрос разрешений позволяет приложению определить, каким типам устройств пользователь предоставил доступ в Permissions API.
Другие изменения
-
Код
HomeException.unsupportedзаменен наHomeException.unimplemented, чтобы соответствовать стандартным кодам ошибок. - В версии 1.7 изменен генератор упакованного кода для специальных признаков. Разработчикам, у которых есть специальные признаки, нужно перекомпилировать их после интеграции SDK версии 1.7.
Устраненные известные проблемы
-
History API всегда возвращает
nextPageToken, что приводит к бесконечному циклу. - При попытке войти в новый аккаунт возникает ошибка "Пользователь отменил процесс предоставления разрешений".
Известные проблемы
- Для Nest Cam Indoor/Outdoor (с батареей или проводная) и Nest Doorbell (с батареей, 2-е поколение) параметр "Оставшееся время работы от батареи" отсутствует в настройках батареи.
- Настройка длительности звонка игнорируется.
-
Светильник Philips BLE ошибочно отображается как подключенный к сети, даже если он не подключен. Решение. Не полагайтесь только на статус онлайн для типа устройства умного дома. Вместо этого используйте карту Target Device State Service (TDSS) для устройств с источником
LOCAL_SYNC.
2025-12-22
Общедоступная бета-версия Home API 1.6В этом выпуске исправлены ошибки и улучшено качество бета-версии Home API Android SDK.
Минимальные версии
- Сервисы Google Play: 25.47.30
- Встроенное ПО Google Hub, Cast, Nest WiFi Pro: 3.75.479819
- Встроенное ПО контроллера Google, Cast, все остальные контроллеры на базе Cast: 3.77.505721
- Встроенное ПО Google Hub, Fuchsia: 28.20250723.103.2100300
- Встроенное ПО Google Hub, 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
Новые функции
- Поддержка типажа погоды в Automation API. Добавлена поддержка признака погоды в триггерах и условиях автоматизации.
- Поддержка дополнительных возможностей камер и дверных звонков. Новые настройки: ночное видение, светодиодный индикатор состояния, область просмотра, ориентация, чувствительность, продолжительность события, звонок.
- Вход в аккаунт Google, инициированный приложением, для упрощения UX и устранения проверок активных пользователей.
- Режим без контроллера позволяет пользователям подключать определенные устройства Matter и управлять ими без отдельного контроллера.
- Hub Activation API для поиска и активации концентраторов.
Другие изменения
- В примере приложения для Android добавлены настройки камеры, стандартные автоматизации, а также поддержка вентилятора и колонки.
Известные проблемы
- Элементы управления устройством перестают работать после длительного использования. Решение: перезапустите контроллер.
- Инициализация устройства Matter может завершиться ошибкой.
- При попытке добавить новый аккаунт в примере приложения для Android появляется ошибка "Пользователь отменил процесс предоставления разрешений". Временное решение: добавляйте аккаунты Google в настройках устройства Android.
- Проводная камера видеонаблюдения Walmart onn, введенная в эксплуатацию с помощью Android Home APIs SDK, не может вести прямую трансляцию через приложение Google Home.
- Камеры, введенные в эксплуатацию в приложениях Home API, не могут запускать трансляции из приложения Google Home.
2025-10-23
Общедоступная бета-версия Home API 1.5.1В этом выпуске исправлены ошибки и улучшено качество бета-версии Home API Android SDK.
Минимальные версии
- Сервисы Google Play: 25.41.30.
- Встроенное ПО Google Hub, Cast: 3.76.495998
- Встроенное ПО Google Hub, Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_5_1
- Приложение Google Home: работает с любой версией.
-
Библиотека
androidx.core: работает с любой версией. - Версия Matter: 1.4.1.0
Новые функции
Другие изменения
- В примере приложения для Android добавлена поддержка типа устройства "Дверной звонок" (OnOff, Livestream, двусторонняя связь) и реализация Hub Activation API.
Устраненные известные проблемы
- Пример приложения неправильно показывает статус устройства в представлении "Устройство".
2025-09-26
Общедоступная бета-версия Home API 1.5.0В этом выпуске добавлена поддержка камер, исправлены ошибки и улучшено качество бета-версии Home APIs Android SDK.
Минимальные версии
- Сервисы Google Play: 25.37.31
- Встроенное ПО Google Hub, Cast: 3.76.492738
- Встроенное ПО Google Hub, Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_5
- Приложение Google Home: работает с любой версией.
-
Библиотека
androidx.core: работает с любой версией. - Версия Matter: 1.4.1.0
Новые функции
- Триггеры, условия и действия теперь принимают структуры Matter в качестве параметров в Automation API.
- В Device API добавлен тип устройства "Камера" (прямая трансляция, двусторонняя связь, запуск и остановка записи).
Другие изменения
-
В примере приложения для Android добавлена поддержка камеры, ввода в эксплуатацию с несколькими администраторами и автоматизации
OnOff.
Устраненные известные проблемы
- Если принудительно удалить активный хаб, в течение пяти минут управлять некоторыми устройствами будет нельзя. Через пять минут возможность управлять устройствами восстанавливается.
- После того как пользователь выбирает цвет из набора или с помощью палитры цветовой температуры, Extended Color Light не обновляет цвет.
Известные проблемы
- При переключении с Wi-Fi на мобильную сеть может увеличиться задержка управления устройствами.
- В примере приложения может не работать управление вентиляторами, подключенными через облако.
2025-08-29
Общедоступная бета-версия Home API 1.4.1В этом выпуске исправлены ошибки и улучшено качество бета-версии Home API Android SDK.
Минимальные версии
- Сервисы Google Play: 25.33.32
- Встроенное ПО Google Hub, Cast: 3.76.495998
- Встроенное ПО Google Hub, Fuchsia: 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
Общедоступная бета-версия Home API 1.4.0В этом выпуске исправлены ошибки и улучшено качество бета-версии Home API Android SDK.
Минимальные версии
- Сервисы Google Play: 25.28.34
- Встроенное ПО Google Hub, Cast: 3.76.486931.
- Встроенное ПО Google Hub, Fuchsia: 27.20250422.103.3600
- Android SDK: home.android.sdk_1_4_0
- Приложение Google Home: работает с любой версией.
-
Библиотека
androidx.core: работает с любой версией. - Версия Matter: 1.4.0.0
Новые функции
- В Automation API можно ограничить количество выполнений автоматизации.
- Возможность программно удалять устройства Matter в Device API.
-
Удалены устаревшие элементы
HomeDevice(trait(),isInRoom,isInStructure). -
Home.hasPermissions()теперь включает доступ к структуре OAuth и разрешения для приложений.
Другие изменения
- В примере приложения для Android удаляются устройства, поддерживающие только Matter, переименовываются устройства и заменяются устаревшие вызовы API.
Устраненные известные проблемы
- Роботы-пылесосы, которые были пристыкованы, не регистрируют состояние "Пристыкован".
Известные проблемы
- После выхода из аккаунта на телефоне и повторного входа в него приложение Home API не может управлять устройствами. Решение: закройте приложение и подождите не менее 10 секунд.
2025-06-26
Общедоступная бета-версия Home API 1.3.2В этом выпуске исправлены ошибки и улучшено качество бета-версии Home APIs Android SDK.
Минимальные версии
- Сервисы Google Play: 25.23.31.
- Встроенное ПО Google Hub, Cast, Google Home, Google Home Mini и Google Nest Mini: 3.75.468362
- Встроенное ПО Google Hub, Cast, Google Nest Аудио: 3.75.476451
- Встроенное ПО Google Hub, Fuchsia: 26.20250116.103.2900
- Android SDK: home.android.sdk_1_3_2
- Приложение Google Home: работает с любой версией.
-
Библиотека
androidx.core: работает с любой версией. - Версия Matter: 1.4.0.0
Новые функции
-
Артефакт SDK разделен на два отдельных артефакта: фреймворк Home API SDK (
play-services-home-17.0.0.aar) и SDK traits and device types (play-services-home-types-17.0.0.aar). Начиная с этого выпуска разработчикам необходимо включать оба артефакта в пути к библиотекам времени компиляции и выполнения своего проекта.
Другие изменения
- Дополнения в примере приложения для Android: пользователи могут отключать приложение и отзывать у него разрешения.
-
Дополнения в примере приложения для Android: обновлены артефакты SDK, чтобы включить
play-services-home-17.0.0иplay-services-home-types-17.0.0.
Известные проблемы
- Роботы-пылесосы, которые были пристыкованы, не регистрируют состояние "Пристыкован".
2025-06-05
Общедоступная бета-версия Home API 1.3.1В этом выпуске исправлены ошибки и улучшено качество бета-версии Home APIs Android SDK.
Минимальные версии
- Сервисы Google Play: 25.19.32
- Встроенное ПО Google Hub, Cast: 3.75.468222
- Встроенное ПО Google Hub, Fuchsia: 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, и позволяет использовать переключатели в качестве условий запуска автоматизации. -
В типаже
ExtendedDoorLockесть критическое изменение: тип данных поляuser_idизменен сStringнаLong. Приложения, в которых используется этот признак, нужно перекомпилировать.
Другие изменения
- В примере приложения для Android добавлены функции, которые регистрируют состояние домов, устройств, типов, типажей и автоматизаций, чтобы упростить отладку.
Устраненные известные проблемы
-
Приложение Google Home аварийно завершает работу с ошибкой
FailedPreconditionExceptionпри создании автоматизаций, если в нем не задано местоположение дома. -
В примере приложения для Android устройство с
connectivityStatePARTIALLY_ONLINEранее отображалось как офлайн. Теперь это состояние называется "Онлайн".
Известные проблемы
- В примере приложения для Android кнопка "Создать автоматизацию" иногда срабатывает только после нескольких нажатий.
2025-05-12
Общедоступная бета-версия Home API 1.3В этом выпуске исправлены ошибки и улучшено качество бета-версии Home APIs Android SDK.
Минимальные версии
- Сервисы Google Play: 25.16.33
- Встроенное ПО Google Hub, Cast: 3.75.468222
- Встроенное ПО Google Hub, Fuchsia: 26.20250116.103.2201
- Android SDK: home.android.sdk_202504_EAP_1_3_RC00
- Приложение Google Home: работает с любой версией.
-
Библиотека
androidx.core: работает с любой версией. - Версия Matter: 1.4.0.0
Новые функции
-
Добавлена поддержка повторяющихся запланированных событий в Automation API. Теперь разработчики могут создавать автоматизации, которые запускаются периодически на основе времени, солнечного времени и условий календаря, используя выражения
cron. - Добавлена возможность переименовывать устройства в Device API.
- Добавлена возможность переименовывать комнаты в Structure API.
Устраненные известные проблемы
- При переключении с Wi-Fi на мобильную сеть может увеличиться задержка управления устройствами.
- После сброса настроек контроллера устройства могут отображаться как офлайн.
Известные проблемы
2025-04-09
Общедоступная бета-версия Home API 1.2.1В этом выпуске исправлены ошибки и улучшено качество бета-версии Home APIs Android SDK.
Минимальные версии
- Сервисы Google Play: 25.09.33
- Минимальные версии встроенного ПО для хабов Google:
- Cast: 3.75.468222
- Fuchsia: 24.20241009.103.19006011
- Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
- Приложение Google Home: работает с любой версией.
- Библиотека
androidx.core: 1.10.0 - Версия Matter: 1.4.0.0.
Новые функции
- Повышена производительность при загрузке объектов из Home Graph.
- Automation API
- Добавлена поддержка фильтров объектов, которые позволяют автоматизациям динамически выбирать устройства на основе критериев, указанных в автоматизации.
- Device API
- Информация об устройствах, подключенных к облаку, теперь доступна в
BasicInformationTrait.
- Информация об устройствах, подключенных к облаку, теперь доступна в
Известные проблемы
- При переключении с Wi-Fi на мобильную сеть задержка в управлении устройствами может увеличиться.
- После сброса настроек контроллера устройства могут отображаться как офлайн.
Устраненные известные проблемы
- Если Discovery API вызывается до инициализации или до ее завершения, выдается ошибка
HomeExceptionс кодомcode 14: UNKNOWNи сообщением "Маршрут не найден". - В среде, содержащей несколько структур и несколько пользователей, переключение между структурами и пользователями может привести к тому, что устройства не будут возвращены.
2025-03-14
Общедоступная бета-версия Home API 1.2.0В этом выпуске исправлены ошибки и улучшено качество бета-версии Home APIs Android SDK.
Минимальные версии
- Минимальная версия сервисов Google Play: 25.06.32.
- Минимальные версии встроенного ПО для контроллеров Google:
- Версия Cast: 3.75.456944
- Минимальная версия Fuchsia: 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
- Примечание. Предварительные типы устройств и кластеры Matter не поддерживаются.
Новые функции
- Automation API:
- Поддержка диапазонов дат и неполных дат в условиях автоматизации. Подробнее о том, как использовать даты с оператором between…
- В предыдущих выпусках Discovery API возвращал
NumberSetConstraintдля некоторых полей битовой карты, когда должен был возвращатьBitmapConstraint. Теперь эти поля возвращаютBitmapConstraint, как и ожидалось. Это ограничение распространяется на битовые картыoptionsMaskиoptionsOverrideв командах признакаLevelControl.
Известные проблемы
- При переключении с Wi-Fi на мобильную сеть задержка в управлении устройствами может увеличиться.
- После сброса настроек контроллера устройства могут отображаться как офлайн.
- Если Discovery API вызывается до инициализации или до ее завершения, выдается ошибка
HomeExceptionс кодомcode 14: UNKNOWNи сообщением "Маршрут не найден".- Решение: вызывайте Discovery API, только когда вам действительно нужны кандидаты для автоматизации. Не выполняйте упреждающий запрос и кеширование объектов-кандидатов. Прежде чем вызывать методы Discovery API для объекта, проверьте, подключен ли он к интернету.
- В среде, содержащей несколько структур и несколько пользователей, переключение между структурами и пользователями может привести к тому, что устройства не будут возвращены.
Устраненные известные проблемы
- При первом вызове
HomeManager.structures()после запуска приложение Home API получает ноль домов, даже если их несколько. Из-за этого может показаться, что с аккаунтом Google не связано ни одного дома. - При загрузке, создании и редактировании автоматизаций пользователи могут столкнуться с длительным временем ожидания.
- Пользователям, которые начинают настройку в приложении "Камера", нужно отсканировать QR-код дважды, чтобы завершить ввод в эксплуатацию Matter.
- Если в доме больше 200 устройств, Discovery API может не вернуть ни одного кандидата.
2025-01-29
Общедоступная бета-версия Home API 1.1.0В этом выпуске исправлены ошибки и улучшено качество бета-версии Home APIs Android SDK.
Минимальные версии
- Минимальная версия сервисов Google Play: 25.02.32.
- Минимальные версии встроенного ПО для контроллеров Google:
- Версия Cast: 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. - Версия Matter:
1.3.0.0
- Примечание. Предварительные типы устройств и кластеры Matter не поддерживаются.
Новые функции
- Streaming API:
- Предоставляет потоки событий, которые уведомляют о добавлении, изменении и удалении структур, комнат и устройств.
- Подробнее о том, как подписаться на события отношений между объектами…
- Batching API (экспериментальная функция):
- Позволяет разработчику отправлять несколько команд в пакетах, которые выполняются одновременно.
- Подробнее о том, как отправлять несколько команд одновременно…
Известные проблемы
- При загрузке, создании и редактировании автоматизаций пользователи могут столкнуться с длительным временем ожидания.
- Пользователям, которые начинают настройку в приложении "Камера", нужно отсканировать QR-код дважды, чтобы завершить ввод в эксплуатацию Matter.
- В доме, где больше 200 устройств, Discovery API может не вернуть ни одного кандидата.
Устраненные известные проблемы
- При попытке сменить аккаунт Google может возникнуть ошибка.
- Устройства Google TV могут не работать с автоматизациями, в которых используется свойство
MediaPlayback. - В доме, где есть только контроллер Google:
- Устройства Matter могут отображаться как офлайн в приложении Google Home.
- Google Ассистент не может управлять устройствами Matter.
- Умные дисплеи не могут управлять устройствами Matter или показывать их статус.
- Для некоторых устройств приложение не всегда может отражать точное состояние, и ваше приложение может сообщать о состоянии, отличном от того, о котором сообщает приложение Google, например приложение Google Home. Обычно это связано с тем, что устройства не сообщают о своем состоянии Google.
- Решение. Проверьте состояние с помощью приложения Google.
2025-01-14
Обновлены рекомендации по инициализации Home API.
Мы уточнили, что экземпляр Home должен быть инициализирован как контекстный синглтон. Это позволит избежать ошибок, связанных с недействительными сеансами, и повысить удобство работы с приложением.
2025-01-07
Общедоступная бета-версия Home APIВо время публичного бета-тестирования все разработчики могут начать создавать и тестировать свои приложения.
В этом выпуске исправлены ошибки и улучшено качество бета-версии Home APIs Android SDK, в том числе поддержка устройств Google Nest Audio и Google TV.
Минимальные версии
- Минимальная версия сервисов Google Play: 24.45.34.
- Минимальные версии встроенного ПО для хабов Google:
- Версия Cast: 3.74.444798
- Минимальная версия Fuchsia: 22.20240805.103.161.
- Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
- Минимальная версия приложения Google Home: работает с любой версией.
- Минимальная версия библиотеки
androidx.core: 1.10.0. - Версия Matter:
1.3.0.0
- Примечание. Предварительные типы устройств и кластеры Matter не поддерживаются.
Известные проблемы
- При попытке сменить аккаунт Google может возникнуть ошибка.
- Решение: повторно запустите процесс предоставления разрешений или перезапустите приложение.
- Устройства Google TV могут не работать в автоматизациях, использующих свойство
MediaPlayback. - В доме, где есть только контроллер Google:
- Устройства Matter могут отображаться как офлайн в приложении Google Home.
- Google Ассистент не может управлять устройствами Matter.
- Умные дисплеи не могут управлять устройствами Matter или показывать их статус.
- Для некоторых устройств приложение не всегда может отражать точное состояние, и ваше приложение может сообщать о состоянии, отличном от того, о котором сообщает приложение Google, например приложение Google Home (GHA). Обычно это связано с тем, что устройства не отправляют отчеты о состоянии в Google.
- Решение. Проверьте состояние с помощью приложения Google.
Устраненные известные проблемы
- Если свернуть приложение во время ввода в эксплуатацию, может произойти сбой.
- Решение. Используйте
suppressHalfSheetNotification()API, чтобы отключить уведомления на пол-экрана, когда в приложении используется Commissioning API.
- Решение. Используйте
- Проблема на стороне сервера может помешать работе условий "Окей, Google" в автоматизациях.
- Если контроллер на базе Fuchsia, в структуре которого нет устройств Matter, бездействует более трех часов, то при вводе в эксплуатацию первого устройства Matter оно будет офлайн.
- После сброса настроек хаба команды, отправленные на недавно введенные в эксплуатацию устройства, могут не выполняться, даже если устройства находятся в сети.