Home API Android SDK 출시 노트

2026-05-01

  Home API 공개 베타 출시 1.8.1  

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

최소 버전

• Google Play 서비스: 26.16.31
• Google 허브 펌웨어, Cast, Nest Wifi Pro: 3.78.518349
• Google 허브 펌웨어, Cast, 기타 모든 Cast 기반 허브: 3.78.526062
• Google 허브 펌웨어, Fuchsia: 30.20260121.103.1602802
• Google 허브 펌웨어, Google TV Streamer, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_8_1
• Google Home 앱: 4.8 이상
• androidx.core 라이브러리: 모든 버전에서 작동
• Matter 버전: 1.4.1.0
• Matter 버전: 1.5.0 실험적 지원

새로운 기능

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

알려진 문제 해결

• Matter 기기 커미셔닝이 실패할 수 있습니다.
• Philips BLE 조명이 올바른 상태를 표시하지 않음
• 지연 시간으로 인해 네트워크가 불안정해지고 응답 시간이 느려집니다.

알려진 문제

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

2026-04-10

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

샘플 앱

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

2026-04-09

  Home API 공개 베타 출시 1.8  

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

최소 버전

• Google Play 서비스: 26.12.32
• 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
• Android SDK: home.android.sdk_GHP_1_8_0
• Google Home 앱: 모든 버전에서 작동
• androidx.core 라이브러리: 모든 버전에서 작동
• Matter 버전: 1.4.1.0
• Matter 버전: 1.5.0 실험적 지원

새로운 기능

• 자동화 API의 추천 자동화
• 기기 API에서 멀티파트 기기 지원
• Device API의 카메라 및 초인종 활동 감지 구역 설정
• Device API의 카메라 및 초인종 소리 감지 설정
• 기기 API의 카메라 및 초인종 녹화 모드 (CVR/EVR/기록 없음)

알려진 문제 해결

• Google Nest Learning Thermostat (4세대)의 온도 단위 (C/F)를 변경할 수 없습니다.
• 웹용 Google Home의 모바일 버전에서는 상단 아이콘과 뒤로 버튼이 헤더에 가려집니다. 사용자가 뒤로 이동하거나 주요 사용자 인터페이스 요소를 볼 수 없습니다.
• Android TV 허브가 Matter 기기를 '오프라인'으로 잘못 보고할 수 있습니다.

알려진 문제

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

2026-03-13

  Home API 공개 베타 출시 1.7.1  

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

최소 버전

• Google Play 서비스:
• 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.250729.004
• Android SDK: home.android.sdk_GHP_1_7_1
• Google Home 앱: 1.7.1
• androidx.core 라이브러리: 모든 버전에서 작동
• Matter 버전: 1.4.1.0
• Matter 버전: 1.5.0 실험적 지원

새로운 기능

• 기기 API에서 카메라 및 초인종 분석 선택
• 기기 API의 카메라 및 초인종 마지막 연결 시간
• 기기 API의 카메라 및 초인종 연결 상태
• 기기 API의 온도 조절기 원자 요청

기타 주목할 만한 변경사항

• 허브리스 모드가 삭제되었습니다.

샘플 앱

• Home APIs Android 샘플 앱 v1.7.1. 자세한 내용은 GitHub 출시를 참고하세요.

알려진 문제 해결

• Nest Cam 실내/실외 (배터리 또는 유선) 및 Nest Doorbell (배터리, 2세대)의 경우 배터리 설정에 '남은 배터리 시간' 옵션이 표시되지 않습니다.
• 차임벨 시간 설정이 무시됩니다.
• 기기가 실제로 오프라인 상태인데도 Philips BLE 조명이 '온라인'으로 잘못 표시됩니다.

알려진 문제

