Untuk membantu Anda membuat aplikasi Android yang berinteraksi dengan perangkat Matter, Google telah mengembangkan Google Home Mobile SDK. Mobile SDK mencakup dua API inti yang memungkinkan aplikasi Anda untuk membuat komisi dan berbagi perangkat dengan kain Google.
Setelah perangkat ditambahkan ke Google Fabric, pengguna dapat mengontrol perangkatnya melalui Google Home app (GHA), kontrol daya Android, suara, dan perangkat layar sentuh Nest.
Mobile SDK juga memungkinkan Anda menentukan layanan komisi khusus yang dapat digunakan untuk menetapkan perangkat ke ekosistem Matter tambahan.
Mengintegrasikan Mobile SDK ke dalam aplikasi Android Anda
Untuk memulai, selesaikan langkah-langkah berikut:
Ikuti petunjuk yang diberikan di bagian Menyiapkan Google Play services.
Tambahkan dependensi Play services ke file
build.gradle
Anda:implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'
Memastikan pengiriman modul
Modul Play services home
bersifat opsional, sehingga
fungsi Matter hanya akan ada di perangkat
pengguna jika aplikasi di perangkat menentukan dependensi
modul Play services yang sesuai dalam file AndroidManifest.xml
-nya.
GHA dan Google Home Sample App for Matter menyertakan dependensi modul
ini dalam manifesnya. Jika Anda mengintegrasikan
Mobile SDK ke dalam aplikasi Android, untuk memastikan
dukungan Matter bagi pengguna aplikasi Anda, tambahkan
blok service
berikut ke deklarasi application
dalam
file AndroidManifest.xml
Anda:
<service android:name="com.google.android.gms.metadata.ModuleDependencies"
android:enabled="false"
android:exported="false">
<intent-filter>
<action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>
<meta-data android:name="home:0:preferred" android:value=""/>
</service>
Ini hanya didukung untuk perangkat Android yang menjalankan Play services 22.50.14 atau yang lebih baru.
Lihat manifes Sample App for Matter untuk mengetahui contoh implementasinya.
Memanggil aplikasi Android lain
Jika menggunakan Android 11 atau yang lebih tinggi, Anda harus menyertakan
blok queries
berikut di AndroidManifest.xml
sehingga aplikasi Anda dapat melakukan panggilan ke
aplikasi lain.
<queries>
<!-- For GMS Core/Play service -->
<package android:name="com.google.android.gms" />
<package android:name="com.android.vending" />
<!-- End of GMS Core/Play service-->
</queries>
Untuk mengetahui informasi selengkapnya, lihat artikel Pemfilteran visibilitas paket di Android.
Menggunakan Aplikasi Contoh Google Home untuk Matter
Untuk mempelajari cara kerja Mobile SDK dari aplikasi Android, coba Sample App for Matter kami.
Buat aplikasi Anda sendiri
Untuk membantu Anda memulai dengan cepat, kami telah membuat kode open source Sample App for Matter dan menyediakan codelab pendamping, yang memungkinkan Anda menyesuaikan kode contoh untuk project Android Anda sendiri.
Buka codelab Sample App for Matter
Resource
Untuk mempelajari Mobile SDK lebih lanjut, baca Referensi API.
Untuk mempelajari cara SDK ini menangani data pengguna akhir, lihat Bagian Keamanan Data Google Play Mobile Home SDK