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

Программа 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, так и локальный путь выполнения для маршрутизации намерений 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 .

Чтобы использовать 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 пока не доступны пользователям, хотя могут использоваться системой. В большинстве случаев это означает, что атрибуты, предоставляемые через эти кластеры, не видны конечным пользователям:

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