Эта страница переведена с помощью Cloud Translation API.

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

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

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

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

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

Для начала выполните следующие шаги:

Следуйте инструкциям в разделе «Настройка Google Play services .
Добавьте зависимость 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 «Безопасность данных».