Home APIs iOS SDK 출시 노트

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

새로운 기능

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

알려진 문제 해결

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

2025-06-05

  Home API 공개 베타 출시 1.3.1  

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

최소 버전

새로운 기능

  • 외부 샘플 앱

알려진 문제

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

알려진 문제 해결

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

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

새로운 기능

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

알려진 문제

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

알려진 문제 해결

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