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. Observação: versões anteriores a esta podem não funcionar corretamente com o SDK das APIs Home.

    Faça o download do Android Studio

  • O depurador do Android (adb).

    Instalar o adb:

    Isso pode ser feito com o SDK Manager.

Para testar as APIs do Home, você vai precisar de:

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

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

    • Iluminação de temperatura da cor (ligada e desligada, brilho)
    • Sensor de contato (estado booleano)
    • Iluminação dimerizável (ligar e desligar, brilho)
    • Trava da porta
    • Luz colorida estendida (ligada e desligada, brilho)
    • Switch genérico
    • Roteador de borda do Google
    • Câmera do Google
    • Campainha do Google
    • Sensor de presença (detecção de presença)
    • Luz on/off (ligar e desligar, brilho)
    • Interruptor de luz on/off
    • Unidade de plug-in de ligar/desligar (ligada e desligada)
    • Sensor de ativação/desativação

Hubs compatíveis

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

Tabela: hubs Google Nest com suporte para APIs Home
Dispositivo Suporte para 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 faça login no Google Home Developers.

Faça login agora!

Avançar
2. Set up OAuth