Model data di Android

Home API untuk Android menampilkan semua perangkat di ekosistem Google Home dalam model data terpadu. Model data ini mencakup semua jenis perangkat (dari Google Nest atau produsen pihak ketiga), terlepas dari teknologi smart home yang mendasarinya (seperti Matter atau Cloud-to-cloud), dan menyediakan platform API umum untuk membangun pengalaman pengguna bagi developer aplikasi seluler dan smart home.

Jenis perangkat

Jenis perangkat yang ditampilkan di Home API adalah penyatuan model data Matter dan Cloud-to-cloud. Beberapa jenis perangkat berasal langsung dari Matter, beberapa merupakan ekstensi dari jenis perangkat Matter, dan beberapa berasal dari Cloud-to-cloud.

Jenis perangkat berisi karakteristik yang digunakan untuk mengontrol dan mengelola perangkat. Seperti jenis perangkat, karakteristik berasal dari cluster Matter dan karakteristik Cloud-to-cloud dan ditampilkan dalam format umum yang mirip dengan cluster Matter. Di Home API, trait turunan Matter disebut trait, bukan cluster.

Oleh karena itu, jenis dan karakteristik perangkat di Home API dimaksudkan untuk Matter-first. Jenis atau ciri perangkat Matter lebih diutamakan daripada analog Cloud-to-cloud.

Lihat Jenis perangkat yang didukung di Android untuk mengetahui daftar jenis perangkat dan karakteristiknya.

Sifat

Versi Kotlin dari karakteristik dibuat untuk digunakan di Home API, dan berisi fitur tambahan khusus untuk Home API (tidak ditemukan di Matter atau Cloud-to-cloud). Misalnya, setiap karakteristik memiliki metode untuk memeriksa apakah karakteristik mendukung atribut atau perintah tertentu. Hal ini berguna saat menentukan apakah pembacaan status atau tindakan tertentu dapat dilakukan di perangkat pengguna, karena tidak semua perangkat dalam jenis perangkat diharapkan memiliki semua fitur yang sama.

Setiap karakteristik terdapat dalam namespace-nya sendiri dan harus diimpor satu per satu untuk digunakan.

Misalnya, untuk menggunakan karakteristik On/Off Matter dan jenis perangkat Unit Plug-in On/Off, impor paket berikut ke dalam aplikasi Anda:

import com.google.home.matter.standard.OnOff
import com.google.home.matter.standard.OnOffPluginUnitDevice

Untuk jenis perangkat Garasi (dari smart home Google), sertakan kombinasi ciri Matter dan Google:

import com.google.home.google.LockUnlock
import com.google.home.matter.standard.DoorLock
import com.google.home.matter.standard.GoogleGarageDevice

Android Studio memiliki fungsi pelengkapan otomatis dan sering kali akan menangani nama paket lengkap untuk Anda saat menambahkan baris import ke file sumber dalam project Anda. Namun, nama paket tidak konsisten di semua jenis dan ciri perangkat. Lihat referensi untuk memverifikasi nama paket yang benar untuk setiap DeviceType atau Trait.

Sebagian besar karakteristik didukung untuk digunakan dengan Otomatisasi, dan beberapa karakteristik hanya tersedia untuk Otomatisasi. Untuk mengetahui detail selengkapnya, lihat Dukungan karakteristik Automation API di Android.

Komposisi jenis perangkat

Home API mendukung sebagian besar cluster aplikasi Matter sebagai karakteristik dalam model data. Cluster konfigurasi tingkat rendah yang tidak menawarkan utilitas langsung untuk pengguna akhir, seperti Binding, tidak diekspos melalui Home API.

Karakteristik yang berasal dari karakteristik smart home Cloud-to-cloud biasanya memiliki nama yang sama antara Cloud-to-cloud dan Home API, seperti dalam contoh OpenClose. Yang lain direpresentasikan sebagai ekstensi ciri Matter, yang dibuat menggunakan ekstensi khusus produsen Matter. Sifat ini menjembatani kesenjangan untuk sifat smart home yang fungsinya dibagi antara SDK Matter dan ekosistem Google Home. Contoh spesifiknya adalah jenis perangkat Google* yang berasal dari Cloud-to-cloud, tetapi belum memiliki analog Matter.

Jenis perangkat terdiri dari karakteristik dari salah satu atau kedua sumber, Matter atau Cloud-to-cloud.

Misalnya, Jenis perangkat Kipas terdiri dari keduanya dan memiliki tiga karakteristik:

  • Trait Identify Matter menyediakan semua fungsi dari Matter Identify.
  • Trait Matter FanControl menyediakan semua fungsi dari trait Matter FanControl
  • Karakteristik Google ExtendedFanControl menyediakan semua fungsi dari karakteristik smart home FanSpeed Google yang tidak tercakup dalam karakteristik FanControl Matter

Jenis komposisi karakteristik ini memberikan model yang fleksibel untuk fungsionalitas jenis perangkat yang lengkap, yang mengabstraksi model data smart home yang mendasarinya.

Grup perangkat

Grup perangkat mewakili kumpulan perangkat yang ditentukan pengguna dalam satu struktur. Grup perangkat direpresentasikan oleh entitas DeviceGroup, yang berbeda dengan HomeDevice.

Lihat API Struktur untuk mengetahui informasi selengkapnya tentang Grup Perangkat.