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

2026-04-09

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

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

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

  • Минимальные версии прошивки Google Hub:
    • Бросать:
      • Nest WiFi Pro: 3.78.518349
      • Все остальные хабы на базе Cast: 3.78.526062
    • Фуксия: 29.20251023.103.2101601
    • Google TV Streamer, 4K: UTTK.250729.004
  • iOS SDK: home_platform_ios_1.8.0_0
  • Приложение Google Home: работает с любой версией.
  • Библиотека androidx.core : работает с любой версией.
  • Версия Matter: 1.4.1.0 , с экспериментальной поддержкой версии 1.5.0 .

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

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

  • Устройство Nest Cam Outdoor (проводное, 2-го поколения) может не пройти процедуру ввода в эксплуатацию. Его значок остается неактивным (серым), появляются сообщения об ошибках, и управлять камерой становится невозможно.
  • Невозможно изменить единицы измерения температуры (в градусах Цельсия/Фаренгейта) на термостате Google Nest Learning Thermostat (4-го поколения) версии 4.
  • В мобильной версии Google Home для веб-браузера верхняя иконка и кнопка «Назад» скрыты за заголовком. Пользователи могут не иметь возможности вернуться назад или увидеть ключевые элементы пользовательского интерфейса.
  • После переключения пользователей на одном контроллере плитки устройств GHA переходят в автономный режим. В семьях, где несколько пользователей используют один и тот же контроллер, устройства могут оставаться в автономном режиме до перезапуска приложения.

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

  • Устройства, используемые при вводе в эксплуатацию, могут выйти из строя.

2026-03-13

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

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

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

  • iOS: iOS 17.0+, Xcode 15.3+
    • Для ввода в эксплуатацию Matter: iOS 17.6+
  • Минимальные версии прошивки Google Hub:
    • Бросать:
      • Nest WiFi Pro: 3.78.518349
      • Все остальные хабы на базе Cast: 3.78.516526
    • Фуксия: 29.20251023.103.2201
    • Google TV Streamer, 4K: UTTK.260120.001
  • iOS SDK: home_platform_ios_1.7.1
  • Минимальная версия приложения Google Home: 1.7.1
  • Версия Matter: 1.4.1.0 , с экспериментальной поддержкой версии 1.5.0 .

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

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

  • Упрощенный процесс получения согласия на подписку.
  • Главная API iOS Пример приложения v1.7.1. Подробности см. в релизе на GitHub .

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

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

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

  • Устройство Nest Cam Outdoor (проводное, 2-го поколения) может не пройти процедуру ввода в эксплуатацию. Его значок остается неактивным (серым), появляются сообщения об ошибках, и управлять камерой становится невозможно.
  • Невозможно изменить единицы измерения температуры (в градусах Цельсия/Фаренгейта) на термостате Google Nest Learning Thermostat (4-го поколения) версии 4.
  • В мобильной версии Google Home для веб-браузера верхняя иконка и кнопка «Назад» скрыты за заголовком. Пользователи могут не иметь возможности вернуться назад или увидеть ключевые элементы пользовательского интерфейса.
  • После переключения пользователей на одном контроллере плитки устройств GHA переходят в автономный режим. В семьях, где несколько пользователей используют один и тот же контроллер, устройства могут оставаться в автономном режиме до перезапуска приложения.
  • Устройства, используемые при вводе в эксплуатацию, могут выйти из строя.

2026-02-13

Приложение Home APIs для iOS было обновлено для версии Home APIs 1.7.

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

2026-02-09

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

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

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

  • iOS: iOS 17.0+, Xcode 15.3+
    • Для ввода в эксплуатацию Matter: iOS 17.6+
  • Минимальные версии прошивки Google Hub:
    • Бросать:
      • Nest WiFi Pro: 3.76.508025
      • Все остальные хабы на базе Cast: 3.77.510748
    • Фуксия: 29.20251023.103.2100
    • Google TV Streamer, 4K: UTTK.250729.004
  • iOS SDK: home_platform_ios_1.7.0
  • Минимальная версия приложения Google Home: 1.7
  • Версия Matter: 1.4.1.0 , с экспериментальной поддержкой версии 1.5.0 .

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

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

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

  • API истории всегда возвращает nextPageToken , что приводит к бесконечному циклу.
  • Ошибка «поток прерван» может привести к прерыванию длительных сеансов видеотрансляции с камеры.
  • Ввод в эксплуатацию устройства Matter завершается с ошибкой во время выполнения команды CommissionDeviceCommand.

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

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