• Google Nest Learning Thermostat (4세대)의 온도 단위 (C/F)를 변경할 수 없습니다.
• 네트워크 안정성 및 기기 응답성에 지연이 발생할 수 있습니다.
• 웹용 Google Home의 모바일 버전에서는 상단 아이콘과 뒤로 버튼이 헤더에 가려집니다. 사용자가 뒤로 이동하거나 주요 사용자 인터페이스 요소를 볼 수 없습니다.
• 연합 모드 OOBE 후 허브가 '연결 중...' 상태에서 멈출 수 있습니다.
• Matter 기기 커미셔닝이 실패할 수 있습니다.
• Android TV 허브에서 Matter 기기를 오프라인으로 잘못 보고할 수 있습니다.
• 현재 카메라 기기 소프트웨어 버전의 경우 올바른 소프트웨어 버전이 표시되지 않을 수 있습니다.
• 온도 조절기 UI 슬라이더에 범위를 벗어난 온도가 표시됩니다.
• 차임벨 울림 시간이 설정되면 지정된 시간 동안 기기에서 차임벨이 울리지 않습니다.

2026-02-13

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

샘플 앱

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

2026-02-09

  Home API 공개 베타 출시 1.7  

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

최소 버전

• Google Play 서비스: 26.02.34
• 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
• Android SDK: home.android.sdk_GHP_1_7
• Google Home 앱: 1.7
• androidx.core 라이브러리: 모든 버전에서 작동
• Matter 버전: 1.4.1.0
• Matter 버전: 1.5.0 실험적 지원

새로운 기능

• 로컬 자동화: 연결, 기기 유형, 특성과 같은 조건을 기반으로 일부 자동화가 이제 자동화 API에서 로컬로 실행될 수 있습니다.
• 기기 API의 앱에서 카메라 초기 환경 (OOBE) 사용 설정
• 기기 API의 카메라 및 초인종 차임벨 테마
• 기기 API의 카메라 및 초인종 자동 절전 모드
• 기기 API의 카메라 및 초인종 배터리 사용량 환경설정
• 기기 API의 카메라 및 초인종 배터리 충전 상태
• 기기 API의 카메라 및 초인종 배터리 잔량
• 기기 API의 카메라 및 초인종 일련번호
• 기기 API의 카메라 및 초인종 모델
• 기기 API의 카메라 및 초인종 소프트웨어 버전
• 기기 API의 맞춤 키-값 API
• 권한 쿼리를 사용하면 앱이 권한 API에서 사용자가 액세스 권한을 부여한 기기 유형을 확인할 수 있습니다.

기타 주목할 만한 변경사항

• 표준 오류 코드에 맞게 HomeException.unsupported이 HomeException.unimplemented로 대체되었습니다.
• 출시 1.7에서 맞춤 특성의 패키지 코드 생성기가 변경되었습니다. 맞춤 특성이 있는 개발자는 1.7 SDK를 통합한 후 특성을 다시 컴파일해야 합니다.

알려진 문제 해결

• History API는 항상 nextPageToken를 반환하여 무한 루프가 발생합니다.
• 새 계정에 로그인하려고 하면 '사용자가 권한 흐름을 취소함' 오류가 발생합니다.

알려진 문제

• Nest Cam 실내/실외 (배터리 또는 유선) 및 Nest Doorbell (배터리, 2세대)의 경우 배터리 설정에 '남은 배터리 시간' 옵션이 표시되지 않습니다.
• 차임벨 시간 설정이 무시됩니다.
• 기기가 실제로 오프라인 상태인데도 Philips BLE 조명이 '온라인'으로 잘못 표시됩니다. 해결 방법: 스마트 홈 기기 유형 (SHDT) 온라인 상태에만 의존하지 마세요. 대신 LOCAL_SYNC 소스가 있는 기기에는 타겟 기기 상태 서비스 (TDSS) 맵을 사용하세요.

2025-12-22

  Home API 공개 베타 출시 1.6  

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

최소 버전

• Google Play 서비스: 25.47.30
• 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
• Android SDK: home.android.sdk_GHP_1_6
• Google Home 앱: 1.6
• androidx.core 라이브러리: 모든 버전에서 작동
• Matter 버전: 1.4.1.0

새로운 기능

• 자동화 API 날씨 특성 지원. 자동화 시작 조건 및 조건에 날씨 특성 지원이 추가되었습니다.
• 더 많은 카메라 및 초인종 기기 기능 지원: 새로운 설정 (야간 적외선 조명, 상태 LED, 뷰포트, 방향, 감도, 활동 길이, 차임벨)
• UX 흐름을 간소화하고 활성 사용자 확인을 없애기 위해 앱에서 시작하는 Google 로그인
• 허브 없는 모드를 사용하면 사용자가 독립형 허브 없이 특정 Matter 기기를 온보딩하고 제어할 수 있습니다.
• 허브를 검색하고 활성화하는 허브 활성화 API

