Catatan rilis Android SDK Home API

2026-10-22

  Rilis GA API Home 1.11.1  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas GA untuk SDK Android Home API.

Versi minimum

• Layanan Google Play: 26.40.32
• Firmware hub Google, Cast, Nest Wifi Pro: 3.78.556638
• Firmware hub Google, Cast, Semua hub berbasis Cast lainnya: 3.79.558061
• Firmware hub Google, Fuchsia: 31.20260429.103.8713700
• Firmware hub Google, Google TV Streamer (4k): UTTK.260317.003
• Android SDK: home.android.sdk_1_11_1.zip
• Aplikasi Google Home: berfungsi dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.1.0
• Versi Matter: dukungan eksperimental untuk 1.5.0

Fitur baru

• Dukungan untuk membuat, memperbarui, dan menghapus kurva pencahayaan otomatis yang menyesuaikan kecerahan dan suhu warna sepanjang hari di seluruh ruangan atau perangkat lampu tertentu.
• Menambahkan panduan tentang cara platform menangani penghapusan data pengguna otomatis saat pengguna keluar dari struktur atau menghapus Akun Google mereka, dan cara pengguna dapat mengekspor data mereka menggunakan Google Takeout.
• Dukungan untuk mengonfigurasi dan mengambil lokalitas aplikasi menggunakan setLocale() dan getLocale() untuk alur UI yang dihosting SDK, beserta kolom teks yang dilokalkan (localizedTexts dan localizedBodies) dalam teks AI dan peristiwa cloud ringkasan AI.
• Dukungan untuk mengontrol DeviceGroup sebagai satu entity melalui bagian jenis perangkatnya, serta memeriksa keanggotaan grup di setiap perangkat dan mengelompokkan perintah di seluruh anggota grup.

Perubahan penting lainnya

• Referensi API Kotlin telah diupdate.

Masalah umum

• Setelah kamera dinyalakan ulang, status konektivitasnya mungkin dilaporkan sebagai PARTIAL_ONLINE, bukan ONLINE. Semua fitur kamera cloud terus berfungsi seperti biasa, kecuali penonaktifan Matter.

2026-09-23

  Rilis GA API Home 1.11  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas GA untuk SDK Android Home API.

Versi minimum

• Layanan Google Play: 26.36.25
• Firmware hub Google, Cast, Nest Wifi Pro: 3.78.548779
• Firmware hub Google, Cast, Semua hub berbasis Cast lainnya: 3.79.550760
• Firmware hub Google, Fuchsia: 31.20260429.103.8712702
• Firmware hub Google, Google TV Streamer (4k): UTTK.260317.003
• Android SDK: home.android.sdk_GHP_1_11
• Aplikasi Google Home: berfungsi dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.1.0
• Versi Matter: dukungan eksperimental untuk 1.5.0

warning Info terbaru penting warning

• Mulai rilis v1.11, Home API memerlukan Kotlin 2.4.0. Jika Anda mengompilasi aplikasi Home API dengan versi Kotlin yang lebih lama, Anda harus menggunakan opsi compiler -Xskip-metadata-version-check untuk menyembunyikan error terkait metadata.
• Mulai rilis v1.11, untuk mempertahankan dukungan dengan Coroutine Kotlin terbaru, developer harus mengupdate file gradle mereka untuk mengimpor library kotlinx.coroutines. Error runtime pemblokiran akan terjadi untuk semua aplikasi Kotlin yang menggunakan Home API jika update ini tidak dilakukan.

Fitur baru

• Grup perangkat dapat dibuat dalam satu struktur. Grup perangkat mewakili kumpulan perangkat yang ditentukan pengguna.

Perubahan penting lainnya

• Referensi API Kotlin telah diupdate.

2026-09-16

Kami telah meluncurkan dua server MCP baru. MCP Home memungkinkan agen pribadi berinteraksi dengan smart home Anda dengan aman, sedangkan MCP Home Developer menyediakan dokumentasi dari Pusat Developer Home dan resource smart home lainnya untuk ditelusuri dan dikueri oleh agen favorit Anda.

Fitur baru

• Panduan pengguna MCP Home
• Panduan pengguna MCP Home Developer

2026-09-16

Aplikasi Contoh Android Home API telah diupdate untuk rilis Home API 1.10.1.

Aplikasi contoh

• Lihat rilis GitHub v1.10.1 untuk mengetahui catatan rilis lengkap.

2026-08-28

  Rilis GA Home API 1.10.1  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas GA untuk SDK Android Home API.

Versi minimum

• Layanan Google Play: 26.34.30
• Firmware hub Google, Cast, Nest Wifi Pro: 3.78.548779
• Firmware hub Google, Cast, Semua hub berbasis Cast lainnya: 3.79.547681
• Firmware hub Google, Fuchsia: 31.20260429.103.8712702
• Firmware hub Google, Google TV Streamer (4k): UTTK.260317.003
• Android SDK: home.android.sdk_GHP_1_10_1
• Aplikasi Google Home: berfungsi dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.1.0
• Versi Matter: dukungan eksperimental untuk 1.5.0

warning Info terbaru penting warning