2025-12-22

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

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

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

  • iOS: iOS 17.0+, Xcode 15.3+
    • Для ввода в эксплуатацию Matter: iOS 17.6+
  • Минимальные версии прошивки Google Hub:
    • Бросать:
      • Nest WiFi Pro: 3.75.479819
      • Все остальные концентраторы на базе Cast: 3.77.505721
    • Фуксия: 28.20250723.103.2100300
    • Google TV Streamer, 4K: UTTK.250729.004
  • iOS SDK: home_platform_ios_1.6.0
  • Минимальная версия приложения Google Home: 1.6
  • Версия Matter: 1.4.1.0

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

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

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

  • Структура API
  • Пример приложения для iOS
    • Поддержка дополнительных настроек
      • Камера:
        • Включение/выключение микрофона.
        • Включение/выключение аудиозаписи.
        • Ориентация изображения.
        • Включение/выключение ночного видения.
        • Громкость динамика камеры.
        • Яркость индикатора состояния.
      • Дверной звонок:
        • Включение/выключение микрофона.
        • Включение/выключение аудиозаписи.
        • Ориентация изображения.
        • Включение/выключение ночного видения.
        • Громкость динамика камеры.
        • Яркость индикатора состояния.
        • Звуки колокольчика.
    • Интегрирует SDK по умолчанию с помощью Swift Package Manager.

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

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

2025-10-22

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

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

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

  • iOS: iOS 17.0+, Xcode 15.3+
    • Для ввода в эксплуатацию Matter: iOS 17.6+
  • Минимальные версии прошивки Google Hub:
    • Версия Cast: 3.76.495998
    • Фуксия, минимальная версия: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.5.1.zip
  • Минимальная версия приложения Google Home: работает с любой версией.
  • Версия Matter: 1.4.1.0

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

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

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

  • При переключении с Wi-Fi на мобильную сеть может наблюдаться увеличение задержки управления устройством.
  • В демонстрационном приложении может не работать управление вентиляторами различных типов, поддерживаемое облачными сервисами.
  • При вводе устройства Matter-over-Thread в эксплуатацию с использованием iOS Home API возникает ошибка.
    • Временное решение: добавьте маршрутизатор Thread Border через iOS GHA на том же телефоне.

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

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

2025-09-26

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

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

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

  • iOS: iOS 17.0+, Xcode 15.3+
    • Для ввода в эксплуатацию Matter: iOS 17.6+
  • Минимальные версии прошивки Google Hub:
    • Версия Cast: 3.76.495998
    • Фуксия, минимальная версия: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.5.0.zip
  • Минимальная версия приложения Google Home: работает с любой версией.
  • Версия Matter: 1.4.1.0

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

  • API устройства
    • Добавлен тип устройства «камера» . Следующие функции для камер также доступны для дверных звонков:
      • Прямая трансляция с камеры
      • Двусторонняя связь через камеру
      • Камера начинает и останавливает запись.
  • Пример приложения для iOS
    • Поддержка типа устройства «Камера»:
      • Прямая трансляция с камеры.
      • Двусторонняя связь через камеру.
      • Камера начинает и останавливает запись.
      • Ограниченные права доступа для различных типов устройств.
    • Поддержка активации хаба.

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

  • При переключении с Wi-Fi на мобильную сеть может наблюдаться увеличение задержки управления устройством.
  • В демонстрационном приложении может не работать управление вентиляторами различных типов, поддерживаемое облачными сервисами.
  • При вводе устройства Matter-over-Thread в эксплуатацию с использованием iOS Home API возникает ошибка.
    • Временное решение: добавьте маршрутизатор Thread Border через iOS GHA на том же телефоне.

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

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

2025-08-28

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

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

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

  • iOS: iOS 17.0+, Xcode 15.3+
    • Для ввода в эксплуатацию Matter: iOS 17.6+
  • Минимальные версии прошивки Google Hub:
    • Версия Cast: 3.76.495998
    • Фуксия, минимальная версия: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.4.1.zip
  • Минимальная версия приложения Google Home: работает с любой версией.
  • Версия Matter: 1.4.1.0

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

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

  • Добавлен термостат.

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

  • При переключении с Wi-Fi на мобильную сеть может наблюдаться увеличение задержки управления устройством.
  • В демонстрационном приложении может не работать управление типами вентиляторов, поддерживаемое облачными сервисами.
  • При вводе устройства Matter-over-Thread в эксплуатацию с использованием iOS Home API возникает ошибка.
    • Временное решение: добавьте маршрутизатор Thread Border через iOS GHA на том же телефоне.

2025-07-30

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

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

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

  • iOS: iOS 17.0+, Xcode 15.3+
    • Для ввода в эксплуатацию Matter: iOS 17.6+
  • Минимальные версии прошивки Google Hub:
    • Версия Cast: 3.75.456944
    • Фуксия, минимальная версия: 24.20241009.103.1900601
  • iOS SDK: home_platform_ios_1.4.0.zip
  • Минимальная версия приложения Google Home: работает с любой версией.
  • Версия Matter: 1.4.0.0

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

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

  • Удалите устройства, содержащие только материю.

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

  • При переключении с Wi-Fi на мобильную сеть может наблюдаться увеличение задержки управления устройством.
  • В демонстрационном приложении может не работать управление типами вентиляторов, поддерживаемое облачными сервисами.
  • При вводе устройства Matter-over-Thread в эксплуатацию с использованием iOS Home API возникает ошибка.
    • Временное решение: добавьте маршрутизатор Thread Border через iOS GHA на том же телефоне.

