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

2026-05-01

  Versão Beta pública 1.8.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: 26.16.31
• Firmware do hub do Google, Cast, Nest Wifi Pro: 3.78.518349
• Firmware do hub do Google, Cast e todos os outros hubs baseados em Cast: 3.78.526062
• Firmware do hub do Google, Fuchsia: 30.20260121.103.1602802
• Firmware do hub do Google, Google TV Streamer, 4K: UTTK.250729.004
• SDK do Android: home.android.sdk_GHP_1_8_1
• App Google Home: 4.8 ou mais recente
• Biblioteca androidx.core: funciona com qualquer versão
• Versão do Matter: 1.4.1.0
• Versão do Matter: suporte experimental para 1.5.0

Novos recursos

• O traço do termostato agora é compatível com recursos de leitura/atualização, liga/desliga e timer

Problemas conhecidos corrigidos

• O comissionamento de um dispositivo Matter pode falhar.
• A luz Philips BLE não mostra o estado correto.
• Latência causando instabilidade na rede e tempos de resposta lentos.

Problemas conhecidos

• Não é possível comissionar alguns dispositivos usando o Google TV Streamer 4K.
• Quando o hub é um Nest Wifi Pro, Google Nest Hub ou Google Nest Hub Max, o app Google Home mostra dispositivos multipartes como vários blocos.

2026-04-10

O app de amostra do Android das APIs Home foi atualizado para a versão 1.8 das APIs Home.

App de exemplo

• Consulte a versão 1.8.0 do GitHub para conferir as notas completas.

2026-04-09

  Versão Beta pública 1.8 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: 26.12.32
• Firmware do hub do Google, Cast, Nest Wifi Pro: 3.78.518349
• Firmware do hub do Google, Cast e todos os outros hubs baseados em Cast: 3.78.526062
• Firmware do hub do Google, Fuchsia: 29.20251023.103.2101601
• Firmware do hub do Google, Google TV Streamer, 4K: UTTK.250729.004
• SDK do Android: home.android.sdk_GHP_1_8_0
• App Google Home: funciona com qualquer versão
• Biblioteca androidx.core: funciona com qualquer versão
• Versão do Matter: 1.4.1.0
• Versão do Matter: suporte experimental para 1.5.0

Novos recursos

• Automações sugeridas na API Automations.
• Suporte para dispositivos multiparte na API Device.
• Configuração de zonas de atividade de câmeras e campainhas na API Device.
• Configuração da detecção de som da câmera e da campainha na API Device.
• Modo de gravação da câmera e da campainha (CVR/EVR/Sem histórico) na API Device.

Problemas conhecidos corrigidos

• Não é possível mudar as unidades de temperatura (C/F) do Google Nest Learning Thermostat (4ª geração).
• Na versão para dispositivos móveis do Google Home para Web, o ícone superior e o botão "Voltar" ficam ocultos por um cabeçalho. Os usuários podem não conseguir voltar ou ver os principais elementos da interface.
• Um hub do Android TV pode informar incorretamente que os dispositivos Matter estão "off-line".

Problemas conhecidos

• O comissionamento de um dispositivo Matter pode falhar.

2026-03-13

  Versão Beta pública 1.7.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:
• Firmware do hub do Google, Cast, Nest Wifi Pro: 3.78.518349
• Firmware do hub do Google, Cast e todos os outros hubs baseados em Cast: 3.78.516526
• Firmware do hub do Google, Fuchsia: 29.20251023.103.2201
• Firmware do hub do Google, Google TV Streamer, 4K: UTTK.250729.004
• SDK do Android: home.android.sdk_GHP_1_7_1
• App Google Home: 1.7.1
• Biblioteca androidx.core: funciona com qualquer versão
• Versão do Matter: 1.4.1.0
• Versão do Matter: suporte experimental para 1.5.0

Novos recursos

• Ativação da análise de câmeras e campainhas na API Device.
• Última conexão da câmera e da campainha na API Device.
• Estado de conectividade da câmera e da campainha na API Device.
• Solicitações atômicas de termostato na API Device.

Outras mudanças importantes

• O modo sem hub foi removido.

App de exemplo

• App de exemplo do Android das APIs Home v1.7.1. Consulte o lançamento do GitHub para mais detalhes.

Problemas conhecidos corrigidos