• Mulai rilis v1.11, untuk mempertahankan dukungan dengan Coroutine Kotlin terbaru, developer harus mengupdate file gradle mereka untuk mengimpor library kotlinx.coroutines. Error runtime pemblokiran akan terjadi untuk semua aplikasi Kotlin yang menggunakan Home API jika update ini tidak dilakukan.

Fitur baru

• Parameter perintah dinamis kini didukung di Automation API.
• Logika jika/maka kini didukung di Automation API.

Perubahan penting lainnya

• Referensi API Kotlin telah diupdate.

2026-08-07

Aplikasi Contoh Android Home API telah diupdate untuk rilis Home API 1.10.

Aplikasi contoh

• Lihat rilis GitHub v1.10 untuk mengetahui catatan rilis lengkap.

2026-08-03

  Rilis GA API Home 1.10  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas Android SDK Home API ke kualitas GA.

Versi minimum

• Layanan Google Play: 26.28.31
• Firmware hub Google, Cast, Nest Wifi Pro: 3.78.518349
• Firmware hub Google, Cast, Semua hub berbasis Cast lainnya: 3.78.540761
• Firmware hub Google, Fuchsia: 30.20260121.103.1602904
• Firmware hub Google, Google TV Streamer (4k): UTTK.260317.003
• Android SDK: home.android.sdk_GHP_1_10
• Aplikasi Google Home: berfungsi dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.1.0
• Versi Matter: dukungan eksperimental untuk 1.5.0

2026-07-09

Flag forceLaunch tidak digunakan lagi. Aplikasi harus bermigrasi ke enum ForcePermissionFlow untuk menentukan perilaku UI izin.

Perubahan mendatang

• API yang tidak digunakan lagi: Metode requestPermissions(forceLaunch: Boolean, ...) tidak digunakan lagi di Google Home SDK Android.
• Langkah migrasi: Ganti flag boolean dengan ForcePermissionFlow.FORCE_LAUNCH (untuk true) atau ForcePermissionFlow.DO_NOT_FORCE_LAUNCH (untuk false).

2026-07-08

Panduan perangkat router pembatas untuk Android kini tersedia.

Konten baru

• Panduan perangkat router pembatas untuk Android kini tersedia.

2026-07-07

Aplikasi Contoh Android Home API telah diupdate untuk rilis Home API 1.9.1.

Aplikasi contoh

• Lihat rilis GitHub v1.9.1 untuk mengetahui catatan rilis lengkap.

2026-06-26

  Rilis beta versi publik API Home 1.9.1  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk SDK Android Home API.

Versi minimum

• Layanan Google Play: 26.24.22
• Firmware hub Google, Cast, Nest Wifi Pro: 3.78.518349
• Firmware hub Google, Cast, Semua hub berbasis Cast lainnya: 3.78.538123
• Firmware hub Google, Fuchsia: 30.20260121.103.1602904
• Firmware hub Google, Google TV Streamer (4k): UTTK.250729.004 (14748786)
• Android SDK: home.android.sdk_1_9_1.zip
• Aplikasi Google Home: berfungsi dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.1.0
• Versi Matter: dukungan eksperimental untuk 1.5.0

Fitur baru

• Kamera dan Bel Pintu: Status penggantian baterai
• Dukungan snapshot gambar Kamera dan Bel Pintu untuk digunakan sebagai pratinjau selama penyiapan Zona Aktivitas dan Tayangan Live.

Masalah umum yang telah diperbaiki

• Pengaktifan Sambungan Cepat tidak didukung untuk model perangkat Google Nest Cam Outdoor (berkabel, generasi ke-2), Google Nest Cam Indoor (berkabel, generasi ke-3), dan Doorbell (berkabel, generasi ke-3).

2026-06-09

Aplikasi Contoh Android Home API telah diupdate untuk rilis Home API 1.9.0.

Aplikasi contoh

• Lihat rilis GitHub v1.9.0 untuk mengetahui catatan rilis lengkap.

2026-05-29

  Rilis beta versi publik API Home 1.9  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk SDK Android Home API.

Versi minimum

• Layanan Google Play: 26.20.31
• Firmware hub Google, Cast, Nest Wifi Pro: 3.78.518349
• Firmware hub Google, Cast, Semua hub berbasis Cast lainnya: 3.78.526062
• Firmware hub Google, Fuchsia: 30.20260121.103.1602904
• Firmware hub Google, Google TV Streamer (4k): UTTK.250729.004 (14748786)
• Android SDK: home.android.sdk_GHP_1_9
• Aplikasi Google Home: berfungsi dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.1.0
• Versi Matter: dukungan eksperimental untuk 1.5.0

Fitur baru

• Setelan Kamera dan Bel Pintu: Jenis penyangga kamera
• Setelan Kamera dan Bel Pintu: Pemberitahuan kedatangan tamu
• Setelan Kamera dan Bel Pintu: Preferensi kualitas live stream
• Respons Cepat Bel Pintu
• Prapemilihan struktur untuk memungkinkan partner memilih struktur terlebih dahulu untuk alur izin
• Dukungan untuk perangkat multi-komponen dalam otomatisasi
• Pembaruan pada karakteristik Google kustom berikut: ExtendedFanControl, ExtendedThermostat
• Pembaruan pada karakteristik Matter berikut: ArmDisarm, FanControl, Thermostat, ThermostatFanControl, ThermostatUserInterfaceConfiguration

