Notas da versão do SDK das APIs Home para iOS

2026-05-06

O app de exemplo do iOS 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 Home  

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

Versões mínimas

Novos recursos

Problemas conhecidos corrigidos

  • Quando o app de exemplo é colocado em segundo plano e depois em primeiro plano, a transmissão ao vivo é interrompida.
  • O app Google Home pode falhar se um usuário revogar permissões em "Minha conta". A solução alternativa é reiniciar o app.
  • A luz Philips BLE não mostra o estado correto.

Problemas conhecidos

  • Não é possível comissionar alguns dispositivos usando o Google TV Streamer 4K.
  • O campo de endereço IP não é preenchido para alguns dispositivos de campainha.
  • 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 iOS das APIs Home foi atualizado para a versão 1.8 das APIs Home.

App de exemplo

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

Versões mínimas

  • 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 iOS: home_platform_ios_1.8.0_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

Problemas conhecidos corrigidos

  • A Nest Cam Outdoor (com fio, 2ª geração) pode não ser provisionada. O bloco fica esmaecido, mensagens de erro aparecem e a câmera não pode ser controlada.
  • Não é possível mudar as unidades de temperatura (C/F) do Google Nest Learning Thermostat (4ª geração) v4.
  • 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.
  • Depois de trocar de usuário no mesmo controlador, os blocos de dispositivos do GHA ficam off-line. Em casas multiusuário onde os usuários estão usando o mesmo controle, os dispositivos off-line podem ficar assim até que o app seja reiniciado.

Problemas conhecidos

  • O comissionamento de dispositivos 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 iOS das APIs Home.

Versões mínimas

  • iOS: iOS 17.0 ou versões mais recentes, Xcode 15.3 ou versões mais recentes
  • Para o provisionamento do Matter: iOS 17.6 ou mais recente
  • 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.260120.001
  • SDK do iOS: home_platform_ios_1.7.1
  • Versão mínima do app Google Home: 1.7.1
  • Versão do Matter: 1.4.1.0
  • Versão do Matter: suporte experimental para 1.5.0

Novos recursos

Outras mudanças importantes

  • Fluxo de consentimento de assinaturas simplificado.

App de exemplo

Problemas conhecidos corrigidos

  • A filtragem do histórico não mostra todos os eventos esperados para o dia e o dispositivo no carregamento inicial. Solução alternativa: limpe todos os filtros para que todos os eventos apareçam.
  • 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.

Problemas conhecidos

  • A Nest Cam Outdoor (com fio, 2ª geração) pode não ser provisionada. O bloco fica esmaecido, mensagens de erro aparecem e a câmera não pode ser controlada.
  • Não é possível mudar as unidades de temperatura (C/F) do Google Nest Learning Thermostat (4ª geração) v4.
  • 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.
  • Depois de trocar de usuário no mesmo controlador, os blocos de dispositivos do GHA ficam off-line. Em casas multiusuário onde os usuários estão usando o mesmo controle, os dispositivos off-line podem ficar assim até que o app seja reiniciado.
  • O comissionamento de dispositivos Matter pode falhar.

2026-02-13

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

App de exemplo

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

Versões mínimas

  • iOS: iOS 17.0 ou versões mais recentes, Xcode 15.3 ou versões mais recentes
  • Para o provisionamento do Matter: iOS 17.6 ou mais recente
  • Firmware do hub do Google, Cast, Nest Wifi Pro: 3.76.508025
  • Firmware do hub do Google, Cast e 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 iOS: home_platform_ios_1.7.0
  • Versão mínima do app Google Home: 1.7
  • Versão do Matter: 1.4.1.0
  • Versão do Matter: suporte experimental para 1.5.0

Novos recursos

Outras mudanças importantes

Problemas conhecidos corrigidos

  • A API History sempre retorna um nextPageToken, causando um loop infinito.
  • Um erro de "stream desconectado" pode interromper sessões de stream da câmera de longa duração.
  • O comissionamento do dispositivo Matter falha durante a execução de "CommissionDeviceCommand".

Problemas conhecidos

  • A filtragem do histórico não mostra todos os eventos esperados para o dia e o dispositivo no carregamento inicial. Solução alternativa: limpe todos os filtros para que todos os eventos apareçam.
  • 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 versão correta do software pode não aparecer em "Versão atual do software do dispositivo da câmera".
  • A configuração de duração do toque é ignorada.
  • Desligar uma câmera Nest Doorbell (com bateria, 2ª geração) resulta em uma tela congelada.
  • As configurações da câmera Nest Cam IQ mostram apenas três temas de campainha, mas muitos outros aparecem.
  • 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 iOS das APIs Home.

