2026-10-22
Versão em disponibilidade geral 1.11.1 das APIs do Google HomeEsta versão contém correções de bugs e melhora a qualidade da GA para o SDK do Android das APIs Home.
Versões mínimas
- Google Play Services: 26.40.32
- Firmware do hub do Google, Cast, Nest Wifi Pro: 3.78.556638
- Firmware do hub do Google, Cast e todos os outros hubs baseados em Cast: 3.79.558061
- Firmware do hub do Google, Fuchsia: 31.20260429.103.8713700
- Firmware do hub do Google, Google TV Streamer (4K): UTTK.260317.003
- SDK do Android: home.android.sdk_1_11_1.zip
- 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
- Suporte para criar, atualizar e excluir curvas de iluminação automatizadas que ajustam o brilho e a temperatura da cor ao longo do dia em ambientes ou dispositivos de iluminação específicos.
- Adicionamos orientações sobre como a plataforma lida com a exclusão automática de dados do usuário quando ele sai de uma estrutura ou exclui a Conta do Google, além de como os usuários podem exportar os dados usando o Google Takeout.
-
Suporte para configurar e recuperar a localidade do app usando
setLocale()egetLocale()para fluxos de interface hospedados pelo SDK, além de campos de texto localizados (localizedTextselocalizedBodies) em legendas geradas por IA e resumos de IA em eventos do Cloud. -
Suporte para controlar um
DeviceGroupcomo uma única entidade usando as partes do tipo de dispositivo, além de inspecionar as associações a grupos em dispositivos individuais e agrupar comandos em lote para os membros do grupo.
Outras mudanças importantes
Problemas conhecidos
-
Depois que uma câmera é reiniciada, o estado de conectividade dela pode ser informado como
PARTIAL_ONLINEem vez deONLINE. Todos os recursos de câmera na nuvem continuam funcionando normalmente, exceto a desativação do Matter.
2026-09-23
Versão 1.11 das APIs do Google Home em GAEsta versão contém correções de bugs e melhora a qualidade da GA para o SDK do Android das APIs Home.
Versões mínimas
- Google Play Services: 26.36.25
- Firmware do hub do Google, Cast, Nest Wifi Pro: 3.78.548779
- Firmware do hub do Google, Cast, todos os outros hubs baseados em Cast: 3.79.550760
- Firmware do Google Hub, Fuchsia: 31.20260429.103.8712702
- Firmware do hub do Google, Google TV Streamer (4K): UTTK.260317.003
- SDK do Android: home.android.sdk_GHP_1_11
- 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
Atualizações importantes
-
A partir da versão v1.11, as APIs Home exigem o Kotlin 2.4.0. Se você estiver compilando um app das APIs Home com uma versão anterior do Kotlin, use a opção de compilador
-Xskip-metadata-version-checkpara suprimir erros relacionados a metadados. - A partir da versão v1.11, para manter a compatibilidade com as corrotinas do Kotlin mais recentes, os desenvolvedores precisam atualizar o arquivo do Gradle para importar as bibliotecas kotlinx.coroutines. Um erro de tempo de execução de bloqueio vai ocorrer em todos os apps Kotlin que usam as APIs Home se essa atualização não for feita.
Novos recursos
Outras mudanças importantes
2026-09-16
Lançamos dois novos servidores MCP. O MCP para casa permite que agentes pessoais interajam com sua casa inteligente de forma segura, enquanto o MCP para desenvolvedores de casa inteligente disponibiliza a documentação do Centro para Desenvolvedores de Casa Inteligente e outros recursos de casa inteligente para que seus agentes favoritos pesquisem e consultem.
Novos recursos
2026-09-16
O app de exemplo para Android das APIs Home foi atualizado para a versão 1.10.1 das APIs Home.
App de exemplo
2026-08-28
Versão 1.10.1 das APIs do Google Home em GAEsta versão contém correções de bugs e melhora a qualidade da GA para o SDK do Android das APIs Home.
Versões mínimas
- Google Play Services: 26.34.30
- Firmware do hub do Google, Cast, Nest Wifi Pro: 3.78.548779
- Firmware do hub do Google, Cast, todos os outros hubs baseados em Cast: 3.79.547681
- Firmware do Google Hub, Fuchsia: 31.20260429.103.8712702
- Firmware do hub do Google, Google TV Streamer (4K): UTTK.260317.003
- SDK do Android: home.android.sdk_GHP_1_10_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
- Versão do Matter: suporte experimental para 1.5.0
Atualizações importantes
Novos recursos
- Os parâmetros de comando dinâmicos agora são compatíveis com a API Automation.
- A lógica if/else agora é compatível com a API Automation.
Outras mudanças importantes
2026-08-07
O app de exemplo para Android das APIs Home foi atualizado para a versão 1.10.
App de exemplo
2026-08-03
Versão 1.10 das APIs do Google Home para GAEsta versão contém correções de bugs e promove o SDK do Android das APIs Home para a qualidade de disponibilidade geral.
Versões mínimas
- Google Play Services: 26.28.31
- Firmware do hub do Google, Cast, Nest Wifi Pro: 3.78.518349
- Firmware do hub do Google, Cast, todos os outros hubs baseados em Cast: 3.78.540761
- Firmware do Google Hub, Fuchsia: 30.20260121.103.1602904
- Firmware do hub do Google, Google TV Streamer (4K): UTTK.260317.003
- SDK do Android: home.android.sdk_GHP_1_10
- 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
2026-07-09
A flag forceLaunch foi descontinuada. Os aplicativos precisam migrar para
o tipo enumerado ForcePermissionFlow para especificar o comportamento da interface de consentimento.
Próximas mudanças
-
API descontinuada:o método
requestPermissions(forceLaunch: Boolean, ...)foi descontinuado no SDK do Google Home para Android. -
Etapa de migração:substitua as flags booleanas por
ForcePermissionFlow.FORCE_LAUNCH(paratrue) ouForcePermissionFlow.DO_NOT_FORCE_LAUNCH(parafalse).
2026-07-08
O guia de dispositivos de roteador de borda para Android já disponível.
Novo conteúdo
2026-07-07
O app de exemplo para Android das APIs Home foi atualizado para a versão 1.9.1 das APIs Home.
App de exemplo
2026-06-26
Lançamento da versão Beta pública 1.9.1 das APIs do Google HomeEsta versão contém correções de bugs e melhora a qualidade da versão Beta do SDK do Android das APIs do Google Home.
Versões mínimas
- Google Play Services: 26.24.22
- Firmware do hub do Google, Cast, Nest Wifi Pro: 3.78.518349
- Firmware do hub do Google, Cast, todos os outros hubs baseados em Cast: 3.78.538123
- Firmware do Google Hub, Fuchsia: 30.20260121.103.1602904
- Firmware do hub do Google, Google TV Streamer (4K): UTTK.250729.004 (14748786)
- SDK do Android: home.android.sdk_1_9_1.zip
- 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
- Câmera e campainha: status de troca da bateria
- Suporte a capturas de tela da câmera e da campainha para uso como prévias durante a configuração da Zona de Atividade e das imagens ao vivo.
Problemas conhecidos corrigidos
- O comissionamento do Pareamento rápido não é compatível com os modelos de dispositivo Google Nest Cam Outdoor (com fio, 2ª geração), Google Nest Cam Indoor (com fio, 3ª geração) e Doorbell (com fio, 3ª geração).
2026-06-09
O app de exemplo para Android das APIs Home foi atualizado para a versão 1.9.0.
App de exemplo
2026-05-29
Versão Beta pública 1.9 das APIs do Google HomeEsta versão contém correções de bugs e melhora a qualidade da versão Beta do SDK do Android das APIs do Google Home.
Versões mínimas
- Google Play Services: 26.20.31
- Firmware do hub do Google, Cast, Nest Wifi Pro: 3.78.518349
- Firmware do hub do Google, Cast, todos os outros hubs baseados em Cast: 3.78.526062
- Firmware do Google Hub, Fuchsia: 30.20260121.103.1602904
- Firmware do hub do Google, Google TV Streamer (4K): UTTK.250729.004 (14748786)
- SDK do Android: home.android.sdk_GHP_1_9
- 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
- Configurações de câmera e campainha: tipo de montagem de câmera
- Configurações da câmera e da campainha: Avisos sobre visitas
- Configurações da câmera e da campainha: preferência de qualidade da transmissão ao vivo
- Respostas rápidas da campainha
- Indicação de estrutura para permitir que os parceiros pré-selecionem estruturas para o fluxo de permissões
- Suporte para dispositivos com várias partes em automações
-
Atualizações nos seguintes atributos personalizados do Google:
ExtendedFanControl,ExtendedThermostat -
Atualizações nos seguintes atributos do Matter:
ArmDisarm,FanControl,Thermostat,ThermostatFanControl,ThermostatUserInterfaceConfiguration
Problemas conhecidos
- O comissionamento do Pareamento rápido não é compatível com os modelos de dispositivo Google Nest Cam Outdoor (com fio, 2ª geração), Google Nest Cam Indoor (com fio, 3ª geração) e Doorbell (com fio, 3ª geração).
2026-05-26
O app de exemplo para Android das APIs Home foi atualizado para a versão 1.8.1 das APIs Home.
App de exemplo
2026-05-01
Versão Beta pública 1.8.1 das APIs do Google HomeEsta versão contém correções de bugs e melhora a qualidade da versão Beta do SDK do Android das APIs do Google 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, 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 atributo Thermostat agora é compatível com os recursos Read/Update, On/Off 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 que causa instabilidade na rede e tempos de resposta lentos.
Problemas conhecidos
- Não é possível configurar alguns dispositivos usando o Google TV Streamer (4K).
- Quando o hub é um Nest Wifi Pro, um Google Nest Hub ou um Google Nest Hub Max, o app Google Home mostra os dispositivos de várias partes como vários blocos.
2026-04-10
O app de exemplo para Android das APIs Home foi atualizado para a versão 1.8.
App de exemplo
2026-04-09
Lançamento 1.8 da versão Beta pública das APIs do Google HomeEsta versão contém correções de bugs e melhora a qualidade da versão Beta do SDK do Android das APIs do Google 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, 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 de várias partes na API Device.
- Configuração da Zona de Atividade da câmera e da campainha 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 do usuário.
- 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 HomeEsta versão contém correções de bugs e melhora a qualidade da versão Beta do SDK do Android das APIs do Google 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, todos os outros hubs baseados no 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.
- Horário da ú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 do termostato na API Device.
Outras mudanças importantes
- O modo sem hub foi removido.
App de exemplo
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 está presente nas configurações de bateria.
- A configuração de duração do sino é 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 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 do usuário.
- 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 sino é definida, o dispositivo não toca pelo tempo especificado.
2026-02-13
O app de exemplo para Android das APIs Home foi atualizado para a versão 1.7.
App de exemplo
2026-02-09
Versão Beta pública 1.7 das APIs HomeEsta versão contém correções de bugs e melhora a qualidade da versão Beta do SDK do Android das APIs do Google 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 hub do Google, 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 dispositivo e atributos, algumas automações agora podem ser executadas localmente na API Automations.
- Ativação da configuração inicial pelo usuário (OOBE, na sigla em inglês) da câmera em apps na API Device.
- Temas de campainha para câmeras e campainhas 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 dispositivo receberam acesso do usuário na API Permissions.
Outras mudanças importantes
-
HomeException.unsupportedfoi substituído porHomeException.unimplementedpara se alinhar aos códigos do erro padrão. - O gerador de código empacotado para atributos personalizados mudou na versão 1.7. Os desenvolvedores que têm atributos personalizados precisam recompilá-los depois de integrar o SDK 1.7.
Problemas conhecidos corrigidos
-
A API History sempre retorna um
nextPageToken, causando um loop infinito. - O erro "User cancelled Permission flow" 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 está presente nas configurações de bateria.
- A configuração de duração do sino é ignorada.
-
A luz Philips BLE aparece incorretamente como "On-line", mesmo quando o dispositivo está off-line. Alternativa: não dependa apenas do 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, na sigla em inglês) para dispositivos com a origem
LOCAL_SYNC.
2025-12-22
Lançamento 1.6 da versão Beta pública das APIs do Google HomeEsta versão contém correções de bugs e melhora a qualidade da versão Beta do SDK do Android das APIs do Google 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 e todos os outros hubs baseados em 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 atributo de clima da API Automation. Adicionamos suporte ao atributo Clima nas ativações e condições de automação.
- Suporte para 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, campainha).
- Login do Google iniciado pelo app para simplificar o fluxo de UX e eliminar as 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 para Android adiciona configurações de câmera, automações predefinidas e suporte a ventiladores e alto-falantes.
Problemas conhecidos
- Os controles do dispositivo param de funcionar após períodos prolongados de uso. Solução alternativa: reinicie o hub.
- A ativação 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 pelas configurações do dispositivo Android.
- Uma câmera de segurança com fio Walmart onn configurada usando o SDK das APIs Home para Android não pode fazer transmissões ao vivo pelo app Google Home.
- As câmeras comissionadas em apps de APIs Home não podem iniciar sessões de transmissão ao vivo no app Google Home.
2025-10-23
Versão 1.5.1 Beta pública das APIs HomeEsta versão contém correções de bugs e melhora a qualidade da versão Beta do SDK do Android das APIs do Google Home.
Versões mínimas
- Google Play Services: 25.41.30
- Firmware do hub do 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
Outras mudanças importantes
- O app de exemplo para Android adiciona suporte ao tipo de dispositivo de campainha (OnOff, transmissão ao vivo, conversa) 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 de dispositivos.
2025-09-26
Versão Beta pública 1.5.0 das APIs HomeEsta versão apresenta suporte para dispositivos de câmera, contém correções de bugs e melhora a qualidade 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.
- O tipo de dispositivo de câmera foi adicionado à API Device (transmissão ao vivo, conversa, iniciar/interromper gravação).
Outras mudanças importantes
-
O app de exemplo para Android agora oferece suporte para câmera, comissionamento de vários administradores e automação predefinida do
OnOff.
Problemas conhecidos corrigidos
- Quando o hub ativo é removido à força, há uma janela de cinco minutos em que não é possível controlar alguns dispositivos. Após cinco minutos, a capacidade de controlar os dispositivos é restaurada.
- Depois que o usuário seleciona uma cor de uma predefinição ou do seletor de temperatura da cor, a luz de cor estendida não atualiza a cor.
Problemas conhecidos
- Pode haver um aumento na latência de controle do dispositivo ao mudar do Wi-Fi para uma rede móvel.
- O controle de tipos de dispositivo de ventilador compatíveis com a integração de nuvem para nuvem pode não funcionar no app de exemplo.
2025-08-29
Versão Beta pública 1.4.1 das APIs HomeEsta versão contém correções de bugs e melhora a qualidade da versão Beta do SDK do Android das APIs Google Home.
Versões mínimas
- Google Play Services: 25.33.32
- Firmware do hub do 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
Problemas conhecidos corrigidos
- O app de exemplo para Android falha quando um usuário tenta definir um termostato para um modo incompatível.
Problemas conhecidos
- Quando o hub ativo é removido à força, há uma janela de cinco minutos em que não é possível controlar alguns dispositivos. Após cinco minutos, a capacidade de controlar os dispositivos é restaurada.
2025-07-31
Versão Beta pública 1.4.0 das APIs HomeEsta versão contém correções de bugs e melhora a qualidade da versão Beta do SDK do Android das APIs Google 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 limitadas para serem executadas até um número finito de vezes na API Automation.
- A capacidade de remover programaticamente um dispositivo Matter na API Device.
-
Os membros
HomeDevicedescontinuados foram removidos (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 para 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 sair de um smartphone e fazer login novamente, um app das APIs Home não consegue controlar 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 HomeEsta versão contém correções de bugs e melhora a qualidade da versão 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, 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 as características do SDK e os 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.
Outras mudanças importantes
- O app de exemplo do Android adiciona: os usuários podem desconectar e revogar permissões do app.
-
Adições ao app de exemplo para Android: artefatos do SDK atualizados para incluir
play-services-home-17.0.0eplay-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 do Google HomeEsta versão contém correções de bugs e melhora a qualidade da versão Beta do SDK do Android das APIs Home.
Versões mínimas
- Google Play Services: 25.19.32
- Firmware do hub do 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
-
Introduz o atributo
SyntheticSwitch, que simplifica o processamento de eventos gerados por dispositivos de interruptor do Matter e permite que os interruptores acionem as ativações de automação. -
O atributo
ExtendedDoorLocktem uma alteração interruptiva: o tipo de dados do campouser_idmudou deStringparaLong. Os apps que usam essa característica precisam ser recompilados.
Outras mudanças importantes
- O app de exemplo para Android adiciona funções para registrar o estado de estruturas, dispositivos, tipos, atributos e automações para facilitar a depuração.
Problemas conhecidos corrigidos
-
O app Google Home falha com um
FailedPreconditionExceptionao criar automações se o local da casa não estiver definido no app. -
No app de exemplo do Android, um dispositivo com
connectivityStatePARTIALLY_ONLINEaparecia como off-line. Esse estado agora é representado como on-line.
Problemas conhecidos
- No app de exemplo para Android, o botão "Criar automação" às vezes precisa ser tocado várias vezes para ser acionado.
2025-05-12
Versão Beta pública 1.3 das APIs do Google HomeEsta versão contém correções de bugs e melhora a qualidade da versão Beta do SDK do Android das APIs Home.
Versões mínimas
- Google Play Services: 25.16.33
- Firmware do hub do 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 programados recorrentes na API Automation, que permitem que os desenvolvedores criem automações que são executadas periodicamente com base no horário do relógio, no horário solar e em condições baseadas no calendário, usando expressões
cron. - Adicionamos a capacidade de renomear dispositivos na API Device.
- Adicionamos a capacidade de renomear ambientes na API Structure.
Problemas conhecidos corrigidos
- Pode haver um aumento na latência de controle do dispositivo ao mudar do Wi-Fi para uma rede móvel.
- Após a redefinição de fábrica de um hub, os dispositivos podem aparecer como off-line.
Problemas conhecidos
2025-04-09
Versão Beta pública 1.2.1 das APIs do Google HomeEsta versão contém correções de bugs e melhora a qualidade da versão Beta do SDK do Android das APIs Home.
Versões mínimas
- Google Play Services: 25.09.33
- Versões mínimas de firmware do hub do Google:
- Cast: 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
Novos recursos
- Melhoria no desempenho ao carregar objetos do Home Graph.
- API Automation
- Adicionamos suporte para filtros de entidade, que permitem que as automações selecionem dispositivos dinamicamente com base em critérios especificados na automação.
- API Device
- As informações do dispositivo de nuvem para nuvem agora estão disponíveis no
BasicInformationTrait.
- As informações do dispositivo de nuvem para nuvem agora estão disponíveis no
Problemas conhecidos
- Pode haver um aumento na latência de controle do dispositivo ao mudar do Wi-Fi para uma rede móvel.
- Após a redefinição de fábrica de um hub, 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
HomeExceptioncomcode 14: UNKNOWNe a mensagem "Nenhuma rota encontrada" será gerada. - Em um ambiente com várias estruturas e usuários, alternar 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 do Google HomeEsta versão contém correções de bugs e melhora a qualidade da versão 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 de firmware do hub do Google:
- Versão do 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:os tipos de dispositivo e clusters provisórios do Matter não são compatíveis.
Novos recursos
- API Automation:
- Suporte para períodos e datas parciais em condições de automação. Consulte Usar datas com between.
- Nas versões anteriores, a API Discovery retornava um
NumberSetConstraintpara alguns campos de bitmap quando deveria ter retornado umBitmapConstraint. Esses campos agora retornam umBitmapConstraint, como esperado. Isso é limitado a bitmapsoptionsMaskeoptionsOverridenos comandos de atributoLevelControl.
Problemas conhecidos
- Pode haver um aumento na latência de controle do dispositivo ao mudar do Wi-Fi para uma rede móvel.
- Após a redefinição de fábrica de um hub, 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
HomeExceptioncomcode 14: UNKNOWNe a mensagem "Nenhuma rota encontrada" será gerada.- Solução alternativa: chame a API Discovery apenas quando precisar de candidatos de automação. Não faça pré-busca nem armazene em cache as 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, alternar entre estruturas e usuários pode resultar em nenhum dispositivo sendo retornado.
Problemas conhecidos corrigidos
- Na primeira vez que um app das APIs do Google 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 enfrentar longos tempos de espera.
- Os usuários que iniciam o fluxo de configuração no app Câmera precisam ler o QR code duas vezes para concluir o comissionamento 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 do Google HomeEsta versão contém correções de bugs e melhora a qualidade da versão 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 de firmware do hub do Google:
- Versão do 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:os tipos de dispositivo e clusters provisórios do Matter não são compatíveis.
Novos recursos
- API Streaming:
- Fornece streams de eventos que notificam sobre estruturas, ambientes e dispositivos que foram adicionados, alterados e removidos.
- Consulte Inscrever-se em eventos de relação de entidades.
- API Batching (experimental):
- Permite que o desenvolvedor envie vários comandos em lotes que são executados simultaneamente.
- Consulte Enviar vários comandos de uma só vez.
Problemas conhecidos
- Ao carregar, criar e editar automações, os usuários podem enfrentar longos tempos de espera.
- Os usuários que iniciam o fluxo de configuração no app Câmera precisam ler o QR code duas vezes para concluir o comissionamento 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 para Google TV podem não funcionar em automações que usam o atributo
MediaPlayback. - Em uma estrutura que contém apenas um hub do Google:
- Os dispositivos Matter podem aparecer como 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 preciso, e
seu app pode informar um estado diferente daquele informado por um app 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
Atualização das orientações para inicialização das APIs do Google Home.
Deixamos mais claro que uma instância de uma Home 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
Versão Beta pública das APIs do Google HomeDurante 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 versão Beta do SDK do Android para as APIs do Google 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 de 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
- Versão mínima da biblioteca
androidx.core: 1.10.0 - Versão do Matter:
1.3.0.0
- Observação: os tipos de dispositivos e clusters provisórios do Matter 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 para Google TV podem não funcionar em automações que usam o atributo
MediaPlayback. - Em uma estrutura que contém apenas um hub do Google:
- Os dispositivos Matter podem aparecer como 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 preciso e pode
informar um estado diferente daquele 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
- O comissionamento pode falhar se o app for minimizado durante o processo.
- Solução alternativa: use a
API
suppressHalfSheetNotification()para suprimir as notificações de meia página quando a API Commissioning for usada no app.
- Solução alternativa: use a
API
- Um problema do lado do servidor pode impedir que as ativações do Ok Google funcionem em automações.
- Ao usar um hub com o Fuchsia que não tem dispositivos Matter na estrutura, se o hub ficar inativo por mais de 3 horas, o comissionamento do primeiro dispositivo Matter vai resultar em um dispositivo Matter off-line.
- Depois que uma redefinição 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.