Masalah umum

• Pengaktifan Sambungan Cepat tidak didukung untuk model perangkat Google Nest Cam Outdoor (berkabel, generasi ke-2), Google Nest Cam Indoor (berkabel, generasi ke-3), dan Doorbell (berkabel, generasi ke-3).

2026-05-26

Aplikasi Contoh Android Home API telah diupdate untuk rilis Home API 1.8.1.

Aplikasi contoh

• Lihat rilis GitHub v1.8.1 untuk mengetahui catatan rilis lengkap.

2026-05-01

  API Home beta versi publik 1.8.1  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk SDK Android Home API.

Versi minimum

• Layanan Google Play: 26.16.31
• Firmware hub Google, Cast, Nest Wifi Pro: 3.78.518349
• Firmware hub Google, Cast, Semua hub berbasis Cast lainnya: 3.78.526062
• Firmware hub Google, Fuchsia: 30.20260121.103.1602802
• Firmware hub Google, Google TV Streamer, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_8_1
• Aplikasi Google Home: 4.8 atau yang lebih baru
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.1.0
• Versi Matter: dukungan eksperimental untuk 1.5.0

Fitur baru

• Karakteristik termostat kini mendukung kemampuan Baca/Perbarui, Aktif/Nonaktif, dan Timer

Masalah umum yang telah diperbaiki

• Commissioning perangkat Matter mungkin gagal.
• Lampu BLE Philips tidak menampilkan status yang benar.
• Latensi yang menyebabkan ketidakstabilan jaringan dan waktu respons yang lambat.

Masalah umum

• Tidak dapat mengaktifkan beberapa perangkat menggunakan Google TV Streamer (4K).
• Jika hub adalah Nest Wifi Pro, Google Nest Hub, atau Google Nest Hub Max, Aplikasi Google Home akan menampilkan perangkat multibagian sebagai beberapa kartu.

2026-04-10

Aplikasi Contoh Android Home API telah diupdate untuk rilis Home API 1.8.

Aplikasi contoh

• Lihat rilis GitHub v1.8.0 untuk mengetahui catatan rilis lengkap.

2026-04-09

  Rilis beta versi publik API Home 1.8  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk SDK Android Home API.

Versi minimum

• Layanan Google Play: 26.12.32
• Firmware hub Google, Cast, Nest Wifi Pro: 3.78.518349
• Firmware hub Google, Cast, Semua hub berbasis Cast lainnya: 3.78.526062
• Firmware hub Google, Fuchsia: 29.20251023.103.2101601
• Firmware hub Google, Google TV Streamer, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_8_0
• Aplikasi Google Home: berfungsi dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.1.0
• Versi Matter: dukungan eksperimental untuk 1.5.0

Fitur baru

• Otomatisasi yang disarankan di Automations API.
• Dukungan untuk perangkat multipart di Device API.
• Penyiapan Zona Aktivitas Kamera dan Bel Pintu di Device API.
• Penyiapan Deteksi Suara Kamera dan Bel Pintu di Device API.
• Mode Perekaman Kamera dan Bel Pintu (CVR/EVR/Tanpa Histori) di Device API.

Masalah umum yang telah diperbaiki

• Tidak dapat mengubah satuan suhu (C/F) Google Nest Learning Thermostat (generasi ke-4).
• Di Google Home untuk web versi seluler, ikon atas dan tombol kembali tertutup oleh header. Pengguna mungkin tidak dapat kembali atau melihat elemen antarmuka pengguna utama.
• Hub Android TV mungkin salah melaporkan perangkat Matter sebagai "Offline".

Masalah umum

• Commissioning perangkat Matter mungkin gagal.

2026-03-13

  Home API rilis beta versi publik 1.7.1  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk SDK Android Home API.

Versi minimum

• Layanan Google Play:
• Firmware hub Google, Cast, Nest Wifi Pro: 3.78.518349
• Firmware hub Google, Cast, Semua hub berbasis Cast lainnya: 3.78.516526
• Firmware hub Google, Fuchsia: 29.20251023.103.2201
• Firmware hub Google, Google TV Streamer, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_7_1
• Aplikasi Google Home: 1.7.1
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.1.0
• Versi Matter: dukungan eksperimental untuk 1.5.0

Fitur baru

• Keikutsertaan dalam Analisis Kamera dan Bel Pintu di Device API.
• Waktu terakhir terhubung Kamera dan Bel Pintu di Device API.
• Status Konektivitas Kamera dan Bel Pintu di Device API.
• Permintaan atomik termostat di Device API.

Perubahan penting lainnya

• Mode tanpa hub telah dihapus.

Aplikasi contoh

• Aplikasi Contoh Android Home API v1.7.1. Lihat rilis GitHub untuk mengetahui detailnya.

Masalah umum yang telah diperbaiki

