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

2026-05-01

В этом релизе исправлены ошибки и улучшено качество бета-версии 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.

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

• Полные примечания к выпуску см. в релизе GitHub v1.8.0.

2026-04-09

В этом релизе исправлены ошибки и улучшено качество бета-версии 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

В этом релизе исправлены ошибки и улучшено качество бета-версии 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 устройства.

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

• Режим без концентратора удален.

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

• Главная API Android Пример приложения v1.7.1. Подробности см. в релизе на GitHub.

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

• Для камер 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.

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

• Полные примечания к выпуску см. в релизе GitHub v1.7.0.

2026-02-09

В этом релизе исправлены ошибки и улучшено качество бета-версии 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

В этом релизе исправлены ошибки и улучшено качество бета-версии 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

В этом релизе исправлены ошибки и улучшено качество бета-версии 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

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

• API активации хаба позволяет программно обнаруживать и активировать хаб Google Home в рамках Structure API.

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

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

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

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

2025-09-26

В этом релизе добавлена ​​поддержка устройств с камерой, исправлены ошибки и улучшено качество бета-версии 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

В этом релизе исправлены ошибки и улучшено качество бета-версии 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

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

• В API устройств определена новая DecommissionIneligibleReason для попыток вывода из эксплуатации устройства с несколькими источниками данных.

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

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

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

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

2025-07-31

В этом релизе исправлены ошибки и улучшено качество бета-версии 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

В этом релизе исправлены ошибки и улучшено качество бета-версии 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

В этом релизе исправлены ошибки и улучшено качество бета-версии 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 устройство с connectivityState PARTIALLY_ONLINE ранее отображалось как находящееся в автономном режиме. Теперь это состояние отображается как «в сети».

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

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

2025-05-12

В этом релизе исправлены ошибки и улучшено качество бета-версии 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 на мобильную сеть может наблюдаться увеличение задержки управления устройством.
• После сброса настроек концентратора до заводских устройств, они могут отображаться как находящиеся в автономном режиме.

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

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

2025-04-09

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

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

• Сервисы Google Play: 25.09.33
• Минимальные версии прошивки Google Hub:
  • Состав: 3.75.468222
  • Фуксия: 24.20241009.103.1900601 ¹
• Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
• Приложение Google Home: работает с любой версией.
• Библиотека androidx.core : 1.10.0
• Версия Matter: 1.4.0.0

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

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

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

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

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

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

2025-03-14

В этом релизе исправлены ошибки и улучшено качество бета-версии 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

В этом релизе исправлены ошибки и улучшено качество бета-версии 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

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

В этом релизе исправлены ошибки и улучшено качество бета-версии 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 приводит к его отключению.
• После сброса настроек концентратора до заводских команд, команды для вновь подключенных устройств могут не выполняться, несмотря на то, что устройство отображается как находящееся в сети.