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

2025-03-14

Этот выпуск содержит исправления ошибок и повышает качество общедоступности (GA) для Home APIs Android SDK.

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

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

Новые возможности

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

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

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

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

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

2025-01-29

Этот выпуск содержит исправления ошибок и повышает качество общедоступности (GA) для Home APIs Android SDK.

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

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

Новые возможности

• Потоковый API:
  • Предоставляет потоки событий, которые уведомляют о структурах, комнатах и ​​устройствах, которые были добавлены, изменены и удалены.
  • См. раздел «Подписка на события отношений сущностей» .
• API пакетной обработки (экспериментальный):
  • Позволяет разработчику отправлять несколько команд пакетами, которые выполняются одновременно.
  • См. Отправка нескольких команд одновременно .

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

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

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

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

2025-01-14

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

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

07.01.2025

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

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

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

• Минимальная версия сервисов Google Play: 24.45.34.
• Минимальные версии прошивки Google Hub:
  • Литая версия: 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
• Версия материи: 1.3.0.0
  • Примечание. Типы устройств и кластеры Provisional Matter не поддерживаются.

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

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

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

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

2025-03-14

Этот выпуск содержит исправления ошибок и повышает качество общедоступности (GA) для Home APIs Android SDK.

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

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

Новые возможности

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

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

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

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

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

2025-01-29

Этот выпуск содержит исправления ошибок и повышает качество общедоступности (GA) для Home APIs Android SDK.

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

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

Новые возможности

• Потоковый API:
  • Предоставляет потоки событий, которые уведомляют о структурах, комнатах и ​​устройствах, которые были добавлены, изменены и удалены.
  • См. раздел «Подписка на события отношений сущностей» .
• API пакетной обработки (экспериментальный):
  • Позволяет разработчику отправлять несколько команд пакетами, которые выполняются одновременно.
  • См. Отправка нескольких команд одновременно .

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

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

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

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

2025-01-14

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

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

07.01.2025

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

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

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

• Минимальная версия сервисов Google Play: 24.45.34.
• Минимальные версии прошивки Google Hub:
  • Литая версия: 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
• Версия материи: 1.3.0.0
  • Примечание. Типы устройств и кластеры Provisional Matter не поддерживаются.

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

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

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

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

2025-03-14

Этот выпуск содержит исправления ошибок и повышает качество общедоступности (GA) для Home APIs Android SDK.

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

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

Новые возможности

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

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

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

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

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

2025-01-29

Этот выпуск содержит исправления ошибок и повышает качество общедоступности (GA) для Home APIs Android SDK.

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

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

Новые возможности

• Потоковый API:
  • Предоставляет потоки событий, которые уведомляют о структурах, комнатах и ​​устройствах, которые были добавлены, изменены и удалены.
  • См. раздел «Подписка на события отношений сущностей» .
• API пакетной обработки (экспериментальный):
  • Позволяет разработчику отправлять несколько команд пакетами, которые выполняются одновременно.
  • См. Отправка нескольких команд одновременно .

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

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

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

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

2025-01-14

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

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

07.01.2025

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

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

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

• Минимальная версия сервисов Google Play: 24.45.34.
• Минимальные версии прошивки Google Hub:
  • Литая версия: 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
• Версия материи: 1.3.0.0
  • Примечание. Типы устройств и кластеры Provisional Matter не поддерживаются.

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

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

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

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

2025-03-14

Этот выпуск содержит исправления ошибок и повышает качество общедоступности (GA) для Home APIs Android SDK.

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

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

Новые возможности

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

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

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

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

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

2025-01-29

Этот выпуск содержит исправления ошибок и повышает качество общедоступности (GA) для Home APIs Android SDK.

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

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

Новые возможности

• Потоковый API:
  • Предоставляет потоки событий, которые уведомляют о структурах, комнатах и ​​устройствах, которые были добавлены, изменены и удалены.
  • См. раздел «Подписка на события отношений сущностей» .
• API пакетной обработки (экспериментальный):
  • Позволяет разработчику отправлять несколько команд пакетами, которые выполняются одновременно.
  • См. Отправка нескольких команд одновременно .

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

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

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

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

2025-01-14

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

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

07.01.2025

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

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

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

• Минимальная версия сервисов Google Play: 24.45.34.
• Минимальные версии прошивки Google Hub:
  • Литая версия: 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
• Версия материи: 1.3.0.0
  • Примечание. Типы устройств и кластеры Provisional Matter не поддерживаются.

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

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

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

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