• Para a Nest Cam interna/externa (com bateria ou com fio) e a Nest Doorbell (com bateria, 2ª geração), a opção "Tempo restante da bateria" não aparece nas configurações de bateria.
• A configuração de duração do toque é ignorada.
• A luz Philips BLE aparece incorretamente como "On-line" mesmo quando o dispositivo está off-line.

Problemas conhecidos

• Não é possível mudar as unidades de temperatura (C/F) do Google Nest Learning Thermostat (4ª geração).
• Possíveis atrasos na estabilidade da rede e na capacidade de resposta do dispositivo.
• Na versão para dispositivos móveis do Google Home para Web, o ícone na parte de cima e o botão "Voltar" ficam ocultos por um cabeçalho. Os usuários podem não conseguir voltar ou ver os principais elementos da interface.
• O Hub pode ficar travado no estado "Conectando..." após a OOBE do modo federado.
• O comissionamento de um dispositivo Matter pode falhar.
• Um hub do Android TV pode informar incorretamente que os dispositivos Matter estão off-line.
• A versão correta do software pode não aparecer em "Versão atual do software do dispositivo da câmera".
• Um controle deslizante da interface do termostato mostra temperaturas fora do intervalo.
• Quando a duração do toque é definida, o dispositivo não toca pelo período especificado.

2026-02-13

O app de exemplo do Android das APIs Home foi atualizado para a versão 1.7 das APIs Home.

App de exemplo

• Consulte a versão 1.7.0 do GitHub para ver as notas de lançamento completas.

2026-02-09

  Versão Beta pública 1.7 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: 26.02.34
• Firmware do hub do Google, Cast, Nest Wifi Pro: 3.76.508025
• Firmware do hub do Google, Cast, todos os outros hubs baseados no Cast: 3.77.510748
• Firmware do Google Hub, Fuchsia: 29.20251023.103.2100
• Firmware do hub do Google, Google TV Streamer, 4K: UTTK.250729.004
• SDK do Android: home.android.sdk_GHP_1_7
• App Google Home: 1.7
• Biblioteca androidx.core: funciona com qualquer versão
• Versão do Matter: 1.4.1.0
• Versão do Matter: suporte experimental para 1.5.0

Novos recursos

• Automações locais: com base em condições como conectividade, tipos de dispositivos e características, algumas automações agora podem ser executadas localmente na API Automations.
• Ativação da configuração inicial pelo usuário (OOBE) da câmera em apps na API Device.
• Temas de toque de campainha e câmera na API Device.
• Economia de bateria automática para câmeras e campainhas na API Device.
• Preferências de uso da bateria da câmera e da campainha na API Device.
• Estado de carregamento da bateria da câmera e da campainha na API Device.
• Níveis de bateria da câmera e da campainha na API Device.
• Número de série da câmera e da campainha na API Device.
• Modelo de câmera e campainha na API Device.
• Versão do software da câmera e da campainha na API Device.
• API de chave-valor personalizada na API Device.
• A consulta de permissões permite que um app determine quais tipos de dispositivos receberam acesso do usuário na API Permissions.

Outras mudanças importantes

• HomeException.unsupported foi substituído por HomeException.unimplemented para se alinhar aos códigos de erro padrão.
• O gerador de código empacotado para características personalizadas mudou na versão 1.7. Os desenvolvedores que têm características personalizadas precisam recompilar as características depois de integrar o SDK 1.7.

Problemas conhecidos corrigidos

• A API History sempre retorna um nextPageToken, causando um loop infinito.
• O erro "O usuário cancelou o fluxo de permissões" ocorre ao tentar fazer login em uma nova conta.

Problemas conhecidos

• Para a Nest Cam interna/externa (com bateria ou com fio) e a Nest Doorbell (com bateria, 2ª geração), a opção "Tempo restante da bateria" não aparece nas configurações de bateria.
• A configuração de duração do toque é ignorada.
• A luz Philips BLE aparece incorretamente como "On-line" mesmo quando o dispositivo está off-line. Solução alternativa: não confie apenas no status on-line do tipo de dispositivo de casa inteligente (SHDT, na sigla em inglês). Em vez disso, use o mapa do serviço de estado do dispositivo de destino (TDSS) para dispositivos com a origem LOCAL_SYNC.

2025-12-22

  Versão Beta pública 1.6 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.47.30
• Firmware do hub do Google, Cast, Nest Wifi Pro: 3.75.479819
• Firmware do hub do Google, Cast, todos os outros hubs baseados no Cast: 3.77.505721
• Firmware do hub do Google, Fuchsia: 28.20250723.103.2100300
• Firmware do hub do Google, Google TV Streamer, 4K: UTTK.250729.004
• SDK do Android: home.android.sdk_GHP_1_6
• App Google Home: 1.6
• Biblioteca androidx.core: funciona com qualquer versão
• Versão do Matter: 1.4.1.0

