Adicionar as APIs Home ao seu app Android

Para adicionar as APIs Home a um app Android, você precisa atender a alguns pré-requisitos.

Pré-requisitos

Para o desenvolvimento, você precisa de um computador com as seguintes ferramentas instaladas:

  • Android Studio, versão 2024.2.1 ("Ladybug") ou mais recente. As versões anteriores a essa podem não funcionar corretamente com o SDK das APIs Home.

    Faça o download do Android Studio

  • O depurador do Android (adb).

    Instale adb.

    Isso pode ser feito com o SDK Manager.

Para testar as APIs Home, você precisa de:

  • Um dispositivo Android com a versão 10 ou mais recente configurado com uma Conta do Google que você pretende usar para desenvolvimento. Confira se uma versão atualizada do Android Studio está instalada e conectada a essa conta de desenvolvimento.
  • Uma rede Wi-Fi.
  • Para acessar e controlar Matter dispositivos, você também precisa de um hub do Google que ofereça suporte às APIs Home. Consulte Conectividade no Android para mais detalhes.

  • Pelo menos um dispositivo compatível na casa. Se esse dispositivo (ou qualquer outro que você queira testar) usar o Thread, o hub também precisará ser um roteador de borda Thread. Os seguintes tipos de dispositivos e características são compatíveis com o app de exemplo do Android:

    • Luz de temperatura de cor (ligada e desligada, brilho)
    • Sensor de contato (estado booleano)
    • Iluminação regulável (ligada e desligada, brilho)
    • Luz de cor estendida (ligada e desligada, brilho)
    • Interruptor genérico
    • Câmera do Google
    • Sensor de presença (detecção de ocupação)
    • Luz liga/desliga (ligada e desligada, brilho)
    • Interruptor de luz liga/desliga
    • Unidade de plug-in liga/desliga (ligada e desligada)
    • Sensor liga/desliga

Hubs compatíveis

Apenas alguns hubs do Google Nest oferecem suporte às APIs Home.

Tabela: hubs do Google Nest com suporte às APIs Home support
Dispositivo Suporte ao roteador de borda Thread Google Store
Google Home
Google Nest Audio
Google Nest Hub
Google Nest Hub (2nd gen)
Google Nest Hub Max
Google Nest Mini
Google TV Streamer (4k)
Nest WiFi Pro

Configurar o SDK

As APIs Home nesta versão Beta aberta ainda não fazem parte das bibliotecas padrão fornecidas pelo Google para desenvolvimento. Para desenvolver aplicativos com as APIs Home, é necessário fazer o download e hospedar as bibliotecas localmente.

Para fazer o download do SDK do Android das APIs Home, primeiro você precisa fazer login nos desenvolvedores do Google Home.

Fazer login agora!

Avançar
2. Set up OAuth