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 yapısıyla 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, ek Matter ekosistemlerinde cihazlara hizmet vermek için kullanabileceğiniz bir özel hizmete alma hizmeti tanımlamanıza da olanak tanır.

Mobil SDK'yı Android uygulamanıza entegre etme

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

  1. Google Play services'ı ayarlama bölümünde verilen 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 teslimini 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 SDK'sını Android uygulamanıza entegre ediyorsanız uygulamanızın kullanıcılarına Matter desteği sunmak için service bloğunu application beyanına ekleyin: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>

Bu özellik yalnızca Android cihazlarda desteklenir. Cihazınızda Play services 22.50.14 veya sonraki bir sürümün yüklü olması gerekir.

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

ModuleInstallClient kullanarak çalışma zamanında Home modülünün 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 bloğunu AndroidManifest.xml içine 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.