Novos recursos

• Suporte ao traço de clima da API Automation. Adicionamos suporte ao traço "Clima" em ativações e condições de automação.
• Suporte a mais recursos de câmeras e campainhas: novas configurações (visão noturna, LED de status, janela de visualização, orientação, sensibilidade, duração do evento, toque).
• Login do Google iniciado pelo app para simplificar o fluxo de UX e eliminar verificações de usuários ativos.
• O modo sem hub permite que os usuários integrem e controlem determinados dispositivos Matter sem um hub independente.
• API Hub Activation para descobrir e ativar hubs.

Outras mudanças importantes

• O app de exemplo do Android adiciona configurações de câmera, automações predefinidas e suporte a ventilador e alto-falante.

Problemas conhecidos

• Os controles de dispositivo param de funcionar após longos períodos de uso. Solução alternativa: reinicie o hub.
• O comissionamento do dispositivo Matter pode falhar.
• O erro "User cancelled Permission flow" aparece ao tentar adicionar uma nova conta no app de exemplo para Android. Solução alternativa: adicione Contas do Google nas configurações do dispositivo Android.
• Uma câmera de segurança com fio Walmart onn comissionada usando o SDK das APIs Android Home não pode transmitir ao vivo pelo app Google Home.
• As câmeras comissionadas em apps das APIs Home não podem iniciar sessões de transmissão ao vivo no app Google Home.

2025-10-23

  Versão Beta pública 1.5.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.41.30
• Firmware do hub do Google, Google Cast: 3.76.495998
• Firmware do hub do Google, Fuchsia: 27.20250422.103.3600
• SDK do Android: home.android.sdk_1_5_1
• App Google Home: funciona com qualquer versão
• Biblioteca androidx.core: funciona com qualquer versão
• Versão do Matter: 1.4.1.0

Novos recursos

• A API de ativação do hub permite descobrir e ativar um hub do Google Home de forma programática na API Structure.

Outras mudanças importantes

• O app de exemplo do Android adiciona suporte para o tipo de dispositivo Campainha (On/Off, transmissão ao vivo, conversa bidirecional) e implementação da API Hub Activation.

Problemas conhecidos corrigidos

• O app de exemplo não está mostrando corretamente o status do dispositivo na visualização "Dispositivo".

2025-09-26

  Versão Beta pública 1.5.0 das APIs Home  

Esta versão inclui suporte para dispositivos de câmera, correções de bugs e melhora a qualidade da versão Beta do SDK do Android para APIs Home.

Versões mínimas

• Google Play Services: 25.37.31
• Firmware do hub do Google, Cast: 3.76.492738
• Firmware do hub do Google, Fuchsia: 27.20250422.103.3600
• SDK do Android: home.android.sdk_1_5
• App Google Home: funciona com qualquer versão
• Biblioteca androidx.core: funciona com qualquer versão
• Versão do Matter: 1.4.1.0

Novos recursos

• As ativações, condições e ações agora aceitam structs do Matter como parâmetros na API Automation.
• Tipo de dispositivo de câmera adicionado à API Device (transmissão ao vivo, conversa bidirecional, iniciar/parar gravação).

Outras mudanças importantes

• O app de exemplo do Android adiciona suporte para câmera, provisionamento de vários administradores e automação predefinida de OnOff.

Problemas conhecidos corrigidos

• Quando o hub ativo é removido à força, há um período de cinco minutos em que não é possível controlar alguns dispositivos. Após cinco minutos, a capacidade de controlar dispositivos é restaurada.
• Depois que o usuário seleciona uma cor em uma predefinição ou no seletor de temperatura da cor, a luz colorida estendida não atualiza a cor.

Problemas conhecidos

• Pode haver um aumento na latência do controle de dispositivos ao alternar do Wi-Fi para uma rede móvel.
• O controle de tipos de dispositivos de ventilador com tecnologia Cloud-to-Cloud pode não funcionar no app de exemplo.

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
• Firmware do hub do Google, Google Cast: 3.76.495998
• Firmware do hub do Google, 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

• Um novo DecommissionIneligibleReason foi definido para tentar desativar um dispositivo de várias fontes na API Device.

Problemas conhecidos corrigidos

