Adicionar as APIs Home ao seu app Android

Para adicionar as APIs do Google 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 do Google Home.

    Faça o download do Android Studio

  • O depurador do Android (adb).

    Instalar o adb:

    Isso pode ser feito com o gerenciador do SDK.

Para testar as APIs do Google 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 essa conta de desenvolvedor.
  • Uma rede Wi-Fi.
  • Para acessar e controlar dispositivos Matter, você também precisa de uma central 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 oferece suporte aos seguintes tipos e características de dispositivo:

    • Luz de temperatura de cor (ligar e desligar, brilho)
    • Sensor de contato (estado booleano)
    • Luz regulável (ligar e desligar, brilho)
    • Luz de cores estendida (ligar e desligar, 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 plugue liga/desliga (ligada e desligada)
    • Sensor de ativação/desativação

Hubs compatíveis

Apenas alguns hubs do Google Nest oferecem suporte para as APIs Home.

Tabela: hubs Google Nest com suporte a APIs Home
Dispositivo SO Thread Suporte para roteador de borda Google Store
Google Home Cast
Google Nest Audio Elenco
Google Nest Hub Cast
Google Nest Hub (2nd gen) Fuchsia
Google Nest Hub Max Fuchsia
Google Nest Mini Cast
Google TV Streamer (4k) Android

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 apps com as APIs Home, é necessário fazer o download e hospedar as bibliotecas localmente.

Para fazer o download do SDK das APIs Home para Android, primeiro é necessário fazer login no Google Home Developers.

Faça login agora.