• Untuk Nest Cam Indoor/Outdoor (baterai atau berkabel) dan Nest Doorbell (baterai, generasi ke-2), Opsi "Sisa Waktu Baterai" tidak ada di Setelan Baterai.
• Setelan durasi bel diabaikan.
• Lampu BLE Philips salah muncul sebagai "Online" meskipun perangkat sebenarnya offline.

Masalah umum

• Tidak dapat mengubah satuan suhu (C/F) Google Nest Learning Thermostat (generasi ke-4).
• Potensi keterlambatan dalam stabilitas jaringan dan responsivitas perangkat.
• Di Google Home untuk Web versi seluler, ikon atas dan tombol kembali tertutup oleh header. Pengguna mungkin tidak dapat kembali atau melihat elemen antarmuka pengguna utama.
• Hub mungkin macet dalam status "Menghubungkan..." setelah OOBE mode Gabungan.
• Commissioning perangkat Matter mungkin gagal.
• Hub Android TV mungkin salah melaporkan perangkat Matter sebagai Offline.
• Versi software yang benar mungkin tidak muncul untuk versi Software Perangkat Kamera Saat Ini.
• Penggeser UI Termostat menampilkan suhu yang berada di luar rentang.
• Jika Durasi Bel diatur, perangkat tidak akan berbunyi selama durasi yang ditentukan.

2026-02-13

Aplikasi Contoh Android Home API telah diupdate untuk rilis Home API 1.7.

Aplikasi contoh

• Lihat rilis GitHub v1.7.0 untuk mengetahui catatan rilis lengkap.

2026-02-09

  Rilis beta versi publik Home API 1.7  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk SDK Android Home API.

Versi minimum

• Layanan Google Play: 26.02.34
• Firmware hub Google, Cast, Nest Wifi Pro: 3.76.508025
• Firmware hub Google, Cast, Semua hub berbasis Cast lainnya: 3.77.510748
• Firmware hub Google, Fuchsia: 29.20251023.103.2100
• Firmware hub Google, Google TV Streamer, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_7
• Aplikasi Google Home: 1.7
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.1.0
• Versi Matter: dukungan eksperimental untuk 1.5.0

Fitur baru

• Otomatisasi Lokal: berdasarkan kondisi seperti konektivitas, jenis perangkat, dan karakteristik, beberapa otomatisasi kini dapat dijalankan secara lokal di Automations API.
• Pengaktifan Out-of-Box Experience (OOBE) Kamera di aplikasi dalam Device API.
• Tema Bel Pintu dan Kamera di Device API.
• Penghemat Baterai Otomatis Kamera dan Bel Pintu di Device API.
• Preferensi Penggunaan Baterai Kamera dan Bel Pintu di Device API.
• Status Pengisian Daya Baterai Kamera dan Bel Pintu di Device API.
• Level Baterai Kamera dan Bel Pintu di Device API.
• Nomor Seri Kamera dan Bel Pintu di Device API.
• Model Kamera dan Bel Pintu di Device API.
• Versi Software Kamera dan Bel Pintu di Device API.
• Custom Key-Value API di Device API.
• Kueri izin memungkinkan aplikasi menentukan jenis perangkat yang telah diberi akses oleh pengguna di Permissions API.

Perubahan penting lainnya

• HomeException.unsupported telah diganti dengan HomeException.unimplemented agar sesuai dengan kode error standar.
• Generator kode paket untuk karakteristik kustom telah berubah untuk rilis 1.7. Developer yang memiliki karakteristik kustom harus mengompilasi ulang karakteristik mereka setelah mengintegrasikan SDK 1.7.

Masalah umum yang telah diperbaiki

• History API selalu menampilkan nextPageToken, sehingga menyebabkan loop tanpa batas.
• Error "Pengguna membatalkan alur Izin" terjadi saat mencoba login ke akun baru.

Masalah umum

• Untuk Nest Cam Indoor/Outdoor (baterai atau berkabel) dan Nest Doorbell (baterai, generasi ke-2), Opsi "Sisa Waktu Baterai" tidak ada di Setelan Baterai.
• Setelan durasi bel diabaikan.
• Lampu BLE Philips salah muncul sebagai "Online" meskipun perangkat sebenarnya offline. Solusi: Jangan hanya mengandalkan status online Jenis Perangkat Smart Home (SHDT). Sebagai gantinya, gunakan peta Target Device State Service (TDSS) untuk perangkat dengan sumber LOCAL_SYNC.

2025-12-22

  API Home beta versi publik 1.6  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk SDK Android Home API.

Versi minimum

• Layanan Google Play: 25.47.30
• Firmware hub Google, Cast, Nest Wifi Pro: 3.75.479819
• Firmware hub Google, Cast, Semua hub berbasis Cast lainnya: 3.77.505721
• Firmware hub Google, Fuchsia: 28.20250723.103.2100300
• Firmware hub Google, Google TV Streamer, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_6
• Aplikasi Google Home: 1.6
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.1.0

Fitur baru

