Home API Android SDK 출시 노트

2025-01-07

  Home API 공개 베타 출시  

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

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

최소 버전

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

알려진 문제 해결

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