Home APIs iOS SDK 출시 노트

2026-05-06

Home API iOS 샘플 앱이 Home API 1.8.1 버전으로 업데이트되었습니다.

샘플 앱

2026-05-01

  Home API 공개 베타 출시 1.8.1  

이번 출시에는 버그 수정이 포함되어 있으며 Home API iOS SDK의 베타 품질이 향상되었습니다.

최소 버전

새로운 기능

  • 온도 조절기 트레이트에서 이제 읽기/업데이트, 켜기/끄기, 타이머 기능을 지원함
  • 추천 자동화 지원

알려진 문제 해결

  • 샘플 앱이 백그라운드 및 포그라운드로 전환되면 라이브 스트림이 중단됩니다.
  • 사용자가 내 계정을 통해 권한을 취소하면 Google Home 앱이 비정상 종료될 수 있습니다. 해결 방법은 앱을 다시 시작하는 것입니다.
  • Philips BLE 조명이 올바른 상태를 표시하지 않음

알려진 문제

  • Google TV Streamer, 4K를 사용하여 일부 기기를 커미셔닝할 수 없습니다.
  • 일부 초인종 기기의 경우 IP 주소 필드가 채워지지 않습니다.
  • 허브가 Nest Wifi Pro, Google Nest Hub 또는 Google Nest Hub Max인 경우 Google Home 앱에 멀티파트 기기가 여러 타일로 표시됩니다.

2026-04-10

Home API iOS 샘플 앱이 Home API 1.8 출시를 위해 업데이트되었습니다.

샘플 앱

2026-04-09

  Home API 공개 베타 출시 1.8  

이번 출시에는 버그 수정이 포함되어 있으며 Home API iOS SDK의 베타 품질이 향상되었습니다.

최소 버전

  • Google 허브 펌웨어, Cast, Nest Wifi Pro: 3.78.518349
  • Google 허브 펌웨어, Cast, 기타 모든 Cast 기반 허브: 3.78.526062
  • Google 허브 펌웨어, Fuchsia: 29.20251023.103.2101601
  • Google 허브 펌웨어, Google TV Streamer, 4K: UTTK.250729.004
  • iOS SDK: home_platform_ios_1.8.0_0
  • Google Home 앱: 모든 버전에서 작동
  • androidx.core 라이브러리: 모든 버전에서 작동
  • Matter 버전: 1.4.1.0
  • Matter 버전: 1.5.0 실험적 지원

새로운 기능

알려진 문제 해결

  • 실외용 Nest Cam (유선, 2세대)의 커미셔닝이 실패할 수 있습니다. 타일이 비활성화된 상태로 유지되고 오류 메시지가 표시되며 카메라를 제어할 수 없습니다.
  • Google Nest Learning Thermostat (4세대) v4 온도 단위 (C/F)를 변경할 수 없습니다.
  • 웹용 Google Home의 모바일 버전에서는 상단 아이콘과 뒤로 버튼이 헤더에 가려집니다. 사용자가 뒤로 이동하거나 주요 사용자 인터페이스 요소를 볼 수 없습니다.
  • 동일한 컨트롤러에서 사용자를 전환하면 GHA 기기 타일이 오프라인 상태가 됩니다. 사용자가 동일한 컨트롤러를 사용하는 멀티 사용자 가구에서는 앱을 다시 실행할 때까지 기기가 오프라인으로 표시될 수 있습니다.

알려진 문제

  • Matter 기기 커미셔닝이 실패할 수 있습니다.

2026-03-13

  Home API 공개 베타 출시 1.7.1  

이번 출시에는 버그 수정이 포함되어 있으며 Home API iOS SDK의 베타 품질이 향상되었습니다.

최소 버전

  • iOS: iOS 17.0 이상, Xcode 15.3 이상
  • Matter 커미셔닝: iOS 17.6 이상
  • Google 허브 펌웨어, Cast, Nest Wifi Pro: 3.78.518349
  • Google 허브 펌웨어, Cast, 기타 모든 Cast 기반 허브: 3.78.516526
  • Google 허브 펌웨어, Fuchsia: 29.20251023.103.2201
  • Google 허브 펌웨어, Google TV Streamer, 4K: UTTK.260120.001
  • iOS SDK: home_platform_ios_1.7.1
  • Google Home 앱 최소 버전: 1.7.1
  • Matter 버전: 1.4.1.0
  • Matter 버전: 1.5.0 실험적 지원

새로운 기능

기타 주목할 만한 변경사항

  • 구독 동의 흐름이 간소화되었습니다.