• Dukungan karakteristik Cuaca Automation API. Menambahkan dukungan untuk karakteristik Cuaca di pemicu dan kondisi otomatisasi.
• Dukungan untuk lebih banyak kemampuan perangkat Kamera dan Bel Pintu: Setelan baru (Night vision, LED Status, Area pandang, Orientasi, Sensitivitas, Durasi peristiwa, Bel).
• Login dengan Google yang dimulai aplikasi untuk menyederhanakan alur UX dan menghilangkan pemeriksaan pengguna aktif.
• Mode Tanpa Hub memungkinkan pengguna mengaktifkan dan mengontrol perangkat Matter tertentu tanpa hub mandiri.
• Hub Activation API untuk menemukan dan mengaktifkan hub.

Perubahan penting lainnya

• Aplikasi Contoh Android menambahkan setelan Kamera, Otomatisasi standar, dukungan Kipas dan Speaker.

Masalah umum

• Kontrol perangkat berhenti berfungsi setelah digunakan dalam waktu lama. Solusi: Mulai ulang hub.
• Commissioning perangkat Matter mungkin gagal.
• Error "User cancelled Permission flow" muncul saat mencoba menambahkan akun baru di Aplikasi Contoh untuk Android. Solusi: Tambahkan Akun Google melalui setelan perangkat Android.
• Kamera Keamanan berkabel Walmart onn yang diaktifkan menggunakan SDK Home API Android tidak dapat melakukan livestream melalui Aplikasi Google Home.
• Kamera yang diaktifkan di aplikasi Home API tidak dapat memulai sesi livestream dari Aplikasi Google Home.

2025-10-23

  Home API rilis beta versi publik 1.5.1  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk SDK Android Home API.

Versi minimum

• Layanan Google Play: 25.41.30
• Firmware hub Google, Cast: 3.76.495998
• Firmware hub Google, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_5_1
• Aplikasi Google Home: berfungsi dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.1.0

Fitur baru

• Hub Activation API memungkinkan Anda menemukan dan mengaktifkan hub Google Home secara terprogram di Structure API.

Perubahan penting lainnya

• Aplikasi Contoh Android menambahkan dukungan Jenis Perangkat Bel Pintu (OnOff, Livestream, Pembicaraan dua arah) dan implementasi Hub Activation API.

Masalah umum yang telah diperbaiki

• Aplikasi Contoh tidak menampilkan status perangkat dengan benar di tampilan Perangkat.

2025-09-26

  Home API rilis Beta Publik 1.5.0  

Rilis ini memperkenalkan dukungan untuk perangkat Kamera, berisi perbaikan bug, dan meningkatkan kualitas beta untuk SDK Android Home API.

Versi minimum

• Layanan Google Play: 25.37.31
• Firmware hub Google, Cast: 3.76.492738
• Firmware hub Google, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_5
• Aplikasi Google Home: berfungsi dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.1.0

Fitur baru

• Pemicu, kondisi, dan tindakan kini menerima struct Matter sebagai parameter di Automation API.
• Jenis perangkat kamera ditambahkan ke Device API (Livestream, Pembicaraan dua arah, Mulai/hentikan perekaman).

Perubahan penting lainnya

• Aplikasi Contoh Android menambahkan Dukungan untuk Kamera, Commissioning multi-admin, Otomatisasi OnOff yang telah ditetapkan.

Masalah umum yang telah diperbaiki

• Jika hub yang saat ini aktif dihapus paksa, ada periode lima menit saat beberapa perangkat tidak dapat dikontrol. Setelah lima menit, kemampuan untuk mengontrol perangkat akan dipulihkan.
• Setelah pengguna memilih warna dari preset atau dari pemilih suhu warna, Lampu Warna yang Diperluas gagal memperbarui warna.

Masalah umum

• Mungkin ada peningkatan latensi kontrol perangkat saat beralih dari Wi-Fi ke jaringan seluler.
• Kontrol jenis perangkat Kipas yang didukung oleh Cloud-to-cloud mungkin tidak berfungsi di Aplikasi Contoh.

2025-08-29

  Home API rilis beta versi publik 1.4.1  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk SDK Android Home API.

Versi minimum

• Layanan Google Play: 25.33.32
• Firmware hub Google, Cast: 3.76.495998
• Firmware hub Google, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_4_1
• Aplikasi Google Home: berfungsi dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.0.0

Fitur baru

• DecommissionIneligibleReason baru ditentukan untuk mencoba menonaktifkan perangkat multi-sumber di Device API.

Masalah umum yang telah diperbaiki

• Aplikasi Contoh Android error saat pengguna mencoba menyetel termostat ke mode yang tidak didukung.

Masalah umum

• Jika hub yang saat ini aktif dihapus paksa, ada periode lima menit saat beberapa perangkat tidak dapat dikontrol. Setelah lima menit, kemampuan untuk mengontrol perangkat akan dipulihkan.

2025-07-31

  Home API rilis beta versi publik 1.4.0  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk SDK Android Home API.

Versi minimum

• Layanan Google Play: 25.28.34
• Firmware hub Google, Cast: 3.76.486931
• Firmware hub Google, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_4_0
• Aplikasi Google Home: berfungsi dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.0.0

Fitur baru

