Home APIs iOS SDK 출시 노트

2026-04-09

  Home APIs 공개 베타 출시 1.8  

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

최소 버전

  • Google 허브 펌웨어 최소 버전:
    • 전송:
      • Nest WiFi Pro: 3.78.518349
      • 기타 모든 Cast 기반 허브: 3.78.526062
    • Fuchsia: 29.20251023.103.2101601
    • 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, 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 허브 펌웨어 최소 버전:
    • 전송:
      • Nest WiFi Pro: 3.78.518349
      • 기타 모든 Cast 기반 허브: 3.78.516526
    • Fuchsia: 29.20251023.103.2201
    • 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, 1.5.0 실험적 지원

새로운 기능

기타 주목할 만한 변경사항

  • 구독 동의 흐름이 간소화되었습니다.
  • Home API iOS 샘플 앱 v1.7.1 자세한 내용은 GitHub 출시를 참고하세요.

알려진 문제 수정

  • 기록 필터링은 초기 로드 시 하루 및 기기에 대해 예상되는 모든 이벤트를 표시하지 않습니다.
    • 해결 방법: 모든 이벤트가 표시되도록 모든 필터를 지웁니다.
  • 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 샘플 앱이 업데이트되었습니다.

전체 출시 노트는 GitHub 출시를 참고하세요.

2026-02-09

  Home API 공개 베타 출시 1.7  

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

최소 버전

  • iOS: iOS 17.0 이상, Xcode 15.3 이상
    • Matter 커미셔닝: iOS 17.6 이상
  • Google 허브 펌웨어 최소 버전:
    • 전송:
      • Nest WiFi Pro: 3.76.508025
      • 기타 모든 Cast 기반 허브: 3.77.510748
    • Fuchsia: 29.20251023.103.2100
    • Google TV Streamer, 4K: UTTK.250729.004
  • iOS SDK: home_platform_ios_1.7.0
  • Google Home 앱 최소 버전: 1.7
  • Matter 버전: 1.4.1.0, 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 허브 펌웨어 최소 버전:
    • 전송:
      • Nest Wifi Pro: 3.75.479819
      • 기타 모든 Cast 기반 허브: 3.77.505721
    • Fuchsia: 28.20250723.103.2100300
    • Google TV Streamer, 4K: UTTK.250729.004
  • iOS SDK: home_platform_ios_1.6.0
  • Google Home 앱 최소 버전: 1.6
  • Matter 버전: 1.4.1.0

새로운 기능

  • Automation API
    • 자동화에서 지정된 기준에 따라 자동화가 기기를 동적으로 선택할 수 있는 엔티티 필터 지원이 추가되었습니다.
    • 자동화 시작 조건 및 조건에 날씨 특성 지원이 추가되었습니다. 날씨에 따른 시작을 참고하세요.
  • 기기 API
    • 더 많은 카메라 및 초인종 기기 기능 지원
      • 새 설정:
        • 야간 적외선 조명 켜기/끄기
        • 상태 LED 밝기입니다.
        • 카메라 표시 영역입니다.
        • 이미지 방향입니다.
        • 카메라 센서 민감도
        • 최대 이벤트 길이입니다.
        • 차임벨 소리

        자세한 내용은 iOS용 카메라 기기 가이드를 참고하세요.

  • Structure API
  • iOS 샘플 앱
    • 더 많은 설정 지원
      • 카메라:
        • 마이크 켜기/끄기
        • 오디오 녹음 사용/사용 안함
        • 이미지 방향입니다.
        • 야간 적외선 조명 켜기/끄기
        • 카메라 스피커 볼륨입니다.
        • 상태 LED 밝기입니다.
      • 초인종:
        • 마이크 켜기/끄기
        • 오디오 녹음 사용/사용 안함
        • 이미지 방향입니다.
        • 야간 적외선 조명 켜기/끄기
        • 카메라 스피커 볼륨입니다.
        • 상태 LED 밝기입니다.
        • 차임벨 소리
    • Swift Package Manager를 사용하여 기본적으로 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
    • Fuchsia 최소 버전: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.5.1.zip
  • Google Home 앱 최소 버전: 모든 버전에서 작동
  • Matter 버전: 1.4.1.0

새로운 기능

  • Structure API
    • 허브 활성화 API를 사용하면 프로그래매틱 방식으로 Google Home 허브를 검색하고 활성화할 수 있습니다. iOS의 허브 활성화 API를 참고하세요.

알려진 문제

  • 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
    • Fuchsia 최소 버전: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.5.0.zip
  • Google Home 앱 최소 버전: 모든 버전에서 작동
  • Matter 버전: 1.4.1.0

새로운 기능

  • 기기 API
    • 카메라 기기 유형이 추가되었습니다. 다음 카메라 기능은 초인종에서도 사용할 수 있습니다.
      • 카메라 라이브 스트림
      • 카메라 양방향 대화
      • 카메라 녹화 시작 및 중지
  • 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
    • 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의 베타 품질이 향상되었습니다.

최소 버전

새로운 기능

  • 기기 API
    • 프로그래매틱 방식으로 Matter 기기를 삭제하는 기능 기기 삭제하기를 참고하세요.

iOS 샘플 앱

  • Matter 전용 기기를 삭제합니다.

알려진 문제

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

2025-07-08

이제 Nest WiFi Pro가 Cast 펌웨어 버전 3.76.479819를 통해 Home API 허브로 작동할 수 있습니다.

2025-06-26

  Home APIs 공개 베타 출시 1.3.2  

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

최소 버전

  • iOS: iOS 16.4 이상, Xcode 15.3 이상
  • Google 허브 펌웨어 최소 버전:
    • Cast 버전: 3.75.456944
    • 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의 베타 품질이 향상되었습니다.

최소 버전

  • 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.3.0.zip
  • Google Home 앱 최소 버전: 모든 버전에서 작동
  • Matter 버전: 1.4.0.0

새로운 기능

알려진 문제

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

알려진 문제 해결

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

2025-05-09

  Home APIs 공개 베타 출시 1.3  

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

최소 버전

  • 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.3.0.zip
  • Google Home 앱 최소 버전: 모든 버전에서 작동
  • Matter 버전: 1.4.0.0

새로운 기능

  • 기기 API
  • Structure API
    • Room 이름 변경 지원

알려진 문제

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

알려진 문제 해결

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

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 앱이 열려 있는 동안 권한을 취소하면 앱이 비정상 종료됩니다.
  • 샘플 앱에서 기본 동영상 플레이어가 작동하지 않을 수 있습니다.
  • 클라우드 간 연결로 지원되는 온도 조절기는 작동하지 않을 수 있습니다.
  • 클라우드 간으로 지원되는 팬 기기 유형의 제어가 샘플 앱에서 작동하지 않을 수 있습니다.
  • 클라우드 간으로 지원되는 창 덮개 기기 유형의 제어가 작동하지 않을 수 있습니다.
  • GHA의 iOS 버전은 로컬에서 Wi-Fi로 네트워크를 변경하거나 앱 간에 전환하는 동안 비정상 종료될 수 있습니다.

알려진 문제 해결

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