샘플 앱

알려진 문제 해결

  • 기록 필터링에서 초기 로드 시 하루 및 기기에 대해 예상되는 모든 이벤트가 표시되지 않습니다. 해결 방법: 모든 이벤트가 표시되도록 모든 필터를 지웁니다.
  • Nest Cam 실내/실외 (배터리 또는 유선) 및 Nest Doorbell (배터리, 2세대)의 경우 배터리 설정에 '남은 배터리 시간' 옵션이 표시되지 않습니다.

알려진 문제

  • 실외용 Nest Cam (유선, 2세대)의 커미셔닝이 실패할 수 있습니다. 타일이 비활성화된 상태로 유지되고 오류 메시지가 표시되며 카메라를 제어할 수 없습니다.
  • Google Nest Learning Thermostat (4세대) v4 온도 단위 (C/F)를 변경할 수 없습니다.
  • 웹용 Google Home의 모바일 버전에서는 상단 아이콘과 뒤로 버튼이 헤더에 가려집니다. 사용자가 뒤로 이동하거나 주요 사용자 인터페이스 요소를 볼 수 없습니다.
  • 동일한 컨트롤러에서 사용자를 전환하면 GHA 기기 타일이 오프라인 상태가 됩니다. 사용자가 동일한 컨트롤러를 사용하는 멀티 사용자 가구에서는 앱을 다시 실행할 때까지 기기가 오프라인으로 표시될 수 있습니다.
  • Matter 기기 커미셔닝이 실패할 수 있습니다.

2026-02-13

Home API 1.7 출시를 위해 Home API iOS 샘플 앱이 업데이트되었습니다.

샘플 앱

2026-02-09

  Home API 공개 베타 출시 1.7  

이번 출시에는 버그 수정이 포함되어 있으며 Home API iOS SDK의 베타 품질이 향상되었습니다.

최소 버전

  • iOS: iOS 17.0 이상, Xcode 15.3 이상
  • Matter 커미셔닝: iOS 17.6 이상
  • Google 허브 펌웨어, Cast, Nest Wifi Pro: 3.76.508025
  • Google 허브 펌웨어, Cast, 기타 모든 Cast 기반 허브: 3.77.510748
  • Google 허브 펌웨어, Fuchsia: 29.20251023.103.2100
  • Google 허브 펌웨어, Google TV Streamer, 4K: UTTK.250729.004
  • iOS SDK: home_platform_ios_1.7.0
  • Google Home 앱 최소 버전: 1.7
  • Matter 버전: 1.4.1.0
  • Matter 버전: 1.5.0 실험적 지원

새로운 기능

기타 주목할 만한 변경사항

알려진 문제 해결

  • History API가 항상 nextPageToken을 반환하여 무한 루프가 발생합니다.
  • '스트림 연결 해제됨' 오류로 인해 장시간 카메라 스트림 세션이 중단될 수 있습니다.
  • CommissionDeviceCommand 실행 중에 Matter 기기 커미셔닝이 실패합니다.

알려진 문제

  • 기록 필터링에서 초기 로드 시 해당 날짜와 기기에 대해 예상되는 모든 이벤트가 표시되지 않습니다. 해결 방법: 모든 이벤트가 표시되도록 모든 필터를 지웁니다.
  • 실내 / 실외용 Nest Cam (배터리 또는 유선) 및 Nest Doorbell (배터리, 2세대)의 경우 '남은 배터리 시간' 옵션이 배터리 설정에 표시되지 않습니다.
  • 현재 카메라 기기 소프트웨어 버전의 경우 올바른 소프트웨어 버전이 표시되지 않을 수 있습니다.
  • 차임벨 시간 설정이 무시됩니다.
  • Nest Doorbell (배터리, 2세대) 카메라를 끄면 화면이 멈춥니다.
  • Nest Cam IQ 카메라 설정에 차임벨 테마가 3개만 표시되어야 하지만 훨씬 더 많이 표시됩니다.
  • 기기가 실제로 오프라인 상태인데도 Philips BLE 조명이 '온라인'으로 잘못 표시됩니다. 해결 방법: 스마트 홈 기기 유형 (SHDT) 온라인 상태에만 의존하지 마세요. 대신 LOCAL_SYNC 소스가 있는 기기에는 타겟 기기 상태 서비스 (TDSS) 맵을 사용하세요.

2025-12-22

  Home API 공개 베타 출시 1.6  

