Home Mobile SDK untuk Android

Untuk membantu Anda membangun aplikasi Android yang berinteraksi dengan Matter, Google telah mengembangkan Google Home Mobile SDK. Tujuan Mobile SDK menyertakan dua API inti yang memungkinkan aplikasi Anda untuk komisi dan berbagi perangkat dengan produk Google.

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

Mobile SDK juga memungkinkan Anda menentukan layanan commissioning kustom yang dapat Anda gunakan untuk melakukan commissioning perangkat ke Matter tambahan ekosistem.

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 Fungsi Matter hanya akan ada di jika aplikasi pada perangkat menetapkan Dependensi modul Play services dalam file AndroidManifest.xml-nya.

GHA dan Google Home Sample App for Matter menyertakan ini dependensi modul dalam manifesnya. Jika Anda mengintegrasikan Mobile SDK ke aplikasi Android Anda, untuk memastikan Matter untuk pengguna aplikasi Anda, tambahkan blok service berikut pada deklarasi application dalam File AndroidManifest.xml:

<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>

Hanya didukung untuk Android perangkat yang menjalankan Play services 22.50.14 atau yang lebih tinggi.

Lihat Sample App for Matter manifes untuk contoh implementasi.

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

Memanggil aplikasi Android lain

Jika menggunakan Android 11 atau yang lebih baru, Anda harus menyertakan hal berikut Blok queries 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 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 kita.

Coba Sample App for Matter

Membuat aplikasi Anda sendiri

Untuk membantu Anda memulai dengan cepat, kami telah membuat Sample App for Matter dan menyediakan codelab pendamping, yang memungkinkan Anda untuk menyesuaikan kode contoh kami untuk project Android Anda.

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 SDK Seluler