Atenção! Os novos programas da prévia para desenvolvedores serão lançados em breve. Inscreva-se aqui e seja um dos primeiros a testar novas ferramentas e enviar feedback.

Esta página foi traduzida pela API Cloud Translation.

Switch to English

Primeiros passos com o Matter

O programa para desenvolvedores do Google Home permite que os fabricantes conectem os dispositivos de casa inteligente ao ecossistema Google Home. Estamos expandindo o caminho de fulfillment local das Ações de casa inteligente, com a possibilidade de adicionar dispositivos com Matter para configuração usando Google Home app (GHA) e controlá-los usando Google Assistant, GHA ou smart displays como o Google Nest Hub (2nd gen).

Esta documentação descreve como começar a criar e integrar uma plataforma com suporte a Matter no ecossistema do Google Home.

Exonerações de Responsabilidade

Em relação aos procedimentos descritos na documentação do Matter, esteja ciente do seguinte:

Recomendamos que a conta usada para desenvolvimento tenha apenas um único hub ativado para Matter conectado para testes. Vários hubs ativados para Matter conectados ao mesmo tempo ou conectados à mesma estrutura durante o teste podem resultar em um comportamento imprevisível.
Todos os procedimentos pressupõem o uso de uma máquina Linux executando o Ubuntu 20.04 para criar e atualizar amostras de Matter, que foram testadas pelo Google. Embora os computadores MacOS sejam compatíveis, é recomendável usar o Linux. As instruções específicas do Mac são chamadas nos procedimentos conforme necessário.

Como criar

Para criar um dispositivo compatível com Matter e que se integre ao ecossistema do Google Home, você vai trabalhar com uma placa de desenvolvimento compatível com Matter e o SDK do Matter.

A maneira mais fácil de começar é com nossos codelabs. Recomendamos que você realize pelo menos um destes codelabs:

Depois disso, verifique nossa lista de dispositivos compatíveis para garantir que o que você planeja integrar é compatível com o ecossistema do Google Home. Em seguida, leia a Lista de verificação para desenvolvedores e entenda todo o fluxo de desenvolvimento, desde a criação do projeto até o lançamento.

Dispositivos compatíveis Lista de verificação para desenvolvedores

Definições

Os seguintes termos são usados nesta documentação:

Roteador de borda: Um hub que implementa um roteador de borda Thread de uso geral para dispositivos com Thread.
Hub: Um dispositivo Google Nest com suporte, como Google Nest Hub (2nd gen). Um hub é necessário para controlar dispositivos com Matter em outras plataformas, como Assistant, GHA e smart displays.
Dispositivo compatível com Matter: Um dispositivo ou uma placa de desenvolvimento que foi atualizado com um build ou app de exemplo compatível com Matter.
Dispositivo móvel: O smartphone de teste usado para ajudar no pareamento. No momento, este é um smartphone Android.

Pré-requisitos

Extensões de ambiente de desenvolvimento integrado recomendadas para o desenvolvimento do Matter

Para integrar totalmente um dispositivo compatível com Matter ao ecossistema do Google Home, o desenvolvedor precisa ter:

Um hub do Google compatível com Thread para servir como um roteador de borda para dispositivos com Thread e como um caminho de fulfillment local para rotear intents de casa inteligente.
Um dispositivo móvel (smartphone de teste) que atenda aos requisitos mínimos:
- Android O (8.1, API de nível 27 ou mais recente)
- iOS (v16.5 ou mais recente)
- Recurso BLE
Um ID do fornecedor (VID, na sigla em inglês) e um ID do produto (PID, na sigla em inglês) para o dispositivo ativado para Matter.
Um dispositivo com suporte ao Matter. Ele precisa ser um dos Matter tipos de dispositivo com suporte atualmente no ecossistema do Google Home e pode ser:
- Seu próprio produto com firmware ativado para Matter.
- Uma placa de desenvolvimento de uma plataforma de fornecedor compatível que pode servir como um dispositivo ativado para Matter para verificação completa. As seguintes plataformas são compatíveis:

