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ê vai precisar de um computador com as seguintes ferramentas instaladas:

  • Android Studio, versão 2024.2.1 ("Ladybug") ou mais recente. Versões anteriores 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 Home, você vai precisar de:

  • Um dispositivo Android com o 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 esse dispositivo (ou qualquer outro que você queira testar) usar o Thread, o hub também precisará ser um roteador de borda do Thread. O app de exemplo do Android é compatível com os seguintes tipos e características de dispositivos:

    • Luz de temperatura da cor (ligar e desligar, brilho)
    • Sensor de contato (estado booleano)
    • Luz dimerizável (ligar e desligar, brilho)
    • Luz colorida estendida (ligada e desligada, brilho)
    • Switch genérico
    • Sensor de ocupação (detecção de ocupação)
    • Luz de ativação/desativação (ativação e desativação, brilho)
    • Interruptor de luz liga/desliga
    • Unidade de plug-in liga/desliga (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 às 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