Android için Home Mobile SDK'sı

Google, Matter cihazlarla etkileşim kuran Android uygulamaları geliştirmenize yardımcı olmak için Google Home Mobile SDK geliştirdi. Mobile SDK, uygulamalarınızın cihazları Google yapısıyla devreye almasına ve paylaşmasına olanak tanıyan iki temel API içerir.

Cihaz Google yapısına eklendikten sonra kullanıcılarınız cihazlarını Google Home app (GHA), Android güç kontrolleri, ses ve Nest dokunmatik ekranlı cihazlar üzerinden kontrol edebilir.

Mobile SDK, cihazları ek Matter ekosistemlerinde devreye almak için kullanabileceğiniz özel bir devreye alma hizmeti tanımlamanıza da olanak tanır.

Mobile SDK'yı Android uygulamanıza entegre etme

Başlamak için aşağıdaki adımları uygulayın:

  1. Google Play services uygulamasını ayarlama başlıklı makaledeki talimatları uygulayın.

  2. Play services bağımlılığını build.gradle dosyanıza ekleyin:

    implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'

Modül yayınını sağlama

Play services home modülü isteğe bağlıdır. Bu nedenle, Matter işlevi yalnızca cihazdaki bir uygulama, AndroidManifest.xml dosyasında uygun Play services modül bağımlılığını belirtiyorsa kullanıcının cihazında bulunur.

GHA ve Google Home Sample App for Matter, manifest dosyalarında bu modül bağımlılığını içerir. Mobile SDK'i Android uygulamanıza entegre ediyorsanız uygulamanızın kullanıcıları için Matter desteği sağlamak amacıyla AndroidManifest.xml dosyanızdaki application beyanına aşağıdaki service bloğunu ekleyin:

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

Bu özellik yalnızca Play services 22.50.14 veya sonraki sürümleri çalıştıran Android cihazlarda desteklenir.

Örnek uygulama için Sample App for Matter'ın manifest dosyasına bakın.

Home modülünün kullanılabilirliğini çalışma zamanında ModuleInstallClient kullanarak kontrol edebilirsiniz. Daha fazla bilgi için ModuleInstallClient ile API kullanılabilirliğini sağlama sayfasına bakın.

Diğer Android uygulamalarını çağırma

Android 11 veya sonraki bir sürümü kullanıyorsanız uygulamanızın diğer uygulamaları çağırabilmesi için AndroidManifest.xml dosyasına aşağıdaki queries bloğunu eklemeniz gerekir.

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

Daha fazla bilgi için Android'de paket görünürlüğü filtreleme başlıklı makaleyi inceleyin.

Matter için Google Home Örnek Uygulaması'nı kullanma

Mobile SDK özelliğinin bir Android uygulamasında nasıl çalıştığını öğrenmek için Sample App for Matter sayfamızı inceleyin.

Sample App for Matter deneyin

Kendi uygulamanızı oluşturma

Hızlıca başlamanıza yardımcı olmak için Sample App for Matter açık kaynaklı hale getirdik ve örnek kodumuzu kendi Android projeleriniz için özelleştirmenize olanak tanıyan bir tamamlayıcı codelab sağladık.

Sample App for Matter codelab'ine gidin

Kaynaklar

Mobile SDK hakkında daha fazla bilgi edinmek için API referansına bakın.

Bu SDK'nın son kullanıcı verilerini nasıl işlediğini öğrenmek için Home Mobile SDK Google Play Veri Güvenliği Bölümü'ne bakın.