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

2025-06-05

  Versão Beta pública 1.3.1 das APIs Home  

Esta versão contém correções de bugs e melhora a qualidade Beta do SDK do Android para as APIs Home.

Versões mínimas

  • Google Play Services: 25.19.32
  • Versões mínimas do firmware do Google Hub:
    • Transmissão: 3.75.468222
    • Fuchsia: 26.20250116.103.2201
  • SDK do Android: home.android.sdk_202505_EAP_1_3_1_RC06
  • App Google Home: funciona com qualquer versão
  • Biblioteca androidx.core: funciona com qualquer versão
  • Versão do Matter: 1.4.0.0

Novos recursos

Características

App de exemplo para Android

Foram adicionadas funções para registrar o estado de estruturas, dispositivos, tipos, traços e automações para facilitar a depuração.

Problemas conhecidos

No app de exemplo para Android, o botão Create automation às vezes exige vários toques para acionar.

Problemas conhecidos corrigidos

  • O app Google Home falha com uma FailedPreconditionException ao criar automações se o local da casa não estiver definido no app Google Home (GHA). Consulte Mudar o endereço de casa do Google para saber como definir o local de uma casa.
  • No app de exemplo para Android, um dispositivo com connectivityState PARTIALLY_ONLINE era exibido para o usuário como off-line. Esse estado agora é representado como on-line.

2025-05-12

  Versão 1.3 da API Home Beta pública  

Esta versão contém correções de bugs e melhora a qualidade Beta do SDK do Android para as APIs Home.

Versões mínimas

  • Google Play Services: 25.16.33
  • Versões mínimas do firmware do Google Hub:
    • Transmissão: 3.75.468222
    • Fuchsia: 26.20250116.103.2201
  • SDK do Android: home.android.sdk_202504_EAP_1_3_RC00
  • App Google Home: funciona com qualquer versão
  • Biblioteca androidx.core: funciona com qualquer versão
  • Versão do Matter: 1.4.0.0

Novos recursos

Problemas conhecidos

O app Google Home falha com uma FailedPreconditionException ao criar automações se o local da casa não estiver definido no app Google Home (GHA). Consulte Mudar o endereço da casa do Google para saber como fazer isso.

  • Solução alternativa: verifique se o endereço residencial está presente usando a API Discovery antes de tentar criar automações.

Problemas conhecidos corrigidos

  • 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.

2025-04-09

  Versão Beta pública 1.2.1 das APIs Home  

Esta versão contém correções de bugs e melhora a qualidade Beta do SDK do Android para as APIs Home.

Versões mínimas

  • Google Play Services: 25.09.33
  • Versões mínimas do firmware do Google Hub:
    • Transmissão: 3.75.468222
    • Fuchsia: 24.20241009.103.19006011
  • SDK do Android: home.android.sdk_202503_EAP_1_2_1_RC02
  • App Google Home: funciona com qualquer versão
  • Biblioteca androidx.core: 1.10.0
  • Versão do Matter: 1.4.0.0
1. Esse build está sendo lançado para produção e vai estar disponível para todos os dispositivos até 22 de abril de 2025.

Novos recursos

  • Melhoria no desempenho ao carregar objetos do gráfico inicial.
  • API Automation
    • Adição de suporte a filtros de entidade, que permitem que as automações selecionem dispositivos dinamicamente com base em critérios especificados na automação.
  • API Device

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.

Problemas conhecidos corrigidos

  • 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.
  • 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.

2025-03-14

  Versão Beta pública 1.2.0 das APIs Home  

Esta versão contém correções de bugs e melhora a qualidade Beta do SDK do Android para as 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_1_2_0_RC06
  • 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 você realmente 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 código QR 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 Beta do SDK do Android para as 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 tipos de dispositivo e clusters 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 código QR 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 app 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 aprimora a qualidade da versão Beta 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.