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

Программа 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 плата разработки и SDK Matter .

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

После этого проверьте наш список поддерживаемых устройств, чтобы убедиться, что то, что вы планируете интегрировать, поддерживается в экосистеме 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 (версия 16.5 или новее)
   • возможности BLE
3. Идентификатор поставщика (VID) и идентификатор продукта (PID) для устройства, поддерживающего Matter .
4. Устройство с поддержкой Matter . Это устройство должно относиться к одному из типов устройств Matter , поддерживаемых в экосистеме Google Home , и может представлять собой:
   • Ваш собственный продукт с прошивкой, поддерживающей Matter .
   • Для сквозной верификации можно использовать одно из следующих устройств Matter :

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

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

Для использования Production 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 . Идентификатор продукта, закодированный во встроенном программном обеспечении вашего устройства, должен совпадать с идентификатором продукта интеграции Matter в консоли разработчика.

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

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

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