Catatan rilis Android SDK Home API

2026-05-01

  Rilis Beta Publik Home API 1.8.1  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk Android SDK 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
• Matter version: 1.4.1.0
• Matter version: experimental support for 1.5.0

Fitur baru

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

Masalah umum yang telah diperbaiki

• Melakukan commissioning perangkat Matter mungkin gagal.
• Lampu Philips BLE 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 multipart 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 Publik Home API 1.8  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk Android SDK 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: kompatibel dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Matter version: 1.4.1.0
• Matter version: experimental support for 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 unit suhu (C/F) Google Nest Learning Thermostat (generasi ke-4).
• Di Google Home versi seluler untuk web, ikon atas dan tombol kembali terhalang oleh header. Pengguna mungkin tidak dapat kembali atau melihat elemen antarmuka pengguna utama.
• Hub Android TV dapat secara keliru melaporkan perangkat Matter sebagai "Offline".

Masalah umum

• Melakukan commissioning perangkat Matter mungkin gagal.

2026-03-13

  Rilis Beta Publik Home API 1.7.1  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk Android SDK 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
• Matter version: 1.4.1.0
• Matter version: experimental support for 1.5.0

Fitur baru

• Persetujuan 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 atom 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 "Waktu Baterai Tersisa" tidak ada di Setelan Baterai.
• Setelan durasi bunyi bel diabaikan.
• Lampu Philips BLE salah ditampilkan sebagai "Online" meskipun perangkat sebenarnya offline.

Masalah umum

• Tidak dapat mengubah unit suhu (C/F) Google Nest Learning Thermostat (generasi ke-4).
• Kemungkinan ada keterlambatan dalam stabilitas jaringan dan responsivitas perangkat.
• Di Google Home untuk Web versi seluler, ikon atas dan tombol kembali terhalang oleh header. Pengguna mungkin tidak dapat kembali atau melihat elemen antarmuka pengguna utama.
• Hub mungkin macet dalam status "Menghubungkan..." setelah OOBE mode Gabungan.
• Melakukan commissioning perangkat Matter mungkin gagal.
• Hub Android TV dapat 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.
• Saat Durasi Bunyi Dering disetel, perangkat tidak berbunyi dering 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 Publik Home API 1.7  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk Android SDK 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
• Matter version: 1.4.1.0
• Matter version: experimental support for 1.5.0

Fitur baru

• Otomatisasi Lokal: berdasarkan kondisi seperti konektivitas, jenis perangkat, dan sifat, beberapa otomatisasi kini dapat dieksekusi secara lokal di Automations API.
• Pengaktifan Pengalaman Langsung Pakai (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.
• Tingkat 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 mana yang telah diberi akses oleh pengguna di Permissions API.

Perubahan penting lainnya

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

Masalah umum yang telah diperbaiki

• History API selalu menampilkan nextPageToken, sehingga menyebabkan loop tak terbatas.
• 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 "Waktu Baterai Tersisa" tidak ada di Setelan Baterai.
• Setelan durasi bunyi bel diabaikan.
• Lampu Philips BLE salah ditampilkan 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

  Rilis Beta Publik Home API 1.6  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk Android SDK 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
• Matter version: 1.4.1.0

Fitur baru

• Dukungan fitur Cuaca API Otomatisasi. Menambahkan dukungan untuk trait Cuaca di pemicu dan kondisi otomatisasi.
• Dukungan untuk kemampuan perangkat Kamera dan Bel Pintu lainnya: Setelan baru (Penglihatan malam, LED status, Area tampilan, 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 yang telah ditentukan, dukungan Kipas dan Speaker.

Masalah umum

• Kontrol perangkat berhenti berfungsi setelah digunakan dalam jangka waktu yang 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 onn Walmart yang dioperasikan menggunakan Android Home API SDK tidak dapat melakukan live streaming melalui Aplikasi Google Home.
• Kamera yang diaktifkan di aplikasi Home API tidak dapat memulai sesi live stream dari Aplikasi Google Home.

2025-10-23

  Rilis Beta Publik Home API 1.5.1  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk Android SDK 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: kompatibel dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Matter version: 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 Doorbell (OnOff, Livestream, Two-way talk) dan implementasi Hub Activation API.

Masalah umum yang telah diperbaiki

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

2025-09-26

  Rilis Beta Publik Home API 1.5.0  

Rilis ini memperkenalkan dukungan untuk perangkat Kamera, berisi perbaikan bug, dan meningkatkan kualitas beta untuk Android SDK 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: kompatibel dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Matter version: 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, Bicara dua arah, Mulai/berhenti merekam).

Perubahan penting lainnya

• Aplikasi Contoh Android menambahkan Dukungan untuk Kamera, Penyiapan multi-admin, Otomatisasi OnOff yang telah ditentukan sebelumnya.

Masalah umum yang telah diperbaiki

• Jika hub yang sedang aktif dihapus secara paksa, ada jangka waktu 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, Extended Color Light 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

  Rilis Beta Publik Home API 1.4.1  

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

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: kompatibel dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Matter version: 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 mengalami error saat pengguna mencoba menyetel termostat ke mode yang tidak didukungnya.

Masalah umum

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

2025-07-31

  Rilis Beta Publik Home API 1.4.0  

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

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: kompatibel dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Matter version: 1.4.0.0

Fitur baru

• Otomatisasi dapat dibatasi untuk dieksekusi hingga jumlah yang terbatas di 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 Dipasang 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

  Rilis Beta Publik Home API 1.3.2  

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

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: kompatibel dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Matter version: 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) dan jenis perangkat serta karakteristik SDK (play-services-home-types-17.0.0.aar). Mulai dari 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 membatalkan hubungan dan mencabut izin dari aplikasi.
• Aplikasi Contoh Android menambahkan: 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 Dipasang ke dok.