기타 주목할 만한 변경사항

• Android 샘플 앱에 카메라 설정, 사전 정의된 자동화, 팬 및 스피커 지원이 추가되었습니다.

알려진 문제

• 장기간 사용 후 기기 제어가 작동하지 않음 해결 방법: 허브를 다시 시작합니다.
• Matter 기기 커미셔닝이 실패할 수 있습니다.
• Android용 샘플 앱에서 새 계정을 추가하려고 하면 '사용자가 권한 흐름을 취소했습니다' 오류가 표시됩니다. 해결 방법: Android 기기 설정을 통해 Google 계정을 추가합니다.
• Android Home API SDK를 사용하여 커미셔닝된 Walmart onn 유선 보안 카메라는 Google Home 앱을 통해 라이브 스트리밍할 수 없습니다.
• Home API 앱에서 커미셔닝된 카메라는 Google Home 앱에서 라이브 스트림 세션을 시작할 수 없습니다.

2025-10-23

  Home API 공개 베타 출시 1.5.1  

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

최소 버전

• Google Play 서비스: 25.41.30
• Google 허브 펌웨어, Cast: 3.76.495998
• Google 허브 펌웨어, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_5_1
• Google Home 앱: 모든 버전에서 작동
• androidx.core 라이브러리: 모든 버전에서 작동
• Matter 버전: 1.4.1.0

새로운 기능

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

기타 주목할 만한 변경사항

• Android 샘플 앱에 초인종 기기 유형 지원 (OnOff, 라이브 스트림, 양방향 대화) 및 허브 활성화 API 구현이 추가되었습니다.

알려진 문제 해결

• 샘플 앱이 기기 뷰에 기기 상태를 올바르게 표시하지 않습니다.

2025-09-26

  Home API 공개 베타 출시 1.5.0  

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

최소 버전

• Google Play 서비스: 25.37.31
• Google 허브 펌웨어, Cast: 3.76.492738
• Google 허브 펌웨어, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_5
• Google Home 앱: 모든 버전에서 작동
• androidx.core 라이브러리: 모든 버전에서 작동
• Matter 버전: 1.4.1.0

새로운 기능

• 이제 시작 조건, 조건, 작업이 자동화 API에서 Matter 구조체를 매개변수로 허용합니다.
• 기기 API에 카메라 기기 유형이 추가되었습니다 (라이브 스트림, 양방향 대화, 녹화 시작/중지).

기타 주목할 만한 변경사항

• Android 샘플 앱에 카메라, 다중 관리자 커미셔닝, 사전 정의된 OnOff 자동화 지원이 추가되었습니다.

알려진 문제 해결

• 현재 활성 상태인 허브가 강제 삭제되면 일부 기기를 제어할 수 없는 5분간의 기간이 있습니다. 5분이 지나면 기기를 제어할 수 있습니다.
• 사용자가 미리 설정 또는 색상 온도 선택기에서 색상을 선택한 후 확장 색상 조명이 색상을 업데이트하지 못합니다.

알려진 문제

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

2025-08-29

  Home API 공개 베타 출시 1.4.1  

이번 출시에는 버그가 수정되고 Home API Android SDK의 베타 품질이 향상되었습니다.

최소 버전

• Google Play 서비스: 25.33.32
• Google 허브 펌웨어, Cast: 3.76.495998
• Google 허브 펌웨어, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_4_1
• Google Home 앱: 모든 버전에서 작동
• androidx.core 라이브러리: 모든 버전에서 작동
• Matter 버전: 1.4.0.0

새로운 기능

• 기기 API에서 다중 소스 기기를 사용 중단하려고 시도하기 위해 새로운 DecommissionIneligibleReason이 정의됩니다.

알려진 문제 해결

• 사용자가 지원되지 않는 모드로 온도 조절기를 설정하려고 하면 Android 샘플 앱이 비정상 종료됩니다.

알려진 문제