2025-07-08

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

2025-06-26

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

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

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

  • iOS: iOS 16.4+, Xcode 15.3+
  • Минимальные версии прошивки Google Hub:
    • Версия Cast: 3.75.456944
    • Фуксия, минимальная версия: 24.20241009.103.1900601
  • iOS SDK: home_platform_ios_1.3.2.zip
  • Минимальная версия приложения Google Home: работает с любой версией.
  • Версия Matter: 1.4.0.0

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

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

  • При переключении с Wi-Fi на мобильную сеть может наблюдаться увеличение задержки управления устройством.
  • В демонстрационном приложении может не работать управление типами вентиляторов, поддерживаемое облачными сервисами.
  • При вводе устройства Matter-over-Thread в эксплуатацию с использованием iOS Home API возникает ошибка.
    • Временное решение: добавьте маршрутизатор Thread Border через iOS GHA на том же телефоне.

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

  • Термостаты, использующие облачные технологии, могут не работать.

2025-06-05

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

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

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

  • Свертывается до connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK
  • iOS: iOS 16.4+, Xcode 15.3+
  • Минимальные версии прошивки Google Hub:
    • Версия Cast: 3.75.456944
    • Фуксия, минимальная версия: 24.20241009.103.1900601
  • iOS SDK: home_platform_ios_1.3.0.zip
  • Минимальная версия приложения Google Home: работает с любой версией.
  • Версия Matter: 1.4.0.0

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

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

  • При переключении с Wi-Fi на мобильную сеть может наблюдаться увеличение задержки управления устройством.
  • Термостаты, использующие облачные технологии, могут не работать.
  • В демонстрационном приложении может не работать управление типами вентиляторов, поддерживаемое облачными сервисами.
  • При вводе устройства Matter-over-Thread в эксплуатацию с использованием iOS Home API возникает ошибка.
    • Временное решение: добавьте маршрутизатор Thread Border через iOS GHA на том же телефоне.

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

  • В iOS-версии GHA могут происходить сбои при переключении сети с локальной на Wi-Fi или при переключении между приложениями.

2025-05-09

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

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

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

  • Свертывается до connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK
  • iOS: iOS 16.4+, Xcode 15.3+
  • Минимальные версии прошивки Google Hub:
    • Версия Cast: 3.75.456944
    • Фуксия, минимальная версия: 24.20241009.103.1900601
  • iOS SDK: home_platform_ios_1.3.0.zip
  • Минимальная версия приложения Google Home: работает с любой версией.
  • Версия Matter: 1.4.0.0

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

  • API устройства
    • Поддержка изменения имени HomeDevice
  • Структура API
    • Поддержка изменения названия Room

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

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

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

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

2025-04-09

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

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

В этом релизе исправлены ошибки и улучшено качество общедоступной версии (GA) iOS SDK Home APIs.

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

  • Свертывается до connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK
  • iOS: iOS 16.4+, Xcode 15.3+
  • Минимальные версии прошивки Google Hub:
    • Версия Cast: 3.75.456944
    • Фуксия, минимальная версия: 24.20241009.103.1900601
  • iOS SDK: home_platform_ios_1.0_1.zip
  • Минимальная версия приложения Google Home: работает с любой версией.
  • Версия Matter: 1.4.0.0
    • Примечание: Временные типы устройств и кластеры не поддерживаются.

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

  • При переключении с Wi-Fi на мобильную сеть может наблюдаться увеличение задержки управления устройством.
  • При предоставлении разрешений в iOS-версии приложения Google Home кнопки « Узнать больше» и «Назад» могут не реагировать.
    • Временное решение: нажмите и удерживайте ссылку «Подробнее» , чтобы открыть ее в системном браузере, или нажмите кнопку закрытия в левом верхнем углу, чтобы выйти из этого окна.
  • Отзыв разрешения при открытом приложении Google Home приведет к его сбою.
  • В демонстрационном приложении может не работать базовый видеоплеер.
  • Термостаты, использующие облачные технологии, могут не работать.
  • В демонстрационном приложении может не работать управление типами вентиляторов, поддерживаемое облачными сервисами.
  • Возможно, управление типами оконных штор с использованием облачных технологий не будет работать.
  • В iOS-версии GHA могут происходить сбои при переключении сети с локальной на Wi-Fi или при переключении между приложениями.

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

  • Переименование и присвоение имен устройствам не поддерживается.
  • Для ввода в эксплуатацию первое устройство Matter в здании необходимо ввести в эксплуатацию с помощью приложения Google Home для iOS. В настоящее время API Home не позволяют создавать новые здания, а только добавлять новые к существующим для зданий, построенных до 2023 года. Здания, построенные после 2023 года, не затронуты этой проблемой.