Catatan rilis Android SDK Home API

2025-03-14

  Rilis Beta Publik Home API 1.2.0  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas ketersediaan umum (GA) untuk Home APIs Android SDK.

Versi minimum

• Versi minimum Layanan Google Play: 25.06.32
• Versi min firmware hub Google:
  • Versi transmisi: 3.75.456944
  • Versi minimum Fuchsia: 24.20241009.103.1900601
• Android SDK: home.android.sdk_202412_EAP_1_2_RC01
• Versi minimum Aplikasi Google Home: berfungsi dengan versi apa pun
• Versi minimum 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 sebagian dalam kondisi otomatisasi. Lihat Menggunakan tanggal dengan antara.
  • Dalam 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 optionsMask dan bitmap optionsOverride dalam LevelControl perintah sifat.

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 jika Anda benar-benar memerlukan kandidat otomatisasi. Jangan melakukan pra-pengambilan dan menyimpan entity kandidat ke dalam cache. Periksa untuk melihat apakah entity sedang online sebelum memanggil metode Discovery API di dalamnya.
• 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 Home API memanggil HomeManager.structures() setelah diluncurkan, aplikasi tersebut tidak menerima struktur apa pun, 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 telah 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 Home API Public Beta 1.1.0  

Rilis ini berisi perbaikan bug dan meningkatkan kualitas ketersediaan umum (GA) untuk Home APIs Android SDK.

Versi minimum

• Versi minimum Layanan Google Play: 25.02.32
• Versi min firmware hub Google:
  • Versi transmisi: 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: berfungsi dengan versi apa pun
• Versi minimum 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:
  • Memberikan aliran peristiwa yang memberi tahu struktur, ruangan, dan perangkat yang telah ditambahkan, diubah, dan dihapus.
  • Lihat Berlangganan peristiwa hubungan 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 telah 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 login mungkin gagal dan menyebabkan error.
• Perangkat Google TV mungkin tidak berfungsi untuk otomatisasi yang menggunakan 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 dengan yang dilaporkan oleh aplikasi Google seperti Aplikasi Google Home. Hal ini biasanya karena perangkat 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 Rumah 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 versi beta developer publik, semua developer dapat mulai mem-build dan menguji aplikasi mereka.

Rilis ini berisi perbaikan bug dan meningkatkan kualitas ketersediaan umum (GA) untuk Home API Android SDK, termasuk dukungan yang ditingkatkan untuk perangkat Google Nest Audio dan Google TV.

Versi minimum

• Versi minimum layanan Google Play: 24.45.34
• Versi min firmware hub Google:
  • Versi transmisi: 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
• Versi minimum 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 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 sifat 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.
• 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 karena perangkat tidak melaporkan status ke Google.
  • Solusi: Memeriksa status dengan aplikasi Google akan menyelesaikan ketidakcocokan.

Masalah umum yang telah diperbaiki

• Komisi dapat gagal jika aplikasi diperkecil selama proses.
  • 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, mengaktifkan perangkat Matter pertama akan membuat perangkat Matter offline.
• Setelah reset data pabrik dilakukan untuk hub, perintah ke perangkat yang baru diaktifkan mungkin gagal meskipun perangkat dilaporkan sebagai online.