• Otomatisasi dapat dibatasi untuk dijalankan hingga beberapa kali dalam Automation API.
• Kemampuan untuk menghapus perangkat Matter secara terprogram di Device API.
• Menghapus anggota HomeDevice yang tidak digunakan lagi (trait(), isInRoom, isInStructure).
• Home.hasPermissions() kini menggabungkan akses struktur OAuth dan pemberian izin aplikasi.

Perubahan penting lainnya

• Aplikasi Contoh Android menghapus perangkat khusus Matter, mengganti nama perangkat, mengganti panggilan API yang tidak digunakan lagi.

Masalah umum yang telah diperbaiki

• Perangkat penyedot debu yang telah dipasang ke dok tidak mendaftarkan status Terpasang ke dok.

Masalah umum

• Setelah logout dari ponsel dan login kembali, aplikasi Home API tidak dapat mengontrol perangkat. Solusi: Tutup aplikasi dan tunggu setidaknya 10 detik.

2025-06-26

  Home API rilis Beta Publik 1.3.2  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk Home API Android SDK.

Versi minimum

• Layanan Google Play: 25.23.31
• Firmware hub Google, Cast, Google Home, Google Home Mini, dan Google Nest Mini: 3.75.468362
• Firmware hub Google, Cast, Google Nest Audio: 3.75.476451
• Firmware hub Google, Fuchsia: 26.20250116.103.2900
• Android SDK: home.android.sdk_1_3_2
• Aplikasi Google Home: berfungsi dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.0.0

Fitur baru

• Artefak SDK telah dibagi menjadi dua artefak terpisah: Framework SDK Home API (play-services-home-17.0.0.aar) serta karakteristik dan jenis perangkat SDK (play-services-home-types-17.0.0.aar). Mulai rilis ini, developer harus menyertakan kedua artefak dalam jalur library waktu kompilasi dan runtime project mereka.

Perubahan penting lainnya

• Aplikasi Contoh Android menambahkan: Pengguna dapat memutuskan koneksi dan mencabut izin dari aplikasi.
• Penambahan Aplikasi Contoh Android: Artefak SDK yang diupdate untuk menyertakan play-services-home-17.0.0 dan play-services-home-types-17.0.0.

Masalah umum

• Perangkat penyedot debu yang telah dipasang ke dok tidak mendaftarkan status Terpasang ke dok.

2025-06-05

  Rilis beta versi publik API Home 1.3.1  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk Home API Android SDK.

Versi minimum

• Layanan Google Play: 25.19.32
• Firmware hub Google, Cast: 3.75.468222
• Firmware hub Google, Fuchsia: 26.20250116.103.2201
• Android SDK: home.android.sdk_202505_EAP_1_3_1_RC06
• Aplikasi Google Home: berfungsi dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.0.0

Fitur baru

• Memperkenalkan karakteristik SyntheticSwitch yang menyederhanakan penanganan peristiwa yang dihasilkan oleh perangkat Sakelar Matter dan memungkinkan sakelar memicu pemicu otomatisasi.
• Sifat ExtendedDoorLock memiliki perubahan yang dapat menyebabkan gangguan: jenis data kolom user_id telah diubah dari String menjadi Long. Aplikasi yang menggunakan karakteristik ini perlu dikompilasi ulang.

Perubahan penting lainnya

• Aplikasi Contoh Android menambahkan fungsi untuk mencatat status struktur, perangkat, jenis, karakteristik, dan otomatisasi agar lebih mudah di-debug.

Masalah umum yang telah diperbaiki

• Aplikasi Google Home error dengan FailedPreconditionException saat membuat otomatisasi jika lokasi rumah tidak ditetapkan di aplikasi Google Home.
• Di Aplikasi Contoh Android, perangkat dengan connectivityState PARTIALLY_ONLINE sebelumnya ditampilkan sebagai offline. Status ini sekarang direpresentasikan sebagai online.

Masalah umum

• Di Aplikasi Contoh Android, tombol Buat otomatisasi terkadang memerlukan beberapa ketukan untuk dipicu.

2025-05-12

  Rilis beta versi publik API Home 1.3  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk Home API Android SDK.

Versi minimum

• Layanan Google Play: 25.16.33
• Firmware hub Google, Cast: 3.75.468222
• Firmware hub Google, Fuchsia: 26.20250116.103.2201
• Android SDK: home.android.sdk_202504_EAP_1_3_RC00
• Aplikasi Google Home: berfungsi dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.0.0

Fitur baru

• Menambahkan dukungan untuk pemicu acara terjadwal berulang di Automation API, yang memungkinkan developer membuat otomatisasi yang berjalan secara berkala berdasarkan waktu jam, waktu matahari, dan kondisi berbasis kalender, menggunakan ekspresi cron.
• Menambahkan kemampuan untuk mengganti nama perangkat di Device API.
• Menambahkan kemampuan untuk mengganti nama ruangan di Structure API.

Masalah umum yang telah diperbaiki

• Mungkin ada peningkatan latensi kontrol perangkat saat beralih dari Wi-Fi ke jaringan seluler.
• Setelah hub direset ke setelan pabrik, perangkat mungkin akan terlihat offline.

Masalah umum

