Чтобы помочь вам создавать приложения для 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-приложение
Чтобы начать работу, выполните следующие действия:
Следуйте инструкциям, приведенным в разделе Настройка 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 о безопасности данных.