• 현재 활성 상태인 허브가 강제 삭제되면 일부 기기를 제어할 수 없는 5분간의 기간이 있습니다. 5분이 지나면 기기를 제어할 수 있습니다.

2025-07-31

  Home API 공개 베타 출시 1.4.0  

이번 출시에는 버그가 수정되고 Home API Android SDK의 베타 품질이 향상되었습니다.

최소 버전

• Google Play 서비스: 25.28.34
• Google 허브 펌웨어, Cast: 3.76.486931
• Google 허브 펌웨어, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_4_0
• Google Home 앱: 모든 버전에서 작동
• androidx.core 라이브러리: 모든 버전에서 작동
• Matter 버전: 1.4.0.0

새로운 기능

• 자동화는 Automation API에서 유한한 횟수만큼 실행되도록 제한할 수 있습니다.
• 기기 API에서 프로그래매틱 방식으로 Matter 기기를 삭제하는 기능
• 지원 중단된 HomeDevice 멤버 (trait(), isInRoom, isInStructure)가 삭제되었습니다.
• 이제 Home.hasPermissions()에 OAuth 구조 액세스 및 앱 권한 부여가 모두 통합됩니다.

기타 주목할 만한 변경사항

• Android 샘플 앱이 Matter 전용 기기를 삭제하고, 기기 이름을 바꾸고, 지원 중단된 API 호출을 대체합니다.

알려진 문제 해결

• 도킹된 진공청소기 기기는 도킹 상태로 등록되지 않습니다.

알려진 문제

• 휴대전화에서 로그아웃했다가 다시 로그인하면 Home API 앱이 기기를 제어할 수 없습니다. 해결 방법: 앱을 닫고 10초 이상 기다립니다.

2025-06-26

  Home API 공개 베타 출시 1.3.2  

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

최소 버전

• Google Play 서비스: 25.23.31
• Google 허브 펌웨어, Cast, Google Home, Google Home Mini, Google Nest Mini: 3.75.468362
• Google 허브 펌웨어, Cast, Google Nest Audio: 3.75.476451
• Google 허브 펌웨어, Fuchsia: 26.20250116.103.2900
• Android SDK: home.android.sdk_1_3_2
• Google Home 앱: 모든 버전에서 작동
• androidx.core 라이브러리: 모든 버전에서 작동
• Matter 버전: 1.4.0.0

새로운 기능

• SDK 아티팩트가 홈 API SDK 프레임워크 (play-services-home-17.0.0.aar)와 SDK 특성 및 기기 유형 (play-services-home-types-17.0.0.aar)이라는 두 개의 별도 아티팩트로 나뉘었습니다. 이번 출시부터 개발자는 프로젝트의 컴파일 시간 및 런타임 라이브러리 경로에 두 아티팩트를 모두 포함해야 합니다.

기타 주목할 만한 변경사항

• Android 샘플 앱에 다음이 추가되었습니다. 사용자가 앱에서 연결을 해제하고 권한을 취소할 수 있습니다.
• Android 샘플 앱에 다음이 추가되었습니다. play-services-home-17.0.0 및 play-services-home-types-17.0.0를 포함하도록 SDK 아티팩트가 업데이트되었습니다.

알려진 문제

• 도킹된 진공청소기 기기는 도킹 상태로 등록되지 않습니다.

2025-06-05

  Home API 공개 베타 출시 1.3.1  

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

최소 버전

• Google Play 서비스: 25.19.32
• Google 허브 펌웨어, Cast: 3.75.468222
• Google 허브 펌웨어, Fuchsia: 26.20250116.103.2201
• Android SDK: home.android.sdk_202505_EAP_1_3_1_RC06
• Google Home 앱: 모든 버전에서 작동
• androidx.core 라이브러리: 모든 버전에서 작동
• Matter 버전: 1.4.0.0

새로운 기능

• Matter 스위치 기기에서 생성된 이벤트의 처리를 간소화하고 스위치가 자동화 시작 조건을 트리거할 수 있도록 하는 SyntheticSwitch 특성 도입
• ExtendedDoorLock 특성에 브레이킹 체인지가 있습니다. user_id 필드 데이터 유형이 String에서 Long로 변경되었습니다. 이 특성을 사용하는 앱은 다시 컴파일해야 합니다.