이번 출시에는 버그 수정이 포함되어 있으며 Home API iOS SDK의 베타 품질이 향상되었습니다.

최소 버전

  • iOS: iOS 17.0 이상, Xcode 15.3 이상
  • Matter 커미셔닝: iOS 17.6 이상
  • Google 허브 펌웨어, Cast, Nest Wifi Pro: 3.75.479819
  • Google 허브 펌웨어, Cast, 기타 모든 Cast 기반 허브: 3.77.505721
  • Google 허브 펌웨어, Fuchsia: 28.20250723.103.2100300
  • Google 허브 펌웨어, Google TV Streamer, 4K: UTTK.250729.004
  • iOS SDK: home_platform_ios_1.6.0
  • Google Home 앱 최소 버전: 1.6
  • Matter 버전: 1.4.1.0

새로운 기능

기타 주목할 만한 변경사항

  • iOS 샘플 앱에서 카메라 및 초인종에 대한 설정을 추가하고 Swift 패키지 관리자를 사용하여 기본적으로 SDK를 통합합니다.

알려진 문제 해결

  • Wi-Fi에서 모바일 네트워크로 전환하면 기기 제어 지연 시간이 늘어날 수 있습니다.
  • 클라우드 간으로 지원되는 팬 기기 유형의 제어가 샘플 앱에서 작동하지 않을 수 있습니다.

2025-10-22

  Home API 공개 베타 출시 1.5.1  

이번 출시에는 버그 수정이 포함되어 있으며 Home API iOS SDK의 베타 품질이 향상되었습니다.

최소 버전

  • iOS: iOS 17.0 이상, Xcode 15.3 이상
  • Matter 커미셔닝: iOS 17.6 이상
  • Google 허브 펌웨어, Cast: 3.76.495998
  • Google 허브 펌웨어, Fuchsia: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.5.1.zip
  • Google Home 앱 최소 버전: 모든 버전에서 작동
  • Matter 버전: 1.4.1.0

새로운 기능

알려진 문제 해결

  • 샘플 앱을 사용하는 경우 라이브 스트림이 예기치 않게 비정상 종료됩니다.

알려진 문제

  • Wi-Fi에서 모바일 네트워크로 전환하면 기기 제어 지연 시간이 늘어날 수 있습니다.
  • 클라우드 간으로 지원되는 팬 기기 유형의 제어가 샘플 앱에서 작동하지 않을 수 있습니다.
  • iOS Home API를 사용하여 Matter-over-Thread 기기를 커미셔닝할 때 오류가 발생합니다. 해결 방법: 동일한 휴대전화에서 iOS GHA를 통해 스레드 보더 라우터를 추가합니다.

2025-09-26

  Home API 공개 베타 출시 1.5.0  

이번 버전에서는 카메라 기기 지원이 도입되고, 버그가 수정되며, Home API iOS SDK의 베타 품질이 향상되었습니다.

최소 버전

  • iOS: iOS 17.0 이상, Xcode 15.3 이상
  • Matter 커미셔닝: iOS 17.6 이상
  • Google 허브 펌웨어, Cast: 3.76.495998
  • Google 허브 펌웨어, Fuchsia: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.5.0.zip
  • Google Home 앱 최소 버전: 모든 버전에서 작동
  • Matter 버전: 1.4.1.0

새로운 기능

기타 주목할 만한 변경사항

  • iOS 샘플 앱에 카메라 기기 유형 및 허브 활성화 지원이 추가되었습니다.

알려진 문제 해결

  • 자동화를 만드는 중에 오류가 발생하고 알 수 없는 기기 유형이 선택 가능한 옵션으로 잘못 표시되었습니다.

알려진 문제

  • Wi-Fi에서 모바일 네트워크로 전환하면 기기 제어 지연 시간이 늘어날 수 있습니다.
  • 클라우드 간으로 지원되는 팬 기기 유형의 제어가 샘플 앱에서 작동하지 않을 수 있습니다.
  • iOS Home API를 사용하여 Matter-over-Thread 기기를 커미셔닝할 때 오류가 발생합니다. 해결 방법: 동일한 휴대전화에서 iOS GHA를 통해 스레드 보더 라우터를 추가합니다.

2025-08-28

  Home API 공개 베타 출시 1.4.1  

이번 출시에는 버그 수정이 포함되어 있으며 Home API iOS SDK의 베타 품질이 향상되었습니다.

