2026-09-23
Главная API GA-версия 1.11В этом релизе исправлены ошибки и улучшено качество общедоступной версии Android SDK Home APIs.
Минимальные версии
- Сервисы 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 Hub, 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, использующих API Home, возникнет блокирующая ошибка выполнения.
Новые функции
Другие важные изменения
2026-09-16
Мы запустили два новых сервера MCP. Home MCP позволяет персональным агентам безопасно взаимодействовать с вашим умным домом, а Home Developer MCP предоставляет вашим любимым агентам доступ к документации из Home Developer Center и другим ресурсам по умному дому для поиска и выполнения запросов.
Новые функции
2026-09-16
Приложение Home APIs Sample App для Android обновлено для версии Home APIs 1.10.1.
Пример приложения
2026-08-28
Главная API GA-версия 1.10.1В этом релизе исправлены ошибки и улучшено качество общедоступной версии Android SDK Home APIs.
Минимальные версии
- Сервисы 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 Hub, 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
Важные обновления
Новые функции
- В API автоматизации теперь поддерживаются динамические параметры команд.
- В API автоматизации теперь поддерживается логика if/else.
Другие важные изменения
2026-08-07
Приложение Home APIs для Android было обновлено для версии Home APIs 1.10.
Пример приложения
2026-08-03
Главная API GA-версия 1.10В этом релизе исправлены ошибки, а также улучшено качество Android SDK Home APIs до уровня общедоступной версии.
Минимальные версии
- Сервисы 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 Hub, 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
Руководство пользователя маршрутизатора Border Router для Android теперь доступно.
Новый контент
2026-07-07
Приложение Home APIs для Android было обновлено для версии Home APIs 1.9.1.
Пример приложения
2026-06-26
Главная API Публичная бета-версия 1.9.1В этом релизе исправлены ошибки и улучшено качество бета-версии Android SDK Home APIs.
Минимальные версии
- Сервисы 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
Новые функции
- Камера и дверной звонок: состояние замены батареи.
- Поддержка создания снимков экрана камеры и дверного звонка для использования в качестве предварительного просмотра во время настройки зоны активности и режима просмотра в реальном времени.
Исправлены известные проблемы
- Функция быстрого сопряжения (Fast Pair) не поддерживается для устройств Google Nest Cam Outdoor (проводное подключение, 2-е поколение), Google Nest Cam Indoor (проводное подключение, 3-е поколение) и Doorbell (проводное подключение, 3-е поколение).
2026-06-09
Приложение Home APIs для Android было обновлено для версии Home APIs 1.9.0.
Пример приложения
2026-05-29
Главная API Публичная бета-версия 1.9В этом релизе исправлены ошибки и улучшено качество бета-версии Android SDK Home APIs.
Минимальные версии
- Сервисы 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
Известные проблемы
- Функция быстрого сопряжения (Fast Pair) не поддерживается для устройств Google Nest Cam Outdoor (проводное подключение, 2-е поколение), Google Nest Cam Indoor (проводное подключение, 3-е поколение) и Doorbell (проводное подключение, 3-е поколение).
2026-05-26
Приложение Home APIs Sample App для Android обновлено для версии Home APIs 1.8.1.
Пример приложения
2026-05-01
Главная API Публичная бета-версия 1.8.1В этом релизе исправлены ошибки и улучшено качество бета-версии Android SDK Home APIs.
Минимальные версии
- Сервисы 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
Новые функции
- Функция термостата теперь поддерживает чтение/обновление, включение/выключение и таймер.
Исправлены известные проблемы
- Ввод устройства Matter в эксплуатацию может завершиться неудачей.
- Индикатор Philips BLE не отображает правильное состояние.
- Задержки приводят к нестабильности сети и замедлению времени отклика.
Известные проблемы
- Не удается подключить некоторые устройства с помощью Google TV Streamer, 4K.
- Когда в качестве центрального устройства используется Nest Wifi Pro, Google Nest Hub или Google Nest Hub Max, приложение Google Home отображает устройства, состоящие из нескольких элементов, в виде нескольких плиток.
2026-04-10
Приложение Home APIs для Android было обновлено для версии Home APIs 1.8.
Пример приложения
2026-04-09
Главная API Публичная бета-версия 1.8В этом релизе исправлены ошибки и улучшено качество бета-версии Android SDK Home APIs.
Минимальные версии
- Сервисы 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
Новые функции
- Предложенные варианты автоматизации в API автоматизации.
- Поддержка многокомпонентных устройств в Device API.
- Настройка зоны активности камеры и дверного звонка в API устройства.
- Настройка обнаружения звука камеры и дверного звонка в API устройства.
- Режим записи с камеры и дверного звонка (CVR/EVR/Без истории) в API устройства.
Исправлены известные проблемы
- Невозможно изменить единицы измерения температуры термостата Google Nest Learning Thermostat (4-го поколения) (в градусах Цельсия/Фаренгейта).
- В мобильной версии веб-версии Google Home верхняя иконка и кнопка «Назад» скрыты за заголовком. Пользователи могут не иметь возможности вернуться назад или увидеть ключевые элементы пользовательского интерфейса.
- В Android TV-хабе может некорректно отображаться состояние устройств Matter как "вне сети".
Известные проблемы
- Ввод устройства Matter в эксплуатацию может завершиться неудачей.
2026-03-13
Главная API Публичная бета-версия 1.7.1В этом релизе исправлены ошибки и улучшено качество бета-версии Android SDK Home APIs.
Минимальные версии
- Сервисы 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
Новые функции
- Функция анализа данных с камер и дверных звонков активируется через API устройства.
- Время последнего подключения камеры и дверного звонка указано в API устройства.
- Состояние подключения камеры и дверного звонка в Device API.
- Атомарные запросы термостата в API устройства.
Другие важные изменения
- Режим без концентратора удален.
Пример приложения
Исправлены известные проблемы
- Для камер Nest Cam Indoor/Outdoor (с батарейным питанием или проводным подключением) и дверных звонков Nest Doorbell (с батарейным питанием, 2-го поколения) опция «Оставшееся время работы от батареи» отсутствует в настройках батареи.
- Настройка продолжительности звонка игнорируется.
- Индикатор Philips BLE некорректно отображается как "В сети", даже когда устройство фактически находится в автономном режиме.
Известные проблемы
- Невозможно изменить единицы измерения температуры термостата Google Nest Learning Thermostat (4-го поколения) (в градусах Цельсия/Фаренгейта).
- Возможны задержки в обеспечении стабильности сети и быстродействии устройств.
- В мобильной версии Google Home для веб-браузера верхняя иконка и кнопка «Назад» скрыты за заголовком. Пользователи могут не иметь возможности вернуться назад или увидеть ключевые элементы пользовательского интерфейса.
- После первоначальной настройки федеративного режима концентратор может зависнуть в состоянии "Подключение...".
- Ввод устройства Matter в эксплуатацию может завершиться неудачей.
- В центре управления Android TV устройства Matter могут некорректно отображаться как находящиеся в автономном режиме.
- В разделе «Текущая версия программного обеспечения камеры» может не отображаться правильная версия программного обеспечения.
- Ползунок в пользовательском интерфейсе термостата отображает температуры, выходящие за пределы допустимого диапазона.
- Если параметр «Длительность звонка» установлен, устройство не будет издавать звуковой сигнал в течение указанного времени.
2026-02-13
Приложение Home APIs для Android было обновлено для версии Home APIs 1.7.
Пример приложения
2026-02-09
Главная API Публичная бета-версия 1.7В этом релизе исправлены ошибки и улучшено качество бета-версии Android SDK Home APIs.
Минимальные версии
- Сервисы 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
Новые функции
- Локальные автоматизации: в зависимости от таких условий, как подключение к сети, типы и характеристики устройств, некоторые автоматизации теперь могут выполняться локально через API автоматизации.
- Включение функции Camera Out-of-Box Experience (OOBE) в приложениях через Device API.
- Темы оформления камер и дверных звонков в Device API.
- Автоматическая экономия заряда батареи камеры и дверного звонка в API устройства.
- Настройки использования батареи камеры и дверного звонка в API устройства.
- Состояние зарядки аккумуляторов камеры и дверного звонка в API устройства.
- Уровень заряда батареи камеры и дверного звонка в API устройства.
- Серийный номер камеры и дверного звонка в API устройства.
- Модель камеры и дверного звонка в API устройства.
- Версия программного обеспечения камеры и дверного звонка в API устройства.
- Пользовательский API ключ-значение в API устройства.
- Запрос разрешений позволяет приложению определить, каким типам устройств пользователь предоставил доступ через API разрешений.
Другие важные изменения
- В соответствии со стандартными кодами ошибок,
HomeException.unsupportedзаменено наHomeException.unimplemented. - В версии 1.7 изменился генератор кода для пользовательских трейтов. Разработчикам, использующим пользовательские трейты, необходимо перекомпилировать их после интеграции SDK версии 1.7.
Исправлены известные проблемы
- 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, Cast, Nest WiFi Pro: 3.75.479819
- Прошивка Google Hub, 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
Новые функции
- Поддержка параметра «Погода» в API автоматизации. Добавлена поддержка параметра «Погода» в начальных условиях и сценариях автоматизации.
- Поддержка расширенных возможностей камер и дверных звонков: новые настройки (ночное видение, светодиодный индикатор состояния, область просмотра, ориентация, чувствительность, длительность события, звуковой сигнал).
- Инициируемый приложением вход через Google упрощает пользовательский интерфейс и исключает необходимость активной проверки пользователя.
- Режим без концентратора позволяет пользователям подключать и управлять некоторыми устройствами Matter без использования автономного концентратора.
- API активации хабов для обнаружения и активации хабов.
Другие важные изменения
- В демонстрационное приложение для Android добавлены настройки камеры, предустановленные сценарии автоматизации, а также поддержка вентиляторов и динамиков.
Известные проблемы
- Элементы управления устройством перестают работать после длительного использования. Временное решение: перезагрузите хаб.
- Ввод в эксплуатацию устройства, работающего с материей, может завершиться неудачей.
- Ошибка «Пользователь отменил поток разрешений» появляется при попытке добавить новую учетную запись в демонстрационном приложении для Android. Решение: добавляйте учетные записи Google через настройки устройства Android.
- Проводная камера видеонаблюдения Walmart onn, настроенная с использованием SDK Android Home API, не может вести прямую трансляцию через приложение Google Home.
- Камеры, подключенные к приложениям Home API, не могут запускать прямые трансляции из приложения Google Home.
2025-10-23
Главная API Публичная бета-версия 1.5.1В этом релизе исправлены ошибки и улучшено качество бета-версии Android SDK Home APIs.
Минимальные версии
- Сервисы 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 добавлена поддержка типов дверных звонков (вкл/выкл, прямая трансляция, двусторонняя связь) и реализован API активации хаба.
Исправлены известные проблемы
- В демонстрационном приложении статус устройства отображается некорректно в разделе «Устройство».
2025-09-26
Главная API Публичная бета-версия 1.5.0В этом релизе добавлена поддержка устройств с камерой, исправлены ошибки и улучшено качество бета-версии Android SDK Home APIs.
Минимальные версии
- Сервисы 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
Новые функции
- Теперь в API автоматизации параметры запускающих функций, условий и действий принимают структуры Matter.
- В API устройств добавлен тип камеры (прямая трансляция, двусторонняя связь, запуск/остановка записи).
Другие важные изменения
- В демонстрационное приложение для Android добавлена поддержка камеры, многопользовательской настройки администратором и предустановленных автоматических
OnOff.
Исправлены известные проблемы
- При принудительном удалении текущего активного концентратора в течение пяти минут управление некоторыми устройствами становится невозможным. По истечении пяти минут возможность управления устройствами восстанавливается.
- После того, как пользователь выберет цвет из предустановленного набора или из палитры цветовой температуры, функция Extended Color Light не обновит цвет.
Известные проблемы
- При переключении с Wi-Fi на мобильную сеть может наблюдаться увеличение задержки управления устройством.
- В демонстрационном приложении может не работать управление вентиляторами различных типов с использованием облачных технологий.
2025-08-29
Главная API Публичная бета-версия 1.4.1В этом релизе исправлены ошибки и улучшено качество бета-версии Android SDK Home APIs.
Минимальные версии
- Сервисы 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
Главная API Публичная бета-версия 1.4.0В этом релизе исправлены ошибки и улучшено качество бета-версии Android SDK Home APIs.
Минимальные версии
- Сервисы 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
Новые функции
- В API автоматизации можно ограничить количество выполнений автоматизации до конечного числа раз.
- Возможность программного удаления устройства Matter в Device API.
- Удалены устаревшие члены
HomeDevice(trait(),isInRoom,isInStructure). - Теперь
Home.hasPermissions()включает в себя как доступ к структуре OAuth, так и предоставление разрешений приложениям.
Другие важные изменения
- В демонстрационном приложении для Android удаляются устройства, содержащие только данные Matter, переименовываются устройства и заменяются устаревшие вызовы API.
Исправлены известные проблемы
- Вакуумные устройства, которые были подключены к док-станции, не регистрируют состояние "Подключено".
Известные проблемы
- После выхода из учетной записи на телефоне и повторного входа приложение Home APIs не может управлять устройствами. Решение: закройте приложение и подождите не менее 10 секунд.
2025-06-26
Главная API Публичная бета-версия 1.3.2В этом релизе исправлены ошибки и улучшено качество бета-версии Android SDK Home APIs.
Минимальные версии
- Сервисы Google Play: 25.23.31
- Прошивка Google Hub для Cast, Google Home, Google Home Mini и Google Nest Mini: 3.75.468362
- Прошивка Google Hub, Cast, Google Nest Audio: 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 APIs SDK (
play-services-home-17.0.0.aar) и характеристики SDK и типы устройств (play-services-home-types-17.0.0.aar). Начиная с этого релиза, разработчикам необходимо включить оба артефакта в пути к библиотекам во время компиляции и выполнения своего проекта.
Другие важные изменения
- В демонстрационное приложение для Android добавлена функция: пользователи могут отключать и отзывать разрешения в приложении.
- В Android Sample App добавлены следующие изменения: обновлены артефакты 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, 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 Switch, и позволяет переключателям запускать сценарии автоматизации. - В трейте
ExtendedDoorLockпроизошло критическое изменение: тип данных поляuser_idбыл изменен соStringнаLong. Приложения, использующие этот трейт, необходимо перекомпилировать.
Другие важные изменения
- В демонстрационное приложение для Android добавлены функции для регистрации состояния структур, устройств, типов, характеристик и автоматизации, что упрощает отладку.
Исправлены известные проблемы
- Приложение Google Home аварийно завершает работу с ошибкой
FailedPreconditionExceptionпри создании автоматизаций, если местоположение дома не указано в приложении Google Home. - В демонстрационном приложении для Android устройство с
connectivityStatePARTIALLY_ONLINEранее отображалось как находящееся в автономном режиме. Теперь это состояние отображается как «в сети».
Известные проблемы
- В демонстрационном приложении для Android кнопка «Создать автоматизацию» иногда требует нескольких нажатий для срабатывания.
2025-05-12
Главная API Публичная бета-версия 1.3В этом релизе исправлены ошибки и улучшено качество бета-версии Android SDK Home APIs.
Минимальные версии
- Сервисы 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
Новые функции
- В API автоматизации добавлена поддержка запуска повторяющихся запланированных событий, что позволяет разработчикам создавать автоматизации, которые запускаются периодически на основе времени по часам, солнечного времени и календарных условий с помощью выражений
cron. - Добавлена возможность переименовывать устройства в Device API.
- Добавлена возможность переименовывать комнаты в Structure API.
Исправлены известные проблемы
- При переключении с 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
Новые функции
- Улучшена производительность при загрузке объектов из главного графа.
- 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
- Примечание: Временные типы устройств и кластеры не поддерживаются.
Новые функции
- API потоковой передачи:
- Предоставляет потоки событий, уведомляющие о добавлении, изменении и удалении конструкций, помещений и устройств.
- См. раздел «Подписка на события, связанные с сущностями» .
- API для пакетной обработки (экспериментальная версия):
- Позволяет разработчику отправлять несколько команд пакетами, которые выполняются одновременно.
- См. раздел «Отправка нескольких команд одновременно» .
Известные проблемы
- При загрузке, создании и редактировании автоматизаций пользователи могут сталкиваться с длительным временем ожидания.
- Пользователям, запускающим процесс настройки из приложения «Камера», необходимо дважды отсканировать 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 в вашем приложении.
- Временное решение: используйте API
- Проблема на стороне сервера может препятствовать корректной работе стартовых запросов OkGoogle в автоматизациях.
- При использовании хаба с операционной системой Fuchsia, в котором отсутствуют устройства Matter, если хаб остается в режиме ожидания более 3 часов, ввод в эксплуатацию первого устройства Matter приводит к его отключению.
- После сброса настроек концентратора до заводских команд, команды для вновь подключенных устройств могут не выполняться, несмотря на то, что устройство отображается как находящееся в сети.