• Aplikasi Google Home error dengan FailedPreconditionException saat membuat otomatisasi jika lokasi rumah tidak ditetapkan di aplikasi Google Home. Solusi: Pastikan alamat rumah ada menggunakan Discovery API sebelum mencoba membuat otomatisasi.

2025-04-09

  Rilis beta versi publik API Home 1.2.1  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk Home API Android SDK.

Versi minimum

• Layanan Google Play: 25.09.33
• Versi minimum firmware hub Google:
  • Cast: 3.75.468222
  • Fuchsia: 24.20241009.103.1900601¹
• Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
• Aplikasi Google Home: berfungsi dengan versi apa pun
• Library androidx.core: 1.10.0
• Versi Matter: 1.4.0.0

^{1. Build ini sedang diluncurkan ke produksi dan akan tersedia untuk semua perangkat paling lambat 22 April 2025.}

Fitur baru

• Peningkatan performa saat memuat objek dari Home Graph.
• Automation API
  • Menambahkan dukungan untuk filter entity, yang memungkinkan otomatisasi memilih perangkat secara dinamis berdasarkan kriteria yang ditentukan dalam otomatisasi.
• Device API
  • Informasi perangkat cloud-to-cloud kini tersedia di BasicInformationTrait.

Masalah umum

• Mungkin ada peningkatan latensi kontrol perangkat saat beralih dari Wi-Fi ke jaringan seluler.
• Setelah hub direset ke setelan pabrik, perangkat mungkin akan terlihat offline.

Masalah umum yang telah diperbaiki

• Jika Discovery API dipanggil sebelum inisialisasi atau sebelum inisialisasi selesai, HomeException dengan code 14: UNKNOWN dan pesan "No route found." akan ditampilkan.
• Dalam lingkungan yang berisi beberapa struktur dan beberapa pengguna, beralih antara struktur dan pengguna dapat menyebabkan tidak ada perangkat yang ditampilkan.

2025-03-14

  Rilis beta versi publik API Home 1.2.0  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk Home API Android SDK.

Versi minimum

• Versi min layanan Google Play: 25.06.32
• Versi min firmware hub Google:
  • Versi Cast: 3.75.456944
  • Versi Fuchsia minimum: 24.20241009.103.1900601
• Android SDK: home.android.sdk_1_2_0_RC06
• Versi minimum Aplikasi Google Home: berfungsi dengan versi apa pun
• Versi min library androidx.core: 1.10.0
• Versi Matter: 1.3.0.0
  • Catatan: Jenis dan cluster perangkat Matter sementara tidak didukung.

Fitur baru

• Automation API:
  • Dukungan untuk rentang tanggal dan tanggal parsial dalam kondisi otomatisasi. Lihat Menggunakan tanggal dengan between.
  • Dalam rilis sebelumnya, Discovery API menampilkan NumberSetConstraint untuk beberapa kolom bitmap, padahal seharusnya menampilkan BitmapConstraint. Kolom ini sekarang menampilkan BitmapConstraint seperti yang diharapkan. Hal ini terbatas pada bitmap optionsMask dan optionsOverride dalam perintah karakteristik LevelControl.

Masalah umum

• Mungkin ada peningkatan latensi kontrol perangkat saat beralih dari Wi-Fi ke jaringan seluler.
• Setelah hub direset ke setelan pabrik, perangkat mungkin akan terlihat offline.
• Jika Discovery API dipanggil sebelum inisialisasi atau sebelum inisialisasi selesai, HomeException dengan code 14: UNKNOWN dan pesan "No route found." akan ditampilkan.
  • Solusi: Hanya panggil Discovery API saat Anda benar-benar memerlukan kandidat otomatisasi. Jangan mengambil data dan meng-cache entity kandidat terlebih dahulu. Periksa apakah entity sedang online sebelum memanggil metode Discovery API di entity tersebut.
• Dalam lingkungan yang berisi beberapa struktur dan beberapa pengguna, beralih antara struktur dan pengguna dapat menyebabkan tidak ada perangkat yang ditampilkan.

Masalah umum yang telah diperbaiki

• Saat pertama kali aplikasi API Home memanggil HomeManager.structures() setelah diluncurkan, aplikasi tersebut akan menerima nol struktur, meskipun ada satu atau beberapa struktur. Hal ini memberikan kesan yang salah bahwa tidak ada struktur yang terkait dengan Akun Google.
• Saat memuat, membuat, dan mengedit otomatisasi, pengguna mungkin mengalami waktu tunggu yang lama.
• Pengguna yang memulai alur penyiapan dari aplikasi Kamera harus memindai kode QR dua kali untuk menyelesaikan commissioning Matter.
• Dalam struktur yang berisi lebih dari 200 perangkat, Discovery API mungkin tidak menampilkan kandidat.

2025-01-29

  Rilis beta versi publik API Home 1.1.0  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk Home API Android SDK.

Versi minimum

• Versi min layanan Google Play: 25.02.32
• Versi min firmware hub Google:
  • Versi Cast: 3.75.456944
  • Versi Fuchsia min: 24.20241009.103.1900500
• Android SDK: home.android.sdk_202412_EAP_1_1_RC04
• Versi minimum Aplikasi Google Home: berfungsi dengan versi apa pun
• Versi min library androidx.core: 1.10.0
• Versi Matter: 1.3.0.0
  • Catatan: Jenis dan cluster perangkat Matter sementara tidak didukung.

