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

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

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

Matter Virtual Device

Updated 6 января 2025 г.

A self-contained desktop application that provides visual state and controls for Matter virtual devices.

Start

Google Home Playground

Updated 6 января 2025 г.

Simulate a smart home project by creating and modifying a virtual home with configurable device types and traits.

Start

Google Home Plugin for Android Studio

Updated 6 января 2025 г.

This plugin gives you access to Google Assistant Simulator, Cloud Logging, and other tools to simplify your smart home development process.

Start

Google Home UI Automator

Updated 15 марта 2024 г.

Automate commissioning in the Google Home app.

Start

Smart Home SYNC Data Validator

Updated 24 августа 2023 г.

Verify the correctness of intent response payloads using the SYNC response validator.

Start

Troubleshooting integration errors

Updated 6 января 2023 г.

Learn how to troubleshoot Monitoring metrics and Google Cloud logs.

Start

Home Graph Viewer

Updated 5 августа 2022 г.

View the Home Graph using the Home Graph Viewer.

Start

Google Home Test Suite

Updated 13 июля 2022 г.

Generate and run test cases based on the devices and traits associated with your account and when testing is complete view results.

Start

Google Home Extension for VS Code

Updated 31 мая 2022 г.

Use the Google Home Extension for access to Google Assistant Simulator, Cloud Logging, and other tools to simplify your smart home development process.

Start

Cloud Monitoring for the Google Home ecosystem

Updated 1 февраля 2022 г.

Monitor usage of smart home Actions.

Start

12

После этого проверьте наш список поддерживаемых устройств, чтобы убедиться, что то, что вы планируете интегрировать, поддерживается в экосистеме 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.
• Для целей разработки и Field Trial в Developer Console необходимо создать проект и интеграцию с соответствующей комбинацией VID и PID. Пользователь, вводящий устройство в эксплуатацию, должен либо быть участником проекта, либо быть включен в список пользователей Field Trial .
• Потребители смогут использовать ваш продукт только после того, как он будет сертифицирован Alliance .

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

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

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

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

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

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

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