Домашний мобильный SDK для Android

Чтобы помочь вам создавать приложения для Android, которые взаимодействуют с устройствами Matter , Google разработал Google Home Mobile SDK . Mobile SDK включает в себя два основных API, которые позволяют вашим приложениям вводить устройства в эксплуатацию и совместно использовать их с Google Fabric.

После добавления устройства в Google Fabric ваши пользователи могут управлять своими устройствами с помощью Google Home app (GHA) , элементов управления питанием Android, голоса и устройств Nest с сенсорным экраном.

Mobile SDK также позволяет вам определить индивидуальную службу ввода в эксплуатацию , которую вы можете использовать для ввода устройств в дополнительные экосистемы Matter .

Интегрируйте Mobile SDK в свое Android-приложение

Чтобы начать работу, выполните следующие действия:

  1. Следуйте инструкциям, приведенным в разделе Настройка Google Play services .

  2. Добавьте зависимость Play services в файл build.gradle :

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

Обеспечить доставку модуля

home модуль Play services является необязательным, поэтому функциональные возможности Matter будут присутствовать на устройстве пользователя только в том случае, если приложение на устройстве указывает соответствующую зависимость модуля Play services в своем файле AndroidManifest.xml .

GHA и Google Home Sample App for Matter включают эту зависимость модуля в свой манифест. Если вы интегрируете Mobile SDK в свое приложение Android , чтобы обеспечить поддержку Matter для пользователей вашего приложения, добавьте следующий service блок в объявление application в файле 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>

Это поддерживается только для устройств Android с Play services 22.50.14 или выше.

Пример реализации см. в манифесте Sample App for Matter .

Вы можете проверить доступность модуля Home во время выполнения с помощью ModuleInstallClient . Дополнительные сведения см. на странице Обеспечение доступности API с помощью ModuleInstallClient .

Вызов других приложений Android

Если вы используете Android 11 или более позднюю версию, вам необходимо включить следующий блок queries в AndroidManifest.xml , чтобы ваше приложение могло совершать вызовы к другим приложениям.

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

Дополнительные сведения см. в статье Фильтрация видимости пакетов на Android .

Используйте пример приложения Google Home для Matter

Чтобы узнать, как работает Mobile SDK в приложении для Android, попробуйте наш Sample App for Matter .

Попробуйте Sample App for Matter

Создайте собственное приложение

Чтобы помочь вам быстрее приступить к работе, мы открыли исходный код Sample App for Matter и предоставили сопутствующую кодовую лабораторию, позволяющую настроить наш пример кода для ваших собственных проектов Android.

Перейдите в лабораторию кода Sample App for Matter

Ресурсы

Дополнительные сведения о Mobile SDK см. в Справочнике по API .

Чтобы узнать, как этот SDK обрабатывает данные конечных пользователей, обратитесь к разделу Home Mobile SDK Google Play о безопасности данных.