Чтобы помочь вам создавать приложения 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 «Безопасность данных».