Fitur baru

• Streaming API:
  • Menyediakan aliran peristiwa yang memberi tahu struktur, ruangan, dan perangkat yang telah ditambahkan, diubah, dan dihapus.
  • Lihat Berlangganan peristiwa relasi entity.
• Batching API (Eksperimental):
  • Memungkinkan developer mengirim beberapa perintah dalam batch yang dijalankan secara bersamaan.
  • Lihat Mengirim beberapa perintah sekaligus.

Masalah umum

• Saat memuat, membuat, dan mengedit otomatisasi, pengguna mungkin mengalami waktu tunggu yang lama.
• Pengguna yang memulai alur penyiapan dari aplikasi Kamera harus memindai kode QR dua kali untuk menyelesaikan commissioning Matter.
• Dalam struktur yang berisi lebih dari 200 perangkat, Discovery API mungkin tidak menampilkan kandidat.

Masalah umum yang telah diperbaiki

• Beralih Akun Google yang digunakan untuk login mungkin gagal dan menyebabkan error.
• Perangkat Google TV mungkin tidak berfungsi untuk otomatisasi yang menggunakan ciri MediaPlayback.
• Dalam struktur yang hanya berisi hub Google:
  • Perangkat Matter mungkin tampak offline di Aplikasi Google Home.
  • Asisten Google tidak dapat mengontrol perangkat Matter.
  • Layar smart tidak dapat mengontrol perangkat Matter atau menampilkan status perangkat Matter apa pun.
• Untuk beberapa perangkat, aplikasi mungkin tidak selalu mencerminkan status yang akurat, dan aplikasi Anda mungkin melaporkan status yang berbeda dari yang dilaporkan oleh aplikasi Google seperti Aplikasi Google Home. Hal ini biasanya disebabkan oleh perangkat yang tidak melaporkan status ke Google.
  • Solusi: Memeriksa status dengan aplikasi Google akan menyelesaikan ketidakcocokan.

2025-01-14

Memperbarui panduan untuk inisialisasi Home API.

Kami telah memperjelas bahwa instance Home harus diinisialisasi sebagai singleton konteks. Hal ini memastikan pengalaman pengguna yang lebih lancar di aplikasi Anda dan menghindari error dengan sesi yang tidak valid.

2025-01-07

  Rilis Beta Publik API Home  

Selama versi beta developer publik, semua developer dapat mulai membangun dan menguji aplikasi mereka.

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk Android SDK API Home, termasuk peningkatan dukungan untuk perangkat Google Nest Audio dan perangkat Google TV.

Versi minimum

• Versi min layanan Google Play: 24.45.34
• Versi min firmware hub Google:
  • Versi Cast: 3.74.444798
  • Versi Fuchsia minimum: 22.20240805.103.161
• Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
• Versi min aplikasi Google Home (GHA): berfungsi dengan versi apa pun
• Versi min library androidx.core: 1.10.0
• Versi Matter: 1.3.0.0
  • Catatan: Jenis dan cluster perangkat Matter sementara tidak didukung.

Masalah umum

• Beralih Akun Google yang digunakan untuk login mungkin gagal dan menyebabkan error.
  • Solusi: Jalankan kembali alur izin atau mulai ulang aplikasi.
• Perangkat Google TV mungkin tidak berfungsi untuk otomatisasi yang menggunakan karakteristik MediaPlayback.
• Dalam struktur yang hanya berisi hub Google:
  • Perangkat Matter mungkin tampak offline di aplikasi Google Home (GHA).
  • Asisten Google tidak dapat mengontrol perangkat Matter.
  • Layar smart tidak dapat mengontrol perangkat Matter atau menampilkan status perangkat Matter apa pun.
• Untuk beberapa perangkat, aplikasi mungkin tidak selalu mencerminkan status yang akurat, dan aplikasi Anda mungkin melaporkan status yang berbeda dari yang dilaporkan oleh aplikasi Google seperti aplikasi Google Home (GHA). Hal ini biasanya terjadi karena perangkat tidak melaporkan status ke Google.
  • Solusi: Memeriksa status dengan aplikasi Google akan menyelesaikan ketidakcocokan.

Masalah umum yang telah diperbaiki

• Commissioning mungkin gagal jika aplikasi diminimalkan selama proses berlangsung.
  • Solusi: Gunakan suppressHalfSheetNotification() API untuk menyembunyikan notifikasi halfsheet saat Commissioning API digunakan di aplikasi Anda.
• Masalah sisi server dapat mencegah pemicu OkGoogle berfungsi dalam otomatisasi.
• Saat menggunakan hub yang menjalankan Fuchsia yang tidak memiliki perangkat Matter dalam struktur, jika hub dibiarkan tidak ada aktivitas selama lebih dari 3 jam, commissioning perangkat Matter pertama akan menyebabkan perangkat Matter offline.
• Setelah reset ke setelan pabrik dilakukan untuk hub, perintah ke perangkat yang baru diaktifkan mungkin gagal meskipun perangkat dilaporkan sebagai online.