Home APIs iOS SDK 출시 노트

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 앱 최소 버전: 모든 버전에서 작동
  • 문제 버전: 1.4.1.0

새로운 기능

  • Device API
    • 카메라 장치 유형이 추가되었습니다. 도어벨에는 다음과 같은 카메라 기능도 사용할 수 있습니다.
      • 카메라 라이브 스트리밍
      • 카메라 양방향 대화
      • 카메라 녹화 시작 및 중지
  • iOS 샘플 앱
    • 카메라 장치 유형 지원:
      • 카메라 라이브 스트리밍.
      • 카메라 양방향 통화.
      • 카메라 녹화를 시작하고 중지합니다.
      • 제한된 장치 유형 권한.
    • 허브 활성화 지원.

알려진 문제

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

알려진 문제 해결

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

2025-08-28

  홈 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 앱 최소 버전: 모든 버전에서 작동
  • 문제 버전: 1.4.1.0

새로운 기능

iOS 샘플 앱

  • 온도 조절 장치가 추가되었습니다.

알려진 문제

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

2025-07-08

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

2025-06-26

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

알려진 문제 해결

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

2025-05-09

  Home API 공개 베타 출시 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 앱 최소 버전: 모든 버전에서 작동
  • 문제 버전: 1.4.0.0

새로운 기능

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

알려진 문제

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

알려진 문제 해결

  • Google Home 앱의 iOS 버전에서 권한을 부여할 때 자세히 알아보기 및 뒤로 가기 버튼이 응답하지 않을 수 있습니다.
    • 해결 방법: 자세히 알아보기 링크를 길게 눌러 시스템 브라우저에서 열거나 왼쪽 상단의 닫기 버튼을 탭하여 뷰를 종료합니다.
  • 샘플 앱에서 기본 동영상 플레이어가 작동하지 않을 수 있습니다.
  • Cloud-to-Cloud로 지원되는 창 가리개 장치 유형 제어가 작동하지 않을 수 있습니다.
  • 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 앱 최소 버전: 모든 버전에서 작동
  • 문제 버전: 1.4.0.0
    • 참고: 임시 Matter 기기 유형과 클러스터는 지원되지 않습니다.

알려진 문제

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

알려진 문제 해결

  • 기기 이름 지정 및 이름 변경은 지원되지 않습니다.
  • 시운전을 위해서는 구조물 내 첫 번째 Matter 기기를 iOS Google Home 앱을 사용하여 시운전해야 합니다. 현재 Home API는 새 패브릭을 생성할 수 없으며, 2023년 이전에 제작된 구조물의 기존 패브릭에 추가하는 기능만 지원합니다. 2023년 이후에 건설된 구조물은 이 문제의 영향을 받지 않습니다.