최소 버전

  • iOS: iOS 17.0 이상, Xcode 15.3 이상
  • Matter 커미셔닝: iOS 17.6 이상
  • Google 허브 펌웨어, Cast: 3.76.495998
  • Google 허브 펌웨어, Fuchsia: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.4.1.zip
  • Google Home 앱 최소 버전: 모든 버전에서 작동
  • Matter 버전: 1.4.1.0

새로운 기능

기타 주목할 만한 변경사항

  • iOS 샘플 앱에 온도 조절기 컨트롤이 추가되었습니다.

알려진 문제

  • Wi-Fi에서 모바일 네트워크로 전환하면 기기 제어 지연 시간이 늘어날 수 있습니다.
  • 클라우드 간으로 지원되는 팬 기기 유형의 제어가 샘플 앱에서 작동하지 않을 수 있습니다.
  • iOS Home API를 사용하여 Matter-over-Thread 기기를 커미셔닝할 때 오류가 발생합니다. 해결 방법: 동일한 휴대전화에서 iOS GHA를 통해 스레드 보더 라우터를 추가합니다.

2025-07-30

  Home API 공개 베타 출시 1.4.0  

이번 출시에는 버그 수정이 포함되어 있으며 Home API iOS SDK의 베타 품질이 향상되었습니다.

최소 버전

  • iOS: iOS 17.0 이상, Xcode 15.3 이상
  • Matter 커미셔닝: iOS 17.6 이상
  • Google 허브 펌웨어, Cast: 3.75.456944
  • Google 허브 펌웨어, Fuchsia: 24.20241009.103.1900601
  • iOS SDK: home_platform_ios_1.4.0.zip
  • Google Home 앱 최소 버전: 모든 버전에서 작동
  • Matter 버전: 1.4.0.0

새로운 기능

기타 주목할 만한 변경사항

  • iOS 샘플 앱에서 Matter 전용 기기를 삭제하는 기능이 삭제됩니다.

알려진 문제

  • Wi-Fi에서 모바일 네트워크로 전환하면 기기 제어 지연 시간이 늘어날 수 있습니다.
  • 클라우드 간으로 지원되는 팬 기기 유형의 제어가 샘플 앱에서 작동하지 않을 수 있습니다.
  • iOS Home API를 사용하여 Matter-over-Thread 기기를 커미셔닝할 때 오류가 발생합니다. 해결 방법: 동일한 휴대전화에서 iOS GHA를 통해 스레드 보더 라우터를 추가합니다.

2025-06-26

  Home API 공개 베타 출시 1.3.2  

이번 출시에는 버그 수정이 포함되어 있으며 Home API iOS SDK의 베타 품질이 향상되었습니다.

최소 버전

  • iOS: iOS 16.4 이상, Xcode 15.3 이상
  • Google 허브 펌웨어, Cast: 3.75.456944
  • Google 허브 펌웨어, Fuchsia: 24.20241009.103.1900601
  • iOS SDK: home_platform_ios_1.3.2.zip
  • Google Home 앱 최소 버전: 모든 버전에서 작동
  • Matter 버전: 1.4.0.0

새로운 기능

알려진 문제 해결

  • 클라우드 간 연결로 지원되는 온도 조절기는 작동하지 않을 수 있습니다.

알려진 문제

  • Wi-Fi에서 모바일 네트워크로 전환하면 기기 제어 지연 시간이 늘어날 수 있습니다.
  • 클라우드 간으로 지원되는 팬 기기 유형의 제어가 샘플 앱에서 작동하지 않을 수 있습니다.
  • iOS Home API를 사용하여 Matter-over-Thread 기기를 커미셔닝할 때 오류가 발생합니다. 해결 방법: 동일한 휴대전화에서 iOS GHA를 통해 스레드 보더 라우터를 추가합니다.

2025-06-05

  Home API 공개 베타 출시 1.3.1  

이번 출시에는 버그 수정이 포함되어 있으며 Home API iOS SDK의 베타 품질이 향상되었습니다.

최소 버전

기타 주목할 만한 변경사항

알려진 문제 해결

  • 로컬에서 Wi-Fi로 네트워크를 변경하거나 앱 간에 전환하는 동안 GHA의 iOS 버전이 비정상 종료될 수 있습니다.

알려진 문제

  • Wi-Fi에서 모바일 네트워크로 전환하면 기기 제어 지연 시간이 늘어날 수 있습니다.
  • 클라우드 간 연결로 지원되는 온도 조절기는 작동하지 않을 수 있습니다.
  • 클라우드 간으로 지원되는 팬 기기 유형의 제어가 샘플 앱에서 작동하지 않을 수 있습니다.
  • iOS Home API를 사용하여 Matter-over-Thread 기기를 커미셔닝할 때 오류가 발생합니다. 해결 방법: 동일한 휴대전화에서 iOS GHA를 통해 스레드 보더 라우터를 추가합니다.

