Catatan rilis Android SDK Home API

2025-09-08

Aplikasi Contoh untuk Android versi 1.4.1 telah dirilis.

Fitur baru

• Membuat, Mengganti Nama, Memperbarui, dan Menghapus ruang.
• Melakukan commissioning ke fabric Matter pihak ketiga.

Masalah Umum yang telah diperbaiki

• Link halaman pencabutan izin kini berfungsi.

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
• Versi minimum firmware hub Google:
  • Cast: 3.76.495998
  • Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_4_1
• Aplikasi Google Home: kompatibel dengan versi apa pun
• androidx.core library: kompatibel dengan versi apa pun
• Versi Matter: 1.4.0.0

Fitur baru

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

Masalah umum

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

Masalah umum yang telah diperbaiki

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

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
• Versi minimum firmware hub Google:
  • Cast: 3.76.486931
  • Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_4_0
• Aplikasi Google Home: kompatibel dengan versi apa pun
• androidx.core library: kompatibel dengan versi apa pun
• Versi Matter: 1.4.0.0

Fitur baru

• Automation API
  • Otomatisasi dapat dibatasi untuk dijalankan hingga beberapa kali. Lihat Batasi jumlah eksekusi.

• Device API
  • Kemampuan untuk menghapus perangkat Matter secara terprogram. Lihat Menghapus perangkat.
  • Anggota HomeDevice yang tidak digunakan lagi berikut telah dihapus:
    1. HomeDevice.trait(). Lihat Mengakses perangkat dan metadata perangkat untuk Android.
    2. HomeDevice.isInRoom. Sebagai gantinya, gunakan HomeDevice.roomId.
    3. HomeDevice.isInStructure. Sebagai gantinya, gunakan HomeDevice.structureId.
• Structure API
  • Home.hasPermissions() kini menggabungkan status otorisasi OAuth untuk pengguna (akses ke struktur) serta pemberian izin aplikasi.
• Aplikasi Contoh Android
  • Panggilan API yang tidak digunakan lagi telah diganti.
  • Mengganti nama perangkat.
  • Menghapus perangkat khusus Matter.

Masalah umum

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

Masalah umum yang telah diperbaiki

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

2025-07-08

Dengan versi firmware Cast 3.76.479819, Nest WiFi Pro kini dapat berfungsi sebagai hub API Home.

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
• Versi minimum firmware hub Google:
  • Transmisikan:
    • Google Home, Google Home Mini, dan Google Nest Mini: 3.75.468362
    • Google Nest Audio: 3.75.476451
  • Fuchsia: 26.20250116.103.2900
• Android SDK: home.android.sdk_1_3_2
• Aplikasi Google Home: kompatibel dengan versi apa pun
• androidx.core library: kompatibel 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)
  • Ciri-ciri SDK dan jenis perangkat (play-services-home-types-17.0.0.aar)

  Mulai dari rilis ini, developer harus menyertakan kedua artefak di jalur library waktu kompilasi dan runtime project mereka.

Aplikasi Contoh Android

• Pengguna dapat membatalkan hubungan dan mencabut izin dari aplikasi.
• 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
• Versi minimum firmware hub Google:
  • Cast: 3.75.468222
  • Fuchsia: 26.20250116.103.2201
• Android SDK: home.android.sdk_202505_EAP_1_3_1_RC06
• Aplikasi Google Home: kompatibel dengan versi apa pun
• androidx.core library: kompatibel dengan versi apa pun
• Versi Matter: 1.4.0.0

Fitur baru

Sifat

• Memperkenalkan SyntheticSwitch trait yang menyederhanakan penanganan peristiwa yang dihasilkan oleh perangkat Sakelar Matter dan memungkinkan sakelar memicu pemicu otomatisasi.
• Sifat ExtendedDoorLock memiliki perubahan yang menyebabkan gangguan: jenis data kolom user_id telah diubah dari String menjadi Long. Lihat
  • ExtendedDoorLockTrait.LockStateChange.user_id
  • ExtendedDoorLockTrait.PrivacyModeActor.user_id

  Aplikasi yang menggunakan karakteristik ini perlu dikompilasi ulang.

Aplikasi Contoh Android

Menambahkan fungsi untuk mencatat status struktur, perangkat, jenis, sifat, dan otomatisasi untuk mempermudah proses debug.

Masalah umum

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

Masalah Umum yang telah diperbaiki

• Aplikasi Google Home error dengan FailedPreconditionException saat membuat otomatisasi jika lokasi rumah tidak disetel di aplikasi Google Home (GHA) (Lihat Mengubah alamat rumah Google untuk mengetahui cara menyetel lokasi rumah).
• Di Aplikasi Contoh Android, perangkat dengan connectivityState PARTIALLY_ONLINE sebelumnya ditampilkan kepada pengguna sebagai offline. Status ini kini ditampilkan sebagai online.

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
• Versi minimum firmware hub Google:
  • Cast: 3.75.468222
  • Fuchsia: 26.20250116.103.2201
• Android SDK: home.android.sdk_202504_EAP_1_3_RC00
• Aplikasi Google Home: kompatibel dengan versi apa pun
• androidx.core library: kompatibel dengan versi apa pun
• Versi Matter: 1.4.0.0

Fitur baru

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

Masalah umum

Aplikasi Google Home error dengan FailedPreconditionException saat membuat otomatisasi jika lokasi rumah tidak disetel di aplikasi Google Home (GHA) (Lihat Mengubah alamat rumah Google untuk mengetahui cara melakukannya).

• Solusi: Periksa apakah alamat rumah ada menggunakan Discovery API sebelum mencoba membuat otomatisasi.

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.

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 versi minimum library: 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 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 versi minimum library: 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 minimum aplikasi Google Home (GHA): berfungsi dengan versi apa pun
• androidx.core versi minimum library: 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, penyiapan perangkat Matter pertama akan menyebabkan perangkat Matter offline.
• Setelah hub direset ke setelan pabrik, perintah ke perangkat yang baru diaktifkan mungkin gagal meskipun perangkat dilaporkan sedang online.