Android için Home Mobile SDK'sı

Google, Matter cihazlarla etkileşim kuran Android uygulamaları oluşturmanıza yardımcı olmak için Google Home Mobile SDK'ı geliştirmiştir. Mobile SDK, uygulamalarınızın Google kumaşıyla cihazları görevlendirmesine ve paylaşmasına olanak tanıyan iki temel API içerir.

Google ağına eklenen cihazlar, kullanıcılarınız tarafından Google Home app (GHA), Android güç kontrolleri, ses ve Nest dokunmatik ekranlı cihazlar aracılığıyla kontrol edilebilir.

Mobile SDK, cihazları ek Matter ekosistemleriyle birlikte kullanmak için kullanabileceğiniz özel bir yetkilendirme hizmeti de tanımlamanıza 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'i ayarlama 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ün yayınlanması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.

Hem GHA hem de Google Home Sample App for Matter, bu modül bağımlılığını manifest dosyalarına eklemiştir. Mobile SDK'ü Android uygulamanıza entegre ediyorsanız uygulamanızın kullanıcılarına Matter desteği sağlamak için AndroidManifest.xml dosyanızın 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.

ModuleInstallClient öğesini kullanarak Home modülünün çalışma zamanındaki kullanılabilirliğini kontrol edebilirsiniz. Daha fazla bilgi için 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 AndroidManifest.xml içine 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 Android uygulamasından nasıl çalıştığını öğrenmek için Sample App for Matter'imizi deneyin.

Sample App for Matter'u deneyin

Kendi uygulamanızı oluşturma

Hızlı bir başlangıç yapmanıza yardımcı olmak için Sample App for Matter'ü açık kaynak olarak yayınladık ve örnek kodumuzu kendi Android projeleriniz için özelleştirmenize olanak tanıyan bir tamamlayıcı kod laboratuvarı 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.