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

2025-09-08

A versão 1.4.1 do app de exemplo para Android foi lançada.

Novos recursos

  • Criar, renomear, atualizar e excluir uma sala.
  • Comissionamento para um fabric do Matter de terceiros.

Problemas conhecidos corrigidos

  • O link da página de revogação de permissões agora funciona.

2025-08-29

  Versão Beta pública 1.4.1 das APIs Home  

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

Versões mínimas

  • Google Play Services: 25.33.32
  • Versões mínimas do firmware do hub do Google:
    • Transmitir: 3.76.495998
    • Fuchsia: 27.20250422.103.3600
  • SDK do Android: home.android.sdk_1_4_1
  • 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

  • Quando o hub ativo no momento é removido à força, há um período de cinco minutos em que não é possível controlar alguns dispositivos. Depois de cinco minutos, a capacidade de controlar dispositivos é restaurada.

Problemas conhecidos corrigidos

  • O app de exemplo do Android falha quando um usuário tenta definir um termostato para um modo que ele não oferece suporte.

2025-07-31

  Versão Beta pública 1.4.0 das APIs Home  

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

Versões mínimas

  • Google Play Services: 25.28.34
  • Versões mínimas do firmware do hub do Google:
    • Cast: 3.76.486931
    • Fuchsia: 27.20250422.103.3600
  • SDK do Android: home.android.sdk_1_4_0
  • 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

  • Depois de fazer logout e login novamente em um smartphone, um app das APIs Home não consegue controlar os dispositivos.
    • Solução alternativa: feche ou coloque o app em segundo plano e aguarde pelo menos 10 segundos antes de tentar novamente.

Problemas conhecidos corrigidos

  • Os aspiradores de pó que foram encaixados não registram o estado "Encaixado".

2025-07-08

Com a versão 3.76.479819 do firmware do Cast, o Nest Wifi Pro agora pode funcionar como um hub das APIs Home.

2025-06-26

  Versão Beta pública 1.3.2 das APIs Home  

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

Versões mínimas

  • Google Play Services: 25.23.31
  • Versões mínimas do firmware do hub do Google:
    • Transmitir:
      • Google Home, Google Home Mini e Google Nest Mini: 3.75.468362
      • Google Nest Audio: 3.75.476451
    • Fuchsia: 26.20250116.103.2900
  • SDK do Android: home.android.sdk_1_3_2
  • 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

  • O artefato do SDK foi dividido em dois artefatos separados:
    • O framework do SDK das APIs Home (play-services-home-17.0.0.aar)
    • Características do SDK e tipos de dispositivo (play-services-home-types-17.0.0.aar)

    A partir desta versão, os desenvolvedores precisam incluir os dois artefatos nos caminhos de biblioteca de tempo de compilação e de execução do projeto.

App de exemplo para Android

  • Os usuários podem desconectar e revogar as permissões do app.
  • Atualização dos artefatos do SDK para incluir play-services-home-17.0.0 e play-services-home-types-17.0.0.

Problemas conhecidos

  • Os aspiradores de pó que foram encaixados não registram o estado "Encaixado".

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 das APIs Home.

Versões mínimas

  • Google Play Services: 25.19.32
  • Versões mínimas do firmware do hub do Google:
    • 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

Adição de funções para registrar o estado de estruturas, dispositivos, tipos, características e automações para facilitar a depuração.

Problemas conhecidos

No app de exemplo do Android, às vezes é necessário tocar várias vezes no botão Criar automação para acionar.

Problemas conhecidos corrigidos

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

2025-05-12

  Versão Beta pública 1.3 das APIs Home  

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

Versões mínimas

  • Google Play Services: 25.16.33
  • Versões mínimas do firmware do hub do Google:
    • 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 um FailedPreconditionException ao criar automações se o local da casa não estiver definido no app Google Home (GHA). Consulte Mudar o endereço do Google Home 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 um aumento na latência do controle de dispositivos ao alternar do Wi-Fi para uma rede móvel.
  • Depois de uma redefinição de fábrica, os dispositivos podem aparecer como 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 das APIs Home.

