适用于 Android 的 Home Mobile SDK

为了帮助您构建与以下 API 交互的 Android 应用： Matter 设备，Google 开发了 Google Home Mobile SDK。通过 Mobile SDK 包含两个核心 API，可让应用 调试和共享设备。

将设备添加到 Google 结构后，您的用户可以控制 设备（通过 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'

确保模块交付

Play services home 模块是可选的，因此 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 清单 获取示例实现。

您可以使用 ModuleInstallClient。请参阅 使用 ModuleInstallClient 确保 API 可用性 页面。

调用其他 Android 应用

如果您使用的是 Android 11 或更高版本，则需要添加以下内容 在 AndroidManifest.xml 中使用 queries 代码块，以便您的应用可以调用 。

<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 上的软件包可见性过滤一文。

使用适用于 Matter 的 Google Home 示例应用

如需了解 Mobile SDK 在 Android 应用中的运作方式，请尝试 我们的Sample App for Matter。

试用Sample App for Matter

构建自己的应用

为帮助您快速入门，我们开放了 Sample App for Matter，并提供了一个配套的 Codelab，让您能够： 为您自己的 Android 项目自定义我们的示例代码。

前往 Sample App for Matter Codelab

资源

如需详细了解 Mobile SDK，请参阅 API 参考文档。

如需了解此 SDK 如何处理最终用户数据，请参阅 Home 移动 SDK Google Play 数据安全部分