*Tabela: Matter exemplos de fornecedores de produtos eletrônicos*
Fornecedor	Plataforma	Guias
Laboratório bouffalo	BL602 (link em inglês)	Início rápido
Laboratório bouffalo	BL702 (link em inglês)	Início rápido
Espressif	ESP32	Início rápido Teste OTA
Semicondutores nórdicos	nRF52840 DK (link em inglês)	Início rápido Teste OTA
NXP	Kit de desenvolvimento IOTZTB-DK006	Início rápido
Realtek	Ameba D Series	Início rápido
Laboratórios de silicone	EFR32MG24 Dev Kit (em inglês)	Início rápido
Laboratórios de silicone	Kit básico de Zigbee e Thread EFR32MG	Início rápido
Telink	TLSR9518 (em inglês)	Início rápido
Instrumentos texano	Kit de desenvolvimento do LaunchPad CC2652R7	Início rápido

ID do fornecedor

Por padrão, você pode usar um dos VIDs alocados pelo CSA para fins de teste. Selecione uma das seguintes opções: 0xFFF1, 0xFFF2, 0xFFF3 ou 0xFFF4.

Para usar um VID de produção para que sua integração possa ser certificada e lançada, primeiro você precisa verificá-lo pelo Google para garantir que ele foi emitido pelo CSA.

Esse VID precisa ser implementado no firmware do dispositivo.

Um dispositivo Matter só pode ser pareado no ecossistema Google Home em determinados cenários de ID do fornecedor e tipo de dispositivo.

Não é possível usar um VID de teste em um dispositivo de consumidor.
O VID de produção precisa ser emitido pelo Connectivity Standards Alliance (Alliance). O Google validará que você é o proprietário desse VID antes de usá-lo no Google Home Developer Console. Quando isso acontecer, será possível criar integrações para esse VID.
Para fins de desenvolvimento e teste de campo, é necessário criar um projeto e uma integração com a combinação de VID e PID correspondente no Developer Console. O usuário que comissionou o dispositivo precisa ser membro do projeto ou estar incluído na lista de usuários de testes de campo.
Os usuários pessoais só poderão usar seu produto depois que ele for certificado pelo Alliance.

*Tabela: cenários de pareamento com ID do fornecedor (VID, na sigla em inglês) e tipo de dispositivo*
		Que tipos de usuários podem comissionar o dispositivo para o ecossistema do Google Home?
Tipo de VID	Certificação de VID e status de integração do console	Produção (usuários consumidores)	Desenvolvimento (Desenvolvedores, usuários de testes em campo)
Teste	Nenhuma integração no Developer Console (não pode ser certificado)
Teste	A integração existe no Developer Console (não pode ser certificada)
Produção	Não certificado, a integração não existe no Developer Console
Produção	Não certificado, há integração no Developer Console
Produção	Certificada na DCL Alliance, a integração não existe no Developer Console
Produção	Tem certificação nos termos do DCL Alliance, e há integração no Developer Console

ID do produto

As informações sobre o dispositivo são lidas do cluster de informações básicas do Matter. O ID do produto codificado no firmware do dispositivo precisa corresponder ao ID do produto da integração Matter no Play Console.

Recursos não compatíveis

Alguns clusters Matter ainda não estão expostos aos usuários, embora possam ser usados pelo sistema. Na maioria dos casos, isso significa que os atributos expostos por esses clusters não ficarão visíveis para os usuários finais:

*Table: Matter clusters not exposed to users in the Google Home ecosystem*
Cluster Type	Clusters
Core	Binding ¹ Label Fixed Label User Label Actions Group Key Localization Configuration Time Format Localization Unit Localization Power Source Configuration Power Source Diagnostics clusters (Diagnostic Logs, General Diagnostics, Software Diagnostics, Thread Network Diagnostics, Wi-Fi Network Diagnostics, Ethernet Network Diagnostics) Time Synchronization Mode Select
Application	Groups and Scenes are not directly supported. Equivalent functionality is available via Routines. All Media clusters. Equivalent functionality is available via Google Cast.

1 Consulte Interruptores de luz para ligar/desligar para saber como isso afeta os interruptores de luz de ativação/desativação.

Lista de verificação do desenvolvedor