App de exemplo para Android das APIs Home

O app de exemplo mostra os recursos básicos das APIs do Google Home para Android.

Pré-requisitos

Para criar, instalar e testar o app, você precisa atender a alguns pré-requisitos:

  • 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

  1. No console do Google Cloud, acesse o painel do seletor de projetos e selecione o projeto que você quer usar para criar credenciais do OAuth.
  2. Acesse a página APIs e serviços e clique em Credenciais no menu de navegação.

  3. Se você ainda não tiver configurado a tela de consentimento para este projeto do Google Cloud, o botão Configurar tela de consentimento vai aparecer. Nesse caso, configure a tela de consentimento usando o procedimento a seguir. Caso contrário, avance para a próxima seção.

    1. Clique em Configurar tela de consentimento. A página Tela de consentimento do OAuth é exibida.
    2. Dependendo do caso de uso, selecione Interno ou Externo e clique em Criar. O painel Tela de consentimento do OAuth é exibido.
    3. Insira informações na página de informações do app de acordo com as instruções na tela e clique em Salvar e continuar. O painel Scopes é exibido.
    4. Não é necessário adicionar escopos. Clique em Salvar e continuar. O painel Test users é exibido.
    5. Se você quiser adicionar usuários para testar o acesso ao app, clique em Adicionar usuários. O painel Adicionar usuários é exibido. Os usuários de teste têm o privilégio de conceder permissões no app.
    6. No campo vazio, adicione um ou mais endereços de e-mail da Conta do Google e clique em Adicionar.
    7. Clique em Salvar e continuar. O painel Summary é exibido.
    8. Revise as informações da tela de consentimento OAuth e clique em Voltar ao painel.

Consulte Como configurar a tela de consentimento OAuth no site de ajuda do console do Google Cloud para conferir todos os detalhes.

Faça o download do código-fonte

O código-fonte do app de exemplo está disponível no GitHub.

Navegue até o local em que você quer salvar o projeto e clone-o:

git clone https://github.com/google-home/google-home-api-sample-app-android.git

configurar o SDK

As APIs Home para Android nessa versão Beta aberta ainda não fazem parte das bibliotecas padrão fornecidas pelo Google para desenvolvimento. Para desenvolver apps Android 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.

Criar e executar

  1. Abra Android Studio e, em seguida, a pasta do projeto google-home-api-sample-app-android que foi clonada para a máquina local.
  2. Durante a primeira configuração, o Android Studio pode levar até 10 minutos para fazer o download de todas as dependências do projeto e concluir o build do Gradle.
    • Se você receber um erro durante essa etapa, como Gradle Sync Failed, clique em Tentar de novo para iniciar a sincronização novamente.
  3. Mude o nome do pacote do app de exemplo para um novo que não tenha sido registrado antes, como um baseado no nome da sua organização:
    1. Abra o projeto.
    2. Expanda a hierarquia de origem.
    3. Selecione a parte do pacote que você quer mudar, ou seja, com.example.
    4. Clique com o botão direito do mouse no pacote e selecione Refactor > Rename... Refatorar > Renomear menu
    5. Digite o novo nome e clique em Refactor.
    6. Edite o arquivo build.gradle.kts, mudando o android namespace e o applicationId para o novo nome do pacote.
    7. Edite o arquivo AndroidManifest.xml e mude o pacote para o novo nome do pacote sempre que ele ocorrer no arquivo.

  4. Gere um certificado de assinatura de depuração do app executando o app em Android Studio. Quando você executa ou depura um app em Android Studio, o Android Studio gera automaticamente um certificado de assinatura de app destinado ao desenvolvimento e à depuração. Consulte Android Studio: assinar o build de depuração para uma explicação completa.

    Conecte seu dispositivo móvel à máquina local. Android Studio lista os dispositivos conectados por número de modelo. Selecione seu dispositivo na lista e clique em Executar projeto. Isso cria e instala o app de exemplo no seu dispositivo móvel.

    Para instruções mais detalhadas, consulte Executar apps em um dispositivo de hardware no site para desenvolvedores Android.

    Agora, pare o app em execução.

  5. Para conseguir a impressão digital SHA-1 do certificado de depuração, siga as instruções detalhadas em Configurar OAuth 2.0 / Aplicativos nativos / Android no site de ajuda do Google Cloud Console.

  6. Registre o app de exemplo para o OAuth 2.0 e crie credenciais do OAuth seguindo as instruções fornecidas em Como configurar o OAuth 2.0.

    1. Indique o tipo de aplicativo, que é app nativo/Android.
    2. Adicione a impressão digital SHA-1 ao cliente OAuth seguindo as instruções em Como configurar o OAuth 2.0 / Aplicativos nativos / Android no site de ajuda do Google Cloud Console. Você precisa gerar a chave SHA-1 a partir da chave padrão do Android Studio durante o processo de desenvolvimento.
    3. Adicione usuários de teste. Os usuários de teste têm o privilégio de conceder permissões no app de exemplo.

  7. Com o dispositivo móvel conectado à máquina local, clique em Run project novamente para executar o app de exemplo no dispositivo móvel.

Depois de instalado, o app fica disponível no seu dispositivo móvel como App de exemplo da API Home.