기타 주목할 만한 변경사항

• Android 샘플 앱은 구조, 기기, 유형, 특성, 자동화의 상태를 로깅하는 기능을 추가하여 디버깅을 더 쉽게 만듭니다.

알려진 문제 해결

• Google Home 앱에서 홈 위치를 설정하지 않으면 자동화를 생성할 때 Google Home 앱이 FailedPreconditionException 오류와 함께 비정상 종료됩니다.
• Android 샘플 앱에서 connectivityState PARTIALLY_ONLINE가 있는 기기가 오프라인으로 표시되었습니다. 이제 이 상태가 온라인으로 표시됩니다.

알려진 문제

• Android 샘플 앱에서 자동화 만들기 버튼을 트리거하려면 여러 번 탭해야 하는 경우가 있습니다.

2025-05-12

  Home APIs 공개 베타 출시 1.3  

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

최소 버전

• Google Play 서비스: 25.16.33
• Google 허브 펌웨어, Cast: 3.75.468222
• Google 허브 펌웨어, Fuchsia: 26.20250116.103.2201
• Android SDK: home.android.sdk_202504_EAP_1_3_RC00
• Google Home 앱: 모든 버전에서 작동
• androidx.core 라이브러리: 모든 버전에서 작동
• Matter 버전: 1.4.0.0

새로운 기능

• 개발자가 cron 표현식을 사용하여 시계 시간, 태양 시간, 캘린더 기반 조건을 기반으로 주기적으로 실행되는 자동화를 만들 수 있는 자동화 API에 반복 일정 이벤트 시작 조건 지원이 추가되었습니다.
• Device API에서 기기 이름을 변경하는 기능이 추가되었습니다.
• 구조 API에서 방 이름을 바꿀 수 있는 기능이 추가되었습니다.

알려진 문제 해결

• Wi-Fi에서 모바일 네트워크로 전환하면 기기 제어 지연 시간이 늘어날 수 있습니다.
• 허브를 초기화하면 기기가 오프라인으로 표시될 수 있습니다.

알려진 문제

• Google Home 앱에서 집 위치를 설정하지 않으면 자동화를 생성할 때 FailedPreconditionException와 함께 Google Home 앱이 비정상 종료됩니다. 해결 방법: 자동화를 생성하기 전에 Discovery API를 사용하여 집 주소가 있는지 확인하세요.

2025-04-09

  Home API 공개 베타 출시 1.2.1  

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

최소 버전

• Google Play 서비스: 25.09.33
• Google 허브 펌웨어 최소 버전:
  • 전송: 3.75.468222
  • Fuchsia: 24.20241009.103.1900601¹
• Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
• Google Home 앱: 모든 버전과 호환됨
• androidx.core 라이브러리: 1.10.0
• Matter 버전: 1.4.0.0

^{1. 이 빌드는 현재 프로덕션에 출시되고 있으며 2025년 4월 22일까지 모든 기기에서 사용할 수 있습니다.}

새로운 기능

• 홈 그래프에서 객체를 로드할 때 성능이 개선되었습니다.
• Automation API
  • 자동화에서 지정된 기준에 따라 자동화가 기기를 동적으로 선택할 수 있는 엔티티 필터 지원이 추가되었습니다.
• 기기 API
  • 이제 BasicInformationTrait에서 클라우드 간 기기 정보를 확인할 수 있습니다.

알려진 문제

• Wi-Fi에서 모바일 네트워크로 전환하면 기기 제어 지연 시간이 늘어날 수 있습니다.
• 허브를 초기화하면 기기가 오프라인으로 표시될 수 있습니다.

알려진 문제 해결

• 초기화 전에 또는 초기화가 완료되기 전에 Discovery API가 호출되면 code 14: UNKNOWN 및 '경로를 찾을 수 없습니다'라는 메시지와 함께 HomeException이 발생합니다.
• 구조와 사용자가 여러 개인 환경에서는 구조와 사용자 간에 전환하면 기기가 반환되지 않을 수 있습니다.

2025-03-14

  Home API 공개 베타 버전 1.2.0  

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

최소 버전

