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

2025-03-14

  APIs Home: versão Beta pública 1.2.0  

Esta versão contém correções de bugs e melhora a qualidade da disponibilidade geral (GA) do SDK do Android para APIs Home.

Versões mínimas

  • Versão mínima do Google Play Services: 25.06.32
  • Versões mínimas do firmware do Google Hub:
    • Versão do Google Cast: 3.75.456944
    • Versão mínima do Fuchsia: 24.20241009.103.1900601
  • SDK do Android: home.android.sdk_202412_EAP_1_2_RC01
  • Versão mínima do app Google Home: 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 dispositivo e clusters provisórios do Matter.

Novos recursos

  • API Automation:
    • Suporte a períodos e datas parciais em condições de automação. Consulte Usar datas com entre.
    • Em versões anteriores, a API Discovery retornava um NumberSetConstraint para alguns campos de bitmap, quando deveria retornar um BitmapConstraint. Agora esses campos retornam um BitmapConstraint como esperado. Isso é limitado a bitmaps optionsMask e optionsOverride nos comandos de atributo LevelControl.

Problemas conhecidos

  • Pode haver aumento da latência do controle do dispositivo ao alternar do Wi-Fi para uma rede de dispositivos móveis.
  • Depois que um hub é redefinido para a configuração original, os dispositivos podem parecer off-line.
  • Se a API Discovery for chamada antes da inicialização ou antes que a inicialização seja concluída, uma HomeException com code 14: UNKNOWN e a mensagem "No route found" serão geradas.
    • Solução alternativa: chame a API Discovery apenas quando precisar de candidatos de automação. Não faça pré-busca e armazene em cache entidades candidatas. Verifique se uma entidade está on-line antes de chamar os métodos da API Discovery nela.
  • Em um ambiente com várias estruturas e usuários, a alternância entre estruturas e usuários pode fazer com que nenhum dispositivo seja retornado.

Problemas conhecidos corrigidos

  • Na primeira vez que um app das APIs Home chama HomeManager.structures() após ser iniciado, ele recebe zero estruturas, mesmo quando uma ou mais estruturas estão presentes. Isso dá a impressão incorreta de que não há estruturas associadas à Conta do Google.
  • Ao carregar, criar e editar automações, os usuários podem ter tempos de espera longos.
  • Os usuários que iniciam o fluxo de configuração no app Câmera precisam ler o QR code duas vezes para concluir a ativação do Matter.
  • Em uma estrutura que contém mais de 200 dispositivos, a API Discovery pode simplesmente não retornar candidatos.

2025-01-29

  Versão Beta pública 1.1.0 das APIs Home  

Esta versão contém correções de bugs e melhora a qualidade da disponibilidade geral (GA) do SDK do Android para APIs Home.

Versões mínimas

  • Versão mínima do Google Play Services: 25.02.32
  • Versões mínimas do firmware do Google Hub:
    • Versão do Google Cast: 3.75.456944
    • Versão mínima do Fuchsia: 24.20241009.103.1900500
  • SDK do Android: home.android.sdk_202412_EAP_1_1_RC04
  • Versão mínima do app Google Home: 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 clusters e tipos de dispositivos provisórios do Matter.

Novos recursos

Problemas conhecidos

  • Ao carregar, criar e editar automações, os usuários podem ter tempos de espera longos.
  • Os usuários que iniciam o fluxo de configuração no app Câmera precisam ler o QR code duas vezes para concluir a ativação do Matter.
  • Em uma estrutura que contém mais de 200 dispositivos, a API Discovery pode simplesmente não retornar candidatos.

Problemas conhecidos corrigidos

  • A troca da Conta do Google conectada pode falhar e resultar em um erro.
  • 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.
    • 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 Google Home. 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.

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 novamente o fluxo de permissões 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.