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ştirmiştir. Mobile SDK, uygulamalarınızın cihazları Google Fabric ile devreye almasına ve paylaşmasına olanak tanıyan iki temel API içerir.

Google ağına eklenen cihazları kullanıcılarınız Google Home app (GHA), Android güç kontrolleri, ses ve Nest dokunmatik ekran cihazları üzerinden kontrol edebilir.

Mobile SDK, cihazları ek Matter ekosistemlerine devreye almak için kullanabileceğiniz bir özel 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ı tamamlayın:

  1. Google Play services kurulumu bölümündeki 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ı belirtirse 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'yı Android uygulamanıza entegre ediyorsanız uygulamanızın kullanıcılarına Matter desteği sunmak için service bloğunu AndroidManifest.xml dosyanızdaki application beyanına 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ümlerin yüklü olduğu Android cihazlarda desteklenir.

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

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

Diğer Android uygulamalarını arama

Android 11 veya sonraki bir sürümü kullanıyorsanız uygulamanızın diğer uygulamalara çağrı yapabilmesi için queries bölümüne aşağıdaki AndroidManifest.xml 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 işlevinin Android uygulamalarında nasıl çalıştığını öğrenmek için Sample App for Matter deneyin.

Sample App for Matter deneyin

Kendi uygulamanızı oluşturma

Hızlı bir başlangıç yapmanı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 yardımcı codelab sağladık.

Sample App for Matter Codelab'e 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.