Home API Android SDK 출시 노트

2025-06-05

  Home APIs 공개 베타 출시 1.3.1  

이 버전에는 버그 수정사항이 포함되어 있으며 Home APIs Android SDK의 베타 품질이 향상되었습니다.

최소 버전

  • Google Play 서비스: 25.19.32
  • Google 허브 펌웨어 최소 버전:
    • 전송: 3.75.468222
    • 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

새로운 기능

특성

Android 샘플 앱

디버깅을 쉽게 하기 위해 구조, 기기, 유형, 트레잇, 자동화의 상태를 기록하는 함수를 추가했습니다.

알려진 문제

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

알려진 문제 해결

  • Google Home 앱(GHA)에 집 위치가 설정되지 않은 경우 자동화를 만들 때 Google Home 앱이 FailedPreconditionException과 함께 비정상 종료됩니다. 집 위치를 설정하는 방법은 Google 집 주소 변경을 참고하세요.
  • Android 샘플 앱에서 connectivityState PARTIALLY_ONLINE가 있는 기기는 이전에 사용자에게 오프라인으로 표시되었습니다. 이 상태는 이제 online으로 표시됩니다.

2025-05-12

  Home APIs 공개 베타 출시 1.3  

이 버전에는 버그 수정사항이 포함되어 있으며 Home APIs Android SDK의 베타 품질이 향상되었습니다.

최소 버전

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

새로운 기능

  • Automation API
    • 개발자가 cron 표현식을 사용하여 시계 시간, 일광 절약 시간, 캘린더 기반 조건에 따라 주기적으로 실행되는 자동화를 만들 수 있는 예약된 반복 이벤트 시작 조건에 대한 지원이 추가되었습니다.
  • Device API
    • 기기 이름을 바꾸는 기능이 추가되었습니다. 기기 이름 변경을 참고하세요.
  • Structure API

알려진 문제

Google Home 앱(GHA)에 집 위치가 설정되어 있지 않으면 자동화를 만들 때 Google Home 앱이 FailedPreconditionException과 함께 비정상 종료됩니다. 방법은 Google 집 주소 변경을 참고하세요.

  • 해결 방법: 자동화를 만들기 전에 Discovery API를 사용하여 집 주소가 있는지 확인합니다.

알려진 문제 해결

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

2025-04-09

  Home APIs 공개 베타 출시 1.2.1  

이 버전에는 버그 수정사항이 포함되어 있으며 Home APIs Android SDK의 베타 품질이 향상되었습니다.

최소 버전

  • Google Play 서비스: 25.09.33
  • Google 허브 펌웨어 최소 버전:
    • 전송: 3.75.468222
    • Fuchsia: 24.20241009.103.19006011
  • 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
    • 자동화가 자동화에 지정된 기준에 따라 기기를 동적으로 선택할 수 있는 항목 필터 지원을 추가했습니다.
  • Device API

알려진 문제

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

알려진 문제 해결

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

2025-03-14

  Home API 공개 베타 출시 1.2.0  

이 버전에는 버그 수정사항이 포함되어 있으며 Home APIs Android SDK의 베타 품질이 향상되었습니다.

최소 버전

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

2025-01-29

  Home APIs 공개 베타 출시 1.1.0  

이 버전에는 버그 수정사항이 포함되어 있으며 Home APIs Android SDK의 베타 품질이 향상되었습니다.

최소 버전

  • 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 (실험용):

알려진 문제

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

알려진 문제 해결

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

2025-01-14

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

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

2025-01-07

  Home APIs 공개 베타 출시  

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

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

최소 버전

  • 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 허브만 포함된 구조:
    • Matter 기기가 Google Home 앱 (GHA)에 오프라인으로 표시될 수 있습니다.
    • Google 어시스턴트는 Matter 기기를 제어할 수 없습니다.
    • 스마트 디스플레이는 Matter 기기를 제어하거나 Matter 기기의 상태를 표시할 수 없습니다.
  • 일부 기기의 경우 앱이 정확한 상태를 반영하지 않을 수 있으며 앱이 Google Home 앱 (GHA)과 같은 Google 앱에서 보고한 상태와 다른 상태를 보고할 수 있습니다. 이는 일반적으로 기기가 Google에 상태를 보고하지 않기 때문에 발생합니다.
    • 해결 방법: Google 앱으로 상태를 확인하면 불일치가 해결됩니다.

알려진 문제 해결

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