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

Программа 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 .

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

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

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

Определения

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

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

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

Центр

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

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

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

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

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

Предварительные условия

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

1. Хаб Google с поддержкой Thread , который будет служить как пограничным маршрутизатором для устройств с поддержкой Thread, так и локальным путем выполнения для маршрутизации намерений умного дома.
2. Мобильное устройство (тестовый телефон), соответствующее минимальным требованиям:
   • Android O (8.1, уровень API 27 или новее)
   • iOS (16.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.
• Для целей разработки и полевых испытаний в Developer Console необходимо создать проект и интеграцию с соответствующей комбинацией VID и PID. Пользователь, выполняющий ввод устройства в эксплуатацию, должен либо быть участником проекта, либо быть включен в список пользователей, участвующих в полевых испытаниях.
• Потребители-потребители смогут использовать ваш продукт только после того, как он будет сертифицирован Alliance .

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

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

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

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

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

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

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