이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Home API Android SDK 출시 노트

2025-03-14

Home API 공개 베타 출시 1.2.0

이 버전에는 버그 수정사항이 포함되어 있으며 Home APIs Android SDK의 정식 버전 (GA) 품질이 개선되었습니다.

Google Play 서비스 최소 버전: 25.06.32
Google 허브 펌웨어 최소 버전:
- 전송 버전: 3.75.456944
- Fuchsia 최소 버전: 24.20241009.103.1900601
Android SDK: home.android.sdk_202412_EAP_1_2_RC01
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 APIs 앱이 실행된 후 HomeManager.structures()를 처음 호출하면 하나 이상의 구조가 있는 경우에도 구조가 0개 수신됩니다. 이로 인해 Google 계정과 연결된 구조가 없다는 잘못된 인상을 줄 수 있습니다.
자동화를 로드, 생성, 수정할 때 사용자가 오랜 시간 기다려야 할 수 있습니다.
카메라 앱에서 설정 흐름을 시작하는 사용자는 Matter 커미셔닝을 완료하기 위해 QR 코드를 두 번 스캔해야 합니다.
기기가 200개를 초과하는 구조에서는 Discovery API가 후보를 반환하지 않을 수도 있습니다.

Home APIs 공개 베타 출시 1.1.0

이 출시에는 버그 수정사항이 포함되어 있으며 Home APIs Android SDK의 정식 버전 (GA) 품질이 개선되었습니다.

Google Play 서비스 최소 버전: 25.02.32
Google 허브 펌웨어 최소 버전:
- 전송 버전: 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 기기 유형 및 클러스터는 지원되지 않습니다.

Streaming API:
- 추가, 변경, 삭제된 구조, 공간, 기기를 알리는 이벤트 스트림을 제공합니다.
- 항목 관계 이벤트 구독을 참고하세요.
일괄 처리 API (실험용):
- 개발자가 동시에 실행되는 여러 명령어를 일괄적으로 전송할 수 있습니다.
- 한 번에 여러 명령어 전송을 참고하세요.

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

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

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

Home APIs 공개 베타 출시

공개 개발자 베타 기간 동안 모든 개발자는 앱 빌드 및 테스트를 시작할 수 있습니다.

이 버전에는 버그 수정사항이 포함되어 있으며, Google Nest Audio 및 Google TV 기기의 지원 개선을 비롯하여 Home APIs Android SDK의 정식 버전 (GA) 품질이 향상되었습니다.

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

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