Home Mobile SDK untuk Android

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 menggunakan dan membagikan perangkat dengan platform Google.

Setelah perangkat ditambahkan ke platform Google, pengguna Anda dapat mengontrol perangkat mereka melalui Google Home app (GHA), kontrol daya Android, suara, dan perangkat layar sentuh Nest.

Mobile SDK juga memungkinkan Anda menentukan layanan aktivasi kustom yang dapat digunakan untuk mengaktifkan perangkat ke ekosistem Matter tambahan.

Mengintegrasikan Mobile SDK ke dalam aplikasi Android Anda

Untuk memulai, selesaikan langkah-langkah berikut:

  1. Ikuti petunjuk yang diberikan di Siapkan Google Play services.

  2. 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 fungsionalitas Matter hanya akan ada di perangkat pengguna jika aplikasi di perangkat tersebut menentukan dependensi modul Play services yang sesuai dalam file AndroidManifest.xml-nya.

GHA dan Google Home Sample App for Matter keduanya 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>

Fitur ini hanya didukung untuk perangkat Android yang menjalankan Play services 22.50.14 atau yang lebih tinggi.

Lihat manifest Sample App for Matter untuk contoh penerapan.

Anda dapat memeriksa ketersediaan modul Home saat runtime menggunakan ModuleInstallClient. Lihat halaman Memastikan ketersediaan API dengan ModuleInstallClient untuk mengetahui informasi selengkapnya.

Memanggil aplikasi Android lain

Jika Anda menggunakan Android 11 atau yang lebih tinggi, Anda harus menyertakan blok queries berikut dalam AndroidManifest.xml agar 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.

Coba Sample App for Matter

Membuat aplikasi Anda sendiri

Untuk membantu Anda memulai dengan cepat, kami telah menyediakan kode open source untuk Sample App for Matter dan menyediakan codelab pendamping, sehingga Anda dapat menyesuaikan kode contoh kami untuk project Android Anda sendiri.

Buka codelab Sample App for Matter

Resource

Untuk mempelajari Mobile SDK lebih lanjut, lihat Referensi API.

Untuk mempelajari cara SDK ini menangani data pengguna akhir, lihat Bagian Keamanan Data Google Play Home Mobile SDK