Home APIs iOS SDK 출시 노트

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

새로운 기능

  • 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 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를 통해 스레드 테두리 라우터를 추가합니다.

알려진 문제 해결

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

2025-05-09

  홈 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 앱 최소 버전: 모든 버전과 호환
  • 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년 이후에 생성된 구조는 이 문제의 영향을 받지 않습니다.