Catatan rilis Android SDK Home API

2025-10-23

  Rilis Beta Publik Home API 1.5.1  

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

Versi minimum

• Layanan Google Play: 25.41.30
• Versi minimum firmware hub Google:
  • Pemeran: 3.76.495998
  • Fuchsia: 27.20250422.103.3600
• SDK Android: home.android.sdk_1_5_1
• Aplikasi Google Home: kompatibel dengan versi apa pun
• Pustaka androidx.core: berfungsi dengan versi apa pun
• Matter version: 1.4.1.0

Fitur baru

• Struktur API
  • API aktivasi hub memungkinkan Anda menemukan dan mengaktifkan hub Google Home secara terprogram. Lihat Hub activation API on Android.
    
• Contoh Aplikasi Android
  • Dukungan Jenis Perangkat Bel Pintu untuk:
    • OnOff
    • Livestream
    • Pembicaraan dua arah
  • Hub Activation API: Mengaktifkan Hub

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

Fitur baru

• API Otomatisasi
  • Pemula, kondisi, dan tindakan sekarang menerima struct Matter sebagai parameter.
• Device API
  • Jenis perangkat kamera telah ditambahkan. Fitur Kamera berikut juga tersedia untuk jenis perangkat Bel Pintu:
  • Live streaming kamera.
  • Pembicaraan dua arah kamera.
  • Kamera memulai dan menghentikan perekaman.
• Aplikasi Contoh Android
  • Dukungan untuk jenis perangkat Kamera:
    • Live streaming kamera.
    • Pembicaraan dua arah kamera.
    • Kamera memulai dan menghentikan perekaman.
    • Izin jenis perangkat terbatas.
  • Penyiapan multi-admin (berbagi perangkat yang disiapkan).
  • Otomatisasi OnOff yang telah ditentukan sebelumnya.

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.

Masalah umum yang telah diperbaiki

• 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.
• Setelah pengguna memilih warna dari prasetel atau dari pemilih suhu warna, Lampu Warna yang Diperluas gagal memperbarui warna.

2025-09-08

Aplikasi Contoh untuk Android versi 1.4.1 telah dirilis.

Fitur baru

• Membuat, Mengganti Nama, Memperbarui, dan Menghapus ruang.
• Pemesanan ke pabrik 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 Android SDK API Home.

Versi minimum

• Layanan Google Play: 25.33.32
• Versi minimum firmware hub Google:
  • Pemeran: 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 Android SDK 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 Membatasi jumlah eksekusi.

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

Masalah umum

• Setelah keluar dari telepon dan masuk kembali, aplikasi Home API tidak dapat mengontrol perangkat.
  • Penanganan: Tutup atau matikan aplikasi di latar belakang, lalu tunggu setidaknya 10 detik sebelum mencoba lagi.

Masalah umum yang telah diperbaiki

• Perangkat vakum yang telah didok tidak mendaftarkan status Terdok.

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 Google Hub:
  • 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: berfungsi 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 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 diperbarui 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 API Beranda 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: berfungsi dengan versi apa pun
• Pustaka androidx.core: berfungsi dengan versi apa pun
• Versi Matter: 1.4.0.0

Fitur baru

Sifat

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

  Aplikasi yang menggunakan sifat ini perlu dikompilasi ulang.

Aplikasi Contoh Android

Menambahkan fungsi untuk mencatat status struktur, perangkat, jenis, sifat, dan otomatisasi agar lebih mudah di-debug.

Masalah umum

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

Masalah Umum yang telah diperbaiki

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

2025-05-12

  Rilis Beta Publik Home API 1.3  

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

Versi minimum

• Layanan Google Play: 25.16.33
• Versi minimum firmware Google Hub:
  • 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
• Pustaka androidx.core: berfungsi 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 SDK Android 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
• Pustaka 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 "Tidak ada rute yang ditemukan." akan ditampilkan.
• Dalam lingkungan yang berisi beberapa struktur dan beberapa pengguna, peralihan antara struktur dan pengguna dapat mengakibatkan tidak ada perangkat yang dikembalikan.

2025-03-14

  Rilis Beta Publik API Beranda 1.2.0  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas beta untuk SDK Android 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
• SDK Android: 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 materi: 1.3.0.0
  • Catatan: Jenis dan cluster perangkat Provisional Matter tidak didukung.

Fitur baru

• API Otomatisasi:
  • 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 trait 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 "Tidak ada rute yang ditemukan." 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 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 SDK Android 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 API Rumah.

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 Android SDK Home API, 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 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 karena perangkat 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, melakukan aktivasi perangkat Matter pertama akan menyebabkan perangkat Matter offline.
• Setelah pengaturan ulang data pabrik dilakukan untuk hub, perintah ke perangkat yang baru ditugaskan mungkin gagal meskipun perangkat dilaporkan online.