Notas da versão do SDK do Android para as APIs Home

2025-01-14

Orientações atualizadas para a inicialização das APIs Home.

Deixamos mais claro que uma instância de uma casa precisa ser inicializada como um singleton de contexto. Isso garante uma experiência do usuário mais suave no app e evita erros com sessões inválidas.

2025-01-07

  Lançamento da versão Beta pública das APIs Home  

Durante a versão Beta pública para desenvolvedores, todos os desenvolvedores podem começar a criar e testar os apps.

Esta versão contém correções de bugs e melhora a qualidade da disponibilidade geral (GA) do SDK do Android para APIs Home, incluindo suporte aprimorado para dispositivos Google Nest Audio e Google TV.

Versões mínimas

  • Versão mínima do Google Play Services: 24.45.34
  • Versões mínimas do firmware do Google Hub:
    • Versão do Google Cast: 3.74.444798
    • Versão mínima do Fuchsia: 22.20240805.103.161
  • SDK do Android: home.android.sdk_202411_EAP_1_0_1_RC00
  • Versão mínima do app Google Home (GHA): funciona com qualquer versão
  • androidx.core library min version: 1.10.0
  • Versão do Matter: 1.3.0.0
    • Observação: não há suporte para tipos de dispositivos e clusters provisórios do Matter.

Problemas conhecidos

  • A troca da Conta do Google conectada pode falhar e resultar em um erro.
    • Solução alternativa: execute o fluxo de permissões novamente ou reinicie o app.
  • Os dispositivos Google TV podem não funcionar para automações que usam a característica MediaPlayback.
  • Em uma estrutura que contém apenas um hub do Google:
    • Os dispositivos Matter podem parecer off-line no app Google Home (GHA).
    • O Google Assistente não pode controlar dispositivos Matter.
    • Os smart displays não podem controlar dispositivos Matter nem mostrar o estado de nenhum dispositivo Matter.
  • Em alguns dispositivos, um app nem sempre reflete o estado exato e pode informar um estado diferente do informado por um app do Google, como o app Google Home (GHA). Isso geralmente ocorre porque os dispositivos não informam o estado ao Google.
    • Solução alternativa: verificar o estado com um app do Google resolve a incompatibilidade.

Problemas conhecidos corrigidos

  • A ativação pode falhar se o app for minimizado durante o processo.
  • Um problema no servidor pode impedir que os ativadores do OkGoogle funcionem em automações.
  • Ao usar um hub com o Fuchsia que não tem dispositivos Matter na estrutura, se o hub for deixado ocioso por mais de três horas, a ativação do primeiro dispositivo Matter fará com que ele fique off-line.
  • Depois que uma redefinição de dados de fábrica é realizada em um hub, os comandos para dispositivos recém-comissionados podem falhar, mesmo que o dispositivo seja informado como on-line.