2025-06-05

  Rilis Beta Publik Home API 1.3.1  

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

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: kompatibel dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Matter version: 1.4.0.0

Fitur baru

• Memperkenalkan trait SyntheticSwitch yang menyederhanakan penanganan peristiwa yang dihasilkan oleh perangkat Sakelar Matter dan memungkinkan sakelar memicu pemicu otomatisasi.
• Trait ExtendedDoorLock memiliki perubahan yang menyebabkan error: 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, sifat, dan otomatisasi untuk mempermudah proses debug.

Masalah umum yang telah diperbaiki

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

Masalah umum

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

2025-05-12

  Rilis Beta Publik Home API 1.3  

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

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: kompatibel dengan versi apa pun
• Library androidx.core: berfungsi dengan versi apa pun
• Matter version: 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 tampak offline.

Masalah umum

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

2025-04-09

  Rilis Beta Publik Home API 1.2.1  

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

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: kompatibel dengan versi apa pun
• Library androidx.core: 1.10.0
• Versi Matter: 1.4.0.0

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

Fitur baru

• Peningkatan performa saat memuat objek dari grafik rumah.
• Automation API
  • Menambahkan dukungan untuk filter entitas, yang memungkinkan otomatisasi memilih perangkat secara dinamis berdasarkan kriteria yang ditentukan dalam otomatisasi.
• Device API
  • Informasi perangkat cloud-ke-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 tampak 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 di antara struktur dan pengguna dapat menyebabkan tidak ada perangkat yang ditampilkan.

2025-03-14

  Rilis Beta Publik Home API 1.2.0  

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

Versi minimum

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

Fitur baru

• Automation API:
  • Dukungan untuk rentang tanggal dan tanggal parsial dalam kondisi otomatisasi. Lihat Menggunakan tanggal dengan between.
  • Pada rilis sebelumnya, Discovery API menampilkan NumberSetConstraint untuk beberapa kolom bitmap, padahal seharusnya menampilkan BitmapConstraint. Kolom ini kini 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 tampak 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 melakukan pra-pemanggilan dan menyimpan entity kandidat ke dalam cache. Periksa untuk melihat apakah suatu entitas sedang online sebelum memanggil metode Discovery API di entitas tersebut.
• Dalam lingkungan yang berisi beberapa struktur dan beberapa pengguna, beralih di antara struktur dan pengguna dapat menyebabkan tidak ada perangkat yang ditampilkan.

Masalah umum yang telah diperbaiki

• Saat pertama kali aplikasi Home API memanggil HomeManager.structures() setelah diluncurkan, aplikasi tersebut menerima nol struktur, bahkan saat 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 Publik Home API 1.1.0  

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

Versi minimum

• Versi minimum layanan Google Play: 25.02.32
• Versi minimum firmware hub Google:
  • Versi Cast: 3.75.456944
  • Versi minimum Fuchsia: 24.20241009.103.1900500
• Android SDK: home.android.sdk_202412_EAP_1_1_RC04
• Versi minimum Aplikasi Google Home: kompatibel dengan versi apa pun
• androidx.core library min version: 1.10.0
• Versi Matter: 1.3.0.0
  • Catatan: Jenis dan cluster perangkat Provisional Matter 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 entitas.
• Batching API (Eksperimental):
  • Memungkinkan developer mengirim beberapa perintah dalam batch yang dieksekusi 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

• Mengganti Akun Google yang login dapat gagal dan menyebabkan error.
• Perangkat Google TV mungkin tidak berfungsi untuk otomatisasi yang menggunakan MediaPlayback trait.
• 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 dengan 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 Home API  

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

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

Versi minimum

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

Masalah umum

• Mengganti Akun Google yang login dapat gagal dan menyebabkan error.
  • Solusi: Jalankan kembali alur izin atau mulai ulang aplikasi.
• Perangkat Google TV mungkin tidak berfungsi untuk otomatisasi yang menggunakan MediaPlayback trait.
• 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 dengan yang dilaporkan oleh aplikasi Google seperti aplikasi Google Home (GHA). Hal ini biasanya disebabkan oleh perangkat yang tidak melaporkan status ke Google.
  • Solusi: Memeriksa status dengan aplikasi Google akan menyelesaikan ketidakcocokan.

Masalah umum yang telah diperbaiki

• Proses aktivasi mungkin gagal jika aplikasi diminimalkan selama proses.
  • Solusi: Gunakan suppressHalfSheetNotification() API untuk menekan notifikasi setengah layar 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 aktif selama lebih dari 3 jam, proses aktivasi perangkat Matter pertama akan menyebabkan perangkat Matter menjadi offline.
• Setelah hub direset ke setelan pabrik, perintah ke perangkat yang baru di-deploy mungkin gagal meskipun perangkat dilaporkan sedang online.