2025-05-09

  Home APIs 공개 베타 출시 1.3  

이번 출시에는 버그 수정이 포함되어 있으며 Home API iOS SDK의 베타 품질이 향상되었습니다.

최소 버전

새로운 기능

알려진 문제 해결

  • iOS 버전의 Google Home 앱에서 권한을 부여할 때 자세히 알아보기 및 뒤로 버튼이 응답하지 않을 수 있습니다. 해결 방법: 자세히 알아보기 링크를 길게 눌러 시스템 브라우저에서 열거나 왼쪽 상단의 닫기 버튼을 탭하여 뷰를 종료합니다.
  • 샘플 앱에서 기본 동영상 플레이어가 작동하지 않을 수 있습니다.
  • 클라우드 간으로 지원되는 창 덮개 기기 유형의 제어가 작동하지 않을 수 있습니다.
  • Google Home 앱이 열려 있는 동안 권한을 취소하면 앱이 비정상 종료됩니다.

알려진 문제

  • Wi-Fi에서 모바일 네트워크로 전환하면 기기 제어 지연 시간이 늘어날 수 있습니다.
  • 클라우드 간 연결로 지원되는 온도 조절기는 작동하지 않을 수 있습니다.
  • 클라우드 간으로 지원되는 팬 기기 유형의 제어가 샘플 앱에서 작동하지 않을 수 있습니다.
  • 로컬에서 Wi-Fi로 네트워크를 변경하거나 앱 간에 전환하는 동안 GHA의 iOS 버전이 비정상 종료될 수 있습니다.

2025-04-09

  iOS Home API 공개 베타 출시  

공개 개발자 베타 기간 동안 모든 개발자는 iOS 앱을 빌드하고 테스트할 수 있습니다.

이번 출시에는 버그 수정이 포함되어 있으며 Home API iOS SDK의 정식 버전 (GA) 품질이 향상되었습니다.

최소 버전

  • connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK로 롤업
  • iOS: iOS 16.4 이상, Xcode 15.3 이상
  • Google 허브 펌웨어 최소 버전:
    • Cast 버전: 3.75.456944
    • Fuchsia 최소 버전: 24.20241009.103.1900601
  • iOS SDK: home_platform_ios_1.0_1.zip
  • Google Home 앱 최소 버전: 모든 버전에서 작동
  • Matter 버전: 1.4.0.0
    • 참고: 임시 Matter 기기 유형과 클러스터는 지원되지 않습니다.

알려진 문제

  • Wi-Fi에서 모바일 네트워크로 전환하면 기기 제어 지연 시간이 늘어날 수 있습니다.
  • iOS 버전의 Google Home 앱에서 권한을 부여할 때 자세히 알아보기 및 뒤로 버튼이 응답하지 않을 수 있습니다.
    • 해결 방법: 자세히 알아보기 링크를 길게 눌러 시스템 브라우저에서 열거나 왼쪽 상단의 닫기 버튼을 탭하여 뷰를 종료합니다.
  • Google Home 앱이 열려 있는 동안 권한을 취소하면 앱이 비정상 종료됩니다.
  • 샘플 앱에서 기본 동영상 플레이어가 작동하지 않을 수 있습니다.
  • 클라우드 간 연결로 지원되는 온도 조절기는 작동하지 않을 수 있습니다.
  • 클라우드 간으로 지원되는 팬 기기 유형의 제어가 샘플 앱에서 작동하지 않을 수 있습니다.
  • 클라우드 간으로 지원되는 창 덮개 기기 유형의 제어가 작동하지 않을 수 있습니다.
  • iOS 버전의 GHA는 로컬에서 Wi-Fi로 네트워크를 변경하거나 앱 간에 전환하는 동안 비정상 종료될 수 있습니다.

알려진 문제 해결

  • 기기 이름 지정 및 이름 변경은 지원되지 않습니다.
  • 커미셔닝의 경우 구조의 첫 번째 Matter 기기는 iOS Google Home 앱을 사용하여 커미셔닝해야 합니다. 현재 Home API는 새 패브릭을 만들 수 없으며 2023년 전에 생성된 구조의 기존 패브릭에만 추가할 수 있습니다. 2023년 이후에 생성된 구조는 이 문제의 영향을 받지 않습니다.