• Google Play 서비스 최소 버전: 25.06.32
• Google 허브 펌웨어 최소 버전:
  • Cast 버전: 3.75.456944
  • Fuchsia 최소 버전: 24.20241009.103.1900601
• Android SDK: home.android.sdk_1_2_0_RC06
• Google Home 앱 최소 버전: 모든 버전에서 작동
• androidx.core 라이브러리 최소 버전: 1.10.0
• Matter 버전: 1.3.0.0
  • 참고: 임시 Matter 기기 유형과 클러스터는 지원되지 않습니다.

새로운 기능

• Automation API:
  • 자동화 조건에서 기간 및 부분 날짜 지원 between을 사용하여 날짜 사용하기를 참고하세요.
  • 이전 출시에서는 Discovery API가 BitmapConstraint를 반환해야 할 때 일부 비트맵 필드에 NumberSetConstraint를 반환했습니다. 이제 이러한 필드는 예상대로 BitmapConstraint를 반환합니다. 이는 LevelControl 트레이트 명령어의 optionsMask 및 optionsOverride 비트맵으로 제한됩니다.

알려진 문제

• Wi-Fi에서 모바일 네트워크로 전환하면 기기 제어 지연 시간이 늘어날 수 있습니다.
• 허브를 초기화하면 기기가 오프라인으로 표시될 수 있습니다.
• 초기화 전에 또는 초기화가 완료되기 전에 Discovery API가 호출되면 code 14: UNKNOWN 및 '경로를 찾을 수 없습니다'라는 메시지와 함께 HomeException이 발생합니다.
  • 해결 방법: 실제로 자동화 후보가 필요한 경우에만 Discovery API를 호출하세요. 후보 항목을 프리패치하고 캐시하지 않습니다. 엔티티에서 Discovery API 메서드를 호출하기 전에 엔티티가 온라인 상태인지 확인합니다.
• 구조와 사용자가 여러 개인 환경에서는 구조와 사용자 간에 전환하면 기기가 반환되지 않을 수 있습니다.

알려진 문제 해결

• Home API 앱이 실행된 후 처음으로 HomeManager.structures()를 호출하면 하나 이상의 구조가 있어도 구조를 0개 수신합니다. 이로 인해 Google 계정과 연결된 구조가 없다는 잘못된 인상을 줄 수 있습니다.
• 자동화를 로드, 생성, 수정할 때 사용자가 오래 기다려야 할 수 있습니다.
• 카메라 앱에서 설정 흐름을 시작하는 사용자는 Matter 커미셔닝을 완료하기 위해 QR 코드를 두 번 스캔해야 합니다.
• 기기가 200개를 초과하는 구조에서는 검색 API가 후보를 반환하지 않을 수도 있습니다.

2025-01-29

  Home API 공개 베타 출시 1.1.0  

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

최소 버전

• Google Play 서비스 최소 버전: 25.02.32
• Google 허브 펌웨어 최소 버전:
  • Cast 버전: 3.75.456944
  • Fuchsia 최소 버전: 24.20241009.103.1900500
• Android SDK: home.android.sdk_202412_EAP_1_1_RC04
• Google Home 앱 최소 버전: 모든 버전에서 작동
• androidx.core 라이브러리 최소 버전: 1.10.0
• Matter 버전: 1.3.0.0
  • 참고: 임시 Matter 기기 유형과 클러스터는 지원되지 않습니다.

새로운 기능

• 스트리밍 API:
  • 추가, 변경, 삭제된 구조, 방, 기기를 알리는 이벤트 스트림을 제공합니다.
  • 엔티티 관계 이벤트 구독을 참고하세요.
• 배치 API (실험용):
  • 개발자가 동시에 실행되는 일괄 명령어를 여러 개 보낼 수 있습니다.
  • 한 번에 여러 명령어 보내기를 참고하세요.

알려진 문제

• 자동화를 로드, 생성, 수정할 때 사용자가 오래 기다려야 할 수 있습니다.
• 카메라 앱에서 설정 흐름을 시작하는 사용자는 Matter 커미셔닝을 완료하기 위해 QR 코드를 두 번 스캔해야 합니다.
• 기기가 200개를 초과하는 구조에서는 검색 API가 후보를 반환하지 않을 수도 있습니다.

알려진 문제 해결