Versões mínimas

  • iOS: iOS 17.0 ou versões mais recentes, Xcode 15.3 ou versões mais recentes
  • Para o provisionamento do Matter: iOS 17.6 ou mais recente
  • 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 iOS: home_platform_ios_1.6.0
  • Versão mínima do app Google Home: 1.6
  • Versão do Matter: 1.4.1.0

Novos recursos

Outras mudanças importantes

  • O app de exemplo do iOS adiciona mais configurações para câmera e campainha, integrando o SDK por padrão usando o Swift Package Manager.

Problemas conhecidos corrigidos

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

22/10/2025

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

Versões mínimas

  • iOS: iOS 17.0 ou versões mais recentes, Xcode 15.3 ou versões mais recentes
  • Para o provisionamento do Matter: iOS 17.6 ou mais recente
  • Firmware do hub do Google, Google Cast: 3.76.495998
  • Firmware do hub do Google, Fuchsia: 27.20250422.103.3600
  • SDK do iOS: home_platform_ios_1.5.1.zip
  • Versão mínima do app Google Home: funciona com qualquer versão
  • Versão do Matter: 1.4.1.0

Novos recursos

Problemas conhecidos corrigidos

  • Ao usar o app de exemplo, a transmissão ao vivo falhava inesperadamente.

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.
  • Ocorreu um erro ao comissionar um dispositivo Matter over Thread usando a API Home do iOS. Solução alternativa: adicione o roteador de borda Thread pelo GHA do iOS no mesmo smartphone.

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

Versões mínimas

  • iOS: iOS 17.0 ou versões mais recentes, Xcode 15.3 ou versões mais recentes
  • Para o provisionamento do Matter: iOS 17.6 ou mais recente
  • Firmware do hub do Google, Google Cast: 3.76.495998
  • Firmware do hub do Google, Fuchsia: 27.20250422.103.3600
  • SDK do iOS: home_platform_ios_1.5.0.zip
  • Versão mínima do app Google Home: funciona com qualquer versão
  • Versão do Matter: 1.4.1.0

Novos recursos

Outras mudanças importantes

  • O app de amostra do iOS adiciona suporte para o tipo de dispositivo de câmera e a ativação do hub.

Problemas conhecidos corrigidos

  • Ocorreu um erro ao criar uma automação, e um tipo de dispositivo desconhecido estava aparecendo incorretamente como uma opção selecionável.

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.
  • Ocorreu um erro ao comissionar um dispositivo Matter over Thread usando a API Home do iOS. Solução alternativa: adicione o roteador de borda Thread pelo GHA do iOS no mesmo smartphone.

2025-08-28

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

Versões mínimas

  • iOS: iOS 17.0 ou versões mais recentes, Xcode 15.3 ou versões mais recentes
  • Para o provisionamento do Matter: iOS 17.6 ou mais recente
  • Firmware do hub do Google, Google Cast: 3.76.495998
  • Firmware do hub do Google, Fuchsia: 27.20250422.103.3600
  • SDK do iOS: home_platform_ios_1.4.1.zip
  • Versão mínima do app Google Home: funciona com qualquer versão
  • Versão do Matter: 1.4.1.0

Novos recursos

Outras mudanças importantes

  • O app de exemplo do iOS adiciona o controle do termostato.

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.
  • Ocorreu um erro ao comissionar um dispositivo Matter over Thread usando a API Home do iOS. Solução alternativa: adicione o roteador de borda Thread pelo GHA do iOS no mesmo smartphone.

2025-07-30

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

Versões mínimas

  • iOS: iOS 17.0 ou versões mais recentes, Xcode 15.3 ou versões mais recentes
  • Para o provisionamento do Matter: iOS 17.6 ou mais recente
  • Firmware do hub do Google Cast: 3.75.456944
  • Firmware do hub do Google, Fuchsia: 24.20241009.103.1900601
  • SDK do iOS: home_platform_ios_1.4.0.zip
  • Versão mínima do app Google Home: funciona com qualquer versão
  • Versão do Matter: 1.4.0.0

Novos recursos

Outras mudanças importantes

  • O app de exemplo do iOS não permite mais excluir dispositivos somente Matter.

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.
  • Ocorreu um erro ao comissionar um dispositivo Matter over Thread usando a API Home do iOS. Solução alternativa: adicione o roteador de borda Thread pelo GHA do iOS no mesmo smartphone.

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 da versão Beta para o SDK do iOS das APIs Home.

