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

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

  • Versões mínimas do firmware do hub do Google:
    • Transmitir:
      • Nest Wifi Pro: 3.78.518349
      • Todos os outros hubs baseados no Cast: 3.78.526062
    • Fuchsia: 29.20251023.103.2101601
    • 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, com 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 não é possível controlar a câmera.
  • 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 na parte de cima e o botão "Voltar" ficam encobertos por um cabeçalho. Os usuários talvez não consigam voltar ou ver os principais elementos da interface do usuário.
  • 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 usam o mesmo controle, os dispositivos podem ficar off-line 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
  • Versões mínimas do firmware do hub do Google:
    • Transmitir:
      • Nest Wifi Pro: 3.78.518349
      • Todos os outros hubs baseados no Cast: 3.78.516526
    • Fuchsia: 29.20251023.103.2201
    • 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, com suporte experimental para 1.5.0.

Novos recursos

Outras mudanças importantes

  • Fluxo de consentimento de assinaturas simplificado.
  • App de exemplo das APIs Home para iOS v1.7.1. Consulte o lançamento do GitHub para mais detalhes.

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 está presente nas configurações de bateria.

Problemas conhecidos

  • A Nest Cam Outdoor (com fio, 2ª geração) pode não ser provisionada. O bloco fica acinzentado, mensagens de erro aparecem e não é possível controlar a câmera.
  • 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 na parte de cima e o botão "Voltar" ficam ocultos por um cabeçalho. Os usuários talvez não consigam voltar ou ver elementos importantes da interface do usuário.
  • 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 podem ficar off-line 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.

Consulte o lançamento do GitHub para ver as notas 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 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
  • Versões mínimas do firmware do hub do Google:
    • Transmitir:
      • Nest Wifi Pro: 3.76.508025
      • Todos os outros hubs baseados no Cast: 3.77.510748
    • Fuchsia: 29.20251023.103.2100
    • 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, com 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
  • Desativar 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 fonte 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
  • Versões mínimas do firmware do hub do Google:
    • Transmitir:
      • Nest Wifi Pro: 3.75.479819
      • Todos os outros hubs baseados no Cast: 3.77.505721
    • Fuchsia: 28.20250723.103.2100300
    • 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

  • API Automation
    • Adição de suporte para filtros de entidade, que permitem que as automações selecionem dispositivos de forma dinâmica com base em critérios especificados na automação.
    • Adicionamos suporte ao traço "Clima" em ativações e condições de automação. Consulte Início com base no clima.
  • API Device
    • Compatibilidade com mais recursos de dispositivos de câmera e campainha
      • Novas configurações:
        • Ativar/desativar a Visão noturna.
        • Brilho do LED de status.
        • Janela de visualização da câmera.
        • Orientação da imagem.
        • Sensibilidade de ativação.
        • Duração máxima do evento.
        • Sons de sino.

        Consulte o guia de dispositivos de câmera para iOS para mais informações.

  • API Structure
  • App de amostra do iOS
    • Suporte para mais configurações
      • Câmera:
        • Ativar/desativar o microfone.
        • Ativar/desativar a gravação de áudio.
        • Orientação da imagem.
        • Ativar/desativar a Visão noturna.
        • Volume do alto-falante da câmera.
        • Brilho do LED de status.
      • Campainha:
        • Ativar/desativar o microfone.
        • Ativar/desativar a gravação de áudio.
        • Orientação da imagem.
        • Ativar/desativar a Visão noturna.
        • Volume do alto-falante da câmera.
        • Brilho do LED de status.
        • Sons de sino.
    • Integra 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
  • Versões mínimas do firmware do hub do Google:
    • Versão do Cast: 3.76.495998
    • Versão mínima do 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

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

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.

Problemas conhecidos corrigidos

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

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
  • Versões mínimas do firmware do hub do Google:
    • Versão do Cast: 3.76.495998
    • Versão mínima do 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

  • API Device
    • Tipo de dispositivo de câmera adicionado. Os seguintes recursos para câmeras também estão disponíveis para campainhas:
      • Transmissão ao vivo da câmera
      • Conversa na câmera
      • Iniciar e interromper a gravação da câmera
  • App de amostra do iOS
    • Suporte para o tipo de dispositivo câmera:
      • Transmissão ao vivo da câmera.
      • Conversa pela câmera.
      • A câmera inicia e interrompe a gravação.
      • Permissões restritas para tipos de dispositivos.
    • Suporte para ativação do Hub.

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.

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.

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
  • Versões mínimas do firmware do hub do Google:
    • Versão do Cast: 3.76.495998
    • Versão mínima do 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

Exemplo de app iOS

  • Controle do termostato adicionado.

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

Novos recursos

  • API Device

Exemplo de app iOS

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

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

Problemas conhecidos corrigidos

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

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

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

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.

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.

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

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

  • API Device
  • API Structure
    • Suporte para mudar o nome de Room

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.

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.

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