Versões mínimas

  • Google Play Services: 25.09.33
  • Versões mínimas do firmware do hub do Google:
    • 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. Essa versão está sendo lançada 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 Home Graph.
  • API Automation
    • Adição de suporte a filtros de entidade, que permitem que as automações selecionem dispositivos de forma dinâmica com base em critérios especificados na automação.
  • API Device

Problemas conhecidos

  • Pode haver um aumento na latência do controle de dispositivos ao alternar do Wi-Fi para uma rede móvel.
  • Depois de uma redefinição de fábrica, os dispositivos podem aparecer como off-line.

Problemas conhecidos corrigidos

  • Se a API Discovery for chamada antes da inicialização ou antes que ela seja concluída, uma HomeException com code 14: UNKNOWN e a mensagem "Nenhuma rota encontrada" serão geradas.
  • Em um ambiente com várias estruturas e usuários, a troca entre estruturas e usuários pode resultar em nenhum dispositivo sendo 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 das APIs Home.

Versões mínimas

  • Versão mínima do Google Play Services: 25.06.32
  • Versões mínimas do firmware do hub do Google:
    • 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 dispositivos e clusters provisórios do Matter.

Novos recursos

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

Problemas conhecidos

  • Pode haver um aumento na latência do controle de dispositivos ao alternar do Wi-Fi para uma rede móvel.
  • Depois de uma redefinição de fábrica, os dispositivos podem aparecer como off-line.
  • Se a API Discovery for chamada antes da inicialização ou antes que ela seja concluída, uma HomeException com code 14: UNKNOWN e a mensagem "Nenhuma rota encontrada" serão geradas.
    • Solução alternativa: chame a API Discovery apenas quando precisar de candidatos à automação. Não faça pré-busca nem 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 troca entre estruturas e usuários pode resultar em nenhum dispositivo sendo retornado.

Problemas conhecidos corrigidos

  • Na primeira vez que um app das APIs Home chama HomeManager.structures() após o lançamento, 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 longos tempos de espera.
  • Os usuários que iniciam o fluxo de configuração pelo app Câmera precisam ler o QR code duas vezes para concluir o provisionamento do Matter.
  • Em uma estrutura com 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 das APIs Home.

Versões mínimas

  • Versão mínima do Google Play Services: 25.02.32
  • Versões mínimas do firmware do hub do Google:
    • 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 dispositivos e clusters provisórios do Matter.

Novos recursos

Problemas conhecidos

  • Ao carregar, criar e editar automações, os usuários podem ter longos tempos de espera.
  • Os usuários que iniciam o fluxo de configuração pelo app Câmera precisam ler o QR code duas vezes para concluir o provisionamento do Matter.
  • Em uma estrutura com 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 com automações que usam o traço MediaPlayback.
  • Em uma estrutura que contém apenas um hub do Google:
    • Os dispositivos Matter podem aparecer 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 deles.
  • Em alguns dispositivos, um app nem sempre reflete o estado correto, e seu app pode informar um estado diferente daquele informado por um app do Google, como o Google Home. Isso geralmente acontece 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

Atualização das orientações para 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 tranquila no seu app e evita erros com sessões inválidas.

2025-01-07

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

Durante o beta público para desenvolvedores, todos podem começar a criar e testar os apps.

Esta versão contém correções de bugs e melhora a qualidade beta do SDK do Android das 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 hub do Google:
    • 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: os tipos e clusters de dispositivos Matter provisórios não são compatíveis.

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 o traço MediaPlayback.
  • Em uma estrutura que contém apenas um hub do Google:
    • Os dispositivos Matter podem aparecer 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 correto, e seu app pode informar um estado diferente daquele informado por um app do Google, como o Google Home (GHA). Isso geralmente acontece 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

  • O processo de inclusão pode falhar se o app for minimizado durante o processo.
  • Um problema do lado do servidor pode impedir que os comandos "Ok Google" funcionem em automações.
  • Ao usar um hub com Fuchsia que não tem dispositivos Matter na estrutura, se o hub ficar inativo por mais de três horas, o provisionamento do primeiro dispositivo Matter vai resultar em um dispositivo off-line.
  • Depois de uma redefinição de fábrica em um hub, os comandos para dispositivos recém-comissionados podem falhar, mesmo que o dispositivo seja informado como on-line.