Versões mínimas

  • iOS: iOS 16.4 ou mais recente, Xcode 15.3 ou mais recente
  • Firmware do hub do Google Cast: 3.75.456944
  • Firmware do hub do Google, Fuchsia: 24.20241009.103.1900601
  • SDK do iOS: home_platform_ios_1.3.2.zip
  • Versão mínima do app Google Home: funciona com qualquer versão
  • Versão do Matter: 1.4.0.0

Novos recursos

Problemas conhecidos corrigidos

  • Os termostatos com suporte de nuvem para nuvem podem não funcionar.

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.
  • Ocorreu um erro ao comissionar um dispositivo Matter over Thread usando a API Home do iOS. Solução alternativa: adicione o roteador de borda Thread pelo GHA do iOS no mesmo smartphone.

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 da versão Beta para o SDK do iOS das APIs Home.

Versões mínimas

Outras mudanças importantes

Problemas conhecidos corrigidos

  • A versão do GHA para iOS pode falhar durante mudanças de rede local para Wi-Fi ou ao alternar entre apps.

Problemas conhecidos

  • Pode haver um aumento na latência do controle de dispositivos ao alternar do Wi-Fi para uma rede móvel.
  • Os termostatos com suporte de nuvem para nuvem podem não funcionar.
  • O controle de tipos de dispositivos de ventilador com tecnologia Cloud-to-Cloud pode não funcionar no app de exemplo.
  • Ocorreu um erro ao comissionar um dispositivo Matter over Thread usando a API Home do iOS. Solução alternativa: adicione o roteador de borda Thread pelo GHA do iOS no mesmo smartphone.

09/05/2025

  Versão Beta pública 1.3 das APIs Home  

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

Versões mínimas

Novos recursos

Problemas conhecidos corrigidos

  • Ao conceder permissões na versão iOS do app Google Home, os botões "Saiba mais" e "Voltar" podem não responder. Solução alternativa: pressione e mantenha pressionado o link "Saiba mais" para abrir no navegador do sistema ou toque no botão de fechar no canto superior esquerdo para sair da visualização.
  • O player de vídeo básico pode não funcionar no app de exemplo.
  • O controle de dispositivos de proteção de janelas com suporte de nuvem para nuvem pode não funcionar.
  • Revogar a permissão enquanto o app Google Home está aberto causa uma falha.

Problemas conhecidos

  • Pode haver um aumento na latência do controle de dispositivos ao alternar do Wi-Fi para uma rede móvel.
  • Os termostatos com suporte de nuvem para nuvem podem não funcionar.
  • O controle de tipos de dispositivos de ventilador com tecnologia Cloud-to-Cloud pode não funcionar no app de exemplo.
  • A versão do GHA para iOS pode falhar durante mudanças de rede local para Wi-Fi ou ao alternar entre apps.

2025-04-09

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

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

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

Versões mínimas

  • Agrega até connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SDK do Matter SHA
  • iOS: iOS 16.4 ou mais recente, Xcode 15.3 ou mais recente
  • 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 iOS: home_platform_ios_1.0_1.zip
  • Versão mínima do app Google Home: funciona com qualquer versão
  • Versão do Matter: 1.4.0.0
    • Observação:não há suporte para tipos de dispositivos e clusters provisórios do Matter.

Problemas conhecidos

  • Pode haver um aumento na latência do controle de dispositivos ao alternar do Wi-Fi para uma rede móvel.
  • Ao conceder permissões na versão iOS do app Google Home, os botões Saiba mais e "Voltar" podem não responder.
    • Solução alternativa: pressione e mantenha pressionado o link Saiba mais para abrir no navegador do sistema ou toque no botão de fechar no canto superior esquerdo para sair da visualização.
  • Revogar a permissão enquanto o app Google Home está aberto vai causar uma falha no app.
  • O player de vídeo básico pode não funcionar no app de exemplo.
  • Os termostatos com suporte de nuvem para nuvem podem não funcionar.
  • O controle de tipos de dispositivos de ventilador com tecnologia Cloud-to-Cloud pode não funcionar no app de exemplo.
  • O controle de dispositivos de proteção de janelas com suporte de nuvem para nuvem pode não funcionar.
  • A versão do GHA para iOS pode falhar durante mudanças de rede local para Wi-Fi ou ao alternar entre apps.

Problemas conhecidos corrigidos

  • Não é possível nomear nem renomear dispositivos.
  • Para o provisionamento, o primeiro dispositivo Matter em uma estrutura precisa ser provisionado usando o app Google Home para iOS. No momento, as APIs Home não conseguem criar uma nova estrutura, apenas adicionar a uma estrutura existente para estruturas criadas antes de 2023. As estruturas criadas após 2023 não são afetadas por esse problema.