• O app de exemplo do Android falha quando um usuário tenta definir um termostato para um modo que não é compatível.

Problemas conhecidos

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

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
• Firmware do hub do Google, Cast: 3.76.486931
• Firmware do hub do Google, 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

• As automações podem ser restritas para serem executadas um número finito de vezes na API Automation.
• A capacidade de remover programaticamente um dispositivo Matter na API Device.
• Remoção de membros HomeDevice descontinuados (trait(), isInRoom, isInStructure).
• O Home.hasPermissions() agora incorpora o acesso à estrutura do OAuth e as concessões de permissão do app.

Outras mudanças importantes

• O app de exemplo do Android exclui dispositivos somente Matter, renomeia dispositivos e substitui chamadas de API descontinuadas.

Problemas conhecidos corrigidos

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

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 o app e aguarde pelo menos 10 segundos.

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
• Firmware do hub do Google, Cast, Google Home, Google Home Mini e Google Nest Mini: 3.75.468362
• Firmware do hub do Google, Cast e Google Nest Audio: 3.75.476451
• Firmware do hub do Google, 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) e os traços e tipos de dispositivos do SDK (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.

Outras mudanças importantes

• O app de amostra do Android adiciona: os usuários podem desconectar e revogar as permissões do app.
• O app de exemplo do Android adiciona: artefatos do SDK atualizados 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".

05/06/2025

  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
• Firmware do hub do Google, Google Cast: 3.75.468222
• Firmware do hub do Google, 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

• Apresenta o traço SyntheticSwitch, que simplifica o processamento de eventos gerados por dispositivos Matter Switch e permite que os interruptores acionem iniciadores de automação.
• O traço ExtendedDoorLock tem uma mudança interruptiva: o tipo de dados do campo user_id foi alterado de String para Long. Os apps que usam esse atributo precisam ser recompilados.

Outras mudanças importantes

• O app de exemplo do Android adiciona funções para registrar o estado de estruturas, dispositivos, tipos, características e automações para facilitar a depuração.

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.
• No app de exemplo do Android, um dispositivo com connectivityState PARTIALLY_ONLINE era exibido como off-line. Esse estado agora é representado como on-line.

Problemas conhecidos

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

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
• Firmware do hub do Google, Google Cast: 3.75.468222
• Firmware do hub do Google, 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

• Adicionamos suporte para ativações de eventos recorrentes programados na API Automation, que permite aos desenvolvedores criar automações executadas periodicamente com base na hora do relógio, na hora solar e em condições baseadas em calendário, usando expressões cron.
• Adicionamos a capacidade de renomear dispositivos na API Device.
• Agora é possível renomear cômodos na API Structure.

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.

Problemas conhecidos

• O app Google Home falha com um FailedPreconditionException ao criar automações se o endereço residencial não estiver definido no app Google Home. Solução alternativa: verifique se o endereço residencial está presente usando a API Discovery antes de tentar criar automações.

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.1900601¹
• 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 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
  • As informações de dispositivos de nuvem para nuvem agora estão disponíveis no BasicInformationTrait.

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á gerada.
• Em um ambiente com várias estruturas e usuários, a troca entre estruturas e usuários pode resultar em nenhum dispositivo 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
• Versão mínima da biblioteca androidx.core: 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á gerada.
  • 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 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 que esperar muito tempo.
• 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
• Versão mínima da biblioteca androidx.core: 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 de streaming:
  • Fornece fluxos de eventos que notificam sobre estruturas, salas e dispositivos que foram adicionados, alterados e removidos.
  • Consulte Inscrever-se em eventos de relação de entidade.
• API Batch (experimental):
  • Permite que o desenvolvedor envie vários comandos em lotes que são executados simultaneamente.
  • Consulte Enviar vários comandos de uma vez.

Problemas conhecidos

• Ao carregar, criar e editar automações, os usuários podem ter que esperar muito tempo.
• 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 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.
  • 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 Google como o app 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 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 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
• Versão mínima da biblioteca androidx.core: 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 app 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

• A inicialização pode falhar se o app for minimizado durante o processo.
  • Solução alternativa: use a API suppressHalfSheetNotification() para suprimir notificações de meia página quando a API Commissioning for usada no seu app.
• Um problema do lado do servidor pode impedir que os comandos "Ok Google" funcionem nas automações.
• Ao usar um hub com Fuchsia que não tem dispositivos Matter na estrutura, se o hub ficar inativo por mais de 3 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.