Начни с Материи

Программа Google Home Developer позволяет производителям устройств подключать свои умные домашние устройства к экосистеме Google Home. Мы расширяем локальный путь выполнения Smart Home Actions, позволяя добавлять устройства с поддержкой Matter для настройки с помощью Google Home app (GHA) и управлять ими с помощью Google Assistant , GHA или умных дисплеев, таких как Google Nest Hub (2nd gen) .

В этой документации описывается, как приступить к созданию и интеграции платформы, поддерживаемой Matter , в экосистему Google Home.

Отказ от ответственности

Относительно процедур, описанных в документации Matter , следует учитывать следующее:

• Мы рекомендуем, чтобы учетная запись, используемая для разработки, имела только один подключенный концентратор Matter для тестирования. Несколько концентраторов Matter , подключенных одновременно или подключенных к одной и той же структуре во время тестирования, могут привести к непредсказуемому поведению.
• Все процедуры предполагают использование машины Linux под управлением Ubuntu 20.04 для сборки и прошивки образцов Matter , которые были протестированы Google. Хотя машины macOS поддерживаются, рекомендуется использовать Linux. Инструкции для Mac при необходимости приводятся в процедурах.

Как построить

Чтобы создать устройство с поддержкой Matter , интегрируемое с экосистемой Google Home, вам понадобится совместимая с Matter плата разработки и Matter SDK .

Самый простой способ начать — пройти наши codelabs. Мы рекомендуем пройти хотя бы один из следующих codelabs:

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

Контрольный список разработчиков поддерживаемых устройств

Определения

В данной документации используются следующие термины:

Пограничный маршрутизатор

Концентратор, реализующий универсальный маршрутизатор Thread для устройств с поддержкой Thread .

Центр

Поддерживаемое устройство Google Nest , например Google Nest Hub (2nd gen) . Для управления устройствами с поддержкой Matter через другие поверхности, например Assistant , GHA и интеллектуальные дисплеи, требуется концентратор.

Устройство с поддержкой Matter

Устройство или плата разработки, на которую была установлена ​​сборка или пример приложения с поддержкой Matter .

Мобильное устройство

Тестовый телефон, используемый для сопряжения. В настоящее время это телефон Android .

Предпосылки

Для полной интеграции устройства с поддержкой Matter в экосистему Google Home разработчику необходимо:

1. Концентратор Google с поддержкой Thread, который может выступать в качестве пограничного маршрутизатора для устройств с поддержкой Thread и локального пути выполнения для маршрутизации намерений Smart Home.
2. Мобильное устройство (тестовый телефон), отвечающее минимальным требованиям:
   • Android O (8.1, API уровня 27 или новее)
   • iOS (v16.5 или новее)
   • Возможности BLE
3. Идентификатор поставщика (VID) и идентификатор продукта (PID) для устройства с поддержкой Matter .
4. Устройство с поддержкой Matter . Это устройство должно быть одним из типов устройств Matter , поддерживаемых в экосистеме Google Home , и может быть:
   • Ваш собственный продукт с прошивкой, поддерживающей Matter .
   • Для сквозной проверки можно использовать одно из следующих устройств Matter :

Идентификатор поставщика

По умолчанию вы можете использовать один из VID, выделенных CSA для целей тестирования. Выберите один из следующих: 0xFFF1 , 0xFFF2 , 0xFFF3 , 0xFFF4 .

Чтобы использовать производственный VID для сертификации и запуска вашей интеграции, вам сначала необходимо проверить его в Google, чтобы убедиться, что он был выдан вам CSA.

Этот VID должен быть реализован в прошивке вашего устройства.

Устройство Matter может быть сопряжено с экосистемой Google Home только в определенных сценариях идентификатора поставщика и типа устройства.

• Тестовый VID нельзя использовать в потребительском устройстве.
• Ваш производственный VID должен быть выдан Connectivity Standards Alliance (Alliance) . Google проверит, являетесь ли вы владельцем этого VID, прежде чем вы сможете использовать его в Google Home Developer Console . Как только это произойдет, вы сможете создавать интеграции для этого VID.
• Для целей разработки и Field Trial необходимо создать проект и интеграцию с соответствующей комбинацией VID и PID в Developer Console . Пользователь, вводящий устройство в эксплуатацию, должен быть либо участником проекта, либо быть включенным в список пользователей Field Trial .
• Потребители смогут использовать ваш продукт только после его сертификации Alliance .

VID и PID можно использовать только один раз для одной интеграции. Если вы хотите использовать один и тот же VID или PID в своей интеграции, вам нужно либо:

• Отредактируйте интеграцию, используя VID или PID, на другой VID или PID.
• Удалите интеграцию, используя VID или PID.

Идентификатор продукта

Информация об устройстве считывается из Matter Basic Information Cluster. Идентификатор продукта, закодированный в прошивке вашего устройства, должен совпадать с идентификатором продукта интеграции Matter в Developer Console.

Неподдерживаемые функции

Некоторые кластеры Matter пока не представлены пользователям, хотя они могут использоваться системой. В большинстве случаев это означает, что атрибуты, представленные через эти кластеры, не видны конечным пользователям:

¹ См. раздел Выключатели света Вкл./Выкл., чтобы узнать, как это влияет на выключатели света Вкл./Выкл.