• 로그인된 Google 계정을 전환하면 실패하고 오류가 발생할 수 있습니다.
• Google TV 기기는 MediaPlayback 특성을 사용하는 자동화에 작동하지 않을 수 있습니다.
• Google 허브만 포함된 구조의 경우:
  • Matter 기기가 Google Home 앱에서 오프라인으로 표시될 수 있습니다.
  • Google 어시스턴트가 Matter 기기를 제어할 수 없습니다.
  • 스마트 디스플레이는 Matter 기기를 제어하거나 Matter 기기의 상태를 표시할 수 없습니다.
• 일부 기기의 경우 앱에 정확한 상태가 항상 반영되지 않을 수 있으며, 앱에서 Google Home 앱과 같은 Google 앱에서 보고한 상태와 다른 상태를 보고할 수 있습니다. 이는 일반적으로 기기에서 Google에 상태를 보고하지 않기 때문입니다.
  • 해결 방법: Google 앱으로 상태를 확인하면 불일치가 해결됩니다.

2025-01-14

Home API 초기화 안내가 업데이트되었습니다.

홈 인스턴스를 컨텍스트 싱글톤으로 초기화해야 한다는 점을 더 명확하게 했습니다. 이렇게 하면 앱에서 더 원활한 사용자 환경을 제공하고 잘못된 세션으로 인한 오류를 방지할 수 있습니다.

2025-01-07

  Home API 공개 베타 출시  

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

이번 출시에는 버그 수정이 포함되어 있으며 Google Nest Audio 및 Google TV 기기 지원 개선을 비롯해 Home API Android SDK의 베타 품질이 향상되었습니다.

최소 버전

• Google Play 서비스 최소 버전: 24.45.34
• Google 허브 펌웨어 최소 버전:
  • Cast 버전: 3.74.444798
  • Fuchsia 최소 버전: 22.20240805.103.161
• Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
• Google Home 앱 (GHA) 최소 버전: 모든 버전에서 작동
• androidx.core 라이브러리 최소 버전: 1.10.0
• Matter 버전: 1.3.0.0
  • 참고: 임시 Matter 기기 유형과 클러스터는 지원되지 않습니다.

알려진 문제

• 로그인된 Google 계정을 전환하면 실패하고 오류가 발생할 수 있습니다.
  • 해결 방법: 권한 흐름을 다시 실행하거나 앱을 다시 시작합니다.
• Google TV 기기는 MediaPlayback 특성을 사용하는 자동화에서 작동하지 않을 수 있습니다.
• Google 허브만 포함된 구조의 경우:
  • Matter 기기가 Google Home 앱 (GHA)에 오프라인으로 표시될 수 있습니다.
  • Google 어시스턴트가 Matter 기기를 제어할 수 없습니다.
  • 스마트 디스플레이는 Matter 기기를 제어하거나 Matter 기기의 상태를 표시할 수 없습니다.
• 일부 기기의 경우 앱이 항상 정확한 상태를 반영하지 않을 수 있으며 앱이 Google Home 앱 (GHA)과 같은 Google 앱에서 보고한 상태와 다른 상태를 보고할 수 있습니다. 이는 일반적으로 기기에서 Google에 상태를 보고하지 않기 때문에 발생합니다.
  • 해결 방법: Google 앱으로 상태를 확인하면 불일치가 해결됩니다.

알려진 문제 해결

• 프로세스 중에 앱이 최소화되면 커미셔닝이 실패할 수 있습니다.
  • 해결 방법: 앱에서 커미셔닝 API를 사용하는 경우 suppressHalfSheetNotification() API를 사용하여 절반 시트 알림을 억제합니다.
• 서버 측 문제로 인해 OkGoogle 스타터가 자동화에서 작동하지 않을 수 있습니다.
• 구조에 Matter 기기가 없는 Fuchsia를 실행하는 허브를 사용하는 경우 허브가 3시간 이상 유휴 상태로 유지되면 첫 번째 Matter 기기를 커미셔닝하면 Matter 기기가 오프라인 상태가 됩니다.
• 허브를 초기화한 후 새로 커미셔닝된 기기에 대한 명령어가 기기가 온라인으로 보고되더라도 실패할 수 있습니다.