开始使用

Cross Device SDK 开发者预览版通过开源项目分发。此预览版可供开发者社区用于对多设备体验进行原型设计和验证,但不打算在正式版应用中使用。

设置 Google Play 服务

在开始编码之前,请确保已安装 Google Play 服务。Cross device SDK 目前处于开发者预览版,仅通过 Google Play 服务 Beta 版计划提供。如需了解如何注册参加 Beta 版计划,请参阅此指南

注册加入 Beta 版计划并安装相应的 Beta 版 Google Play 服务后,您就可以开始使用 Cross Device SDK 开发多设备体验了。

依赖项和权限

首先,打开应用模块 build.gradle 文件,然后添加 Cross device SDK 的依赖项,如下所示:

dependencies {
    implementation 'com.google.ambient.crossdevice:crossdevice:0.1.0-preview01'
}

在开发者预览版期间,该 API 可能会发生变化,因此请定期查看版本说明,确保您使用的是最新版本的 Cross Device SDK。

使用 Cross device SDK 的一个好处是,它会抽象化本地发现,例如 BLUETOOTH_CONNECTBLUETOOTH_SCANACCESS_FINE_LOCATION

Cross device API

Cross device SDK 中的每个 API 均旨在解决多设备框架中的一个常见任务:

  • 设备发现:轻松找到附近的设备,授权点对点通信,并在接收设备上启动目标应用。
  • 安全通信:在授权设备之间实现加密、低延迟的双向数据共享。
  • 多设备会话:跨设备传输或扩展应用的用户体验。

这些 API 通过 DiscoverySessions 类提供:

Kotlin

val discovery = Discovery.create(context)
val sessions = Sessions.create(context)

Java

Discovery discovery = Discovery.create(context);
Sessions sessions = Sessions.create(context);

您可以在以下几个部分中详细了解这些 API 的具体用途,或参阅我们的示例应用代码库

示例应用

我们准备了许多应用来演示 Cross device SDK 的实际应用。这些示例应用是围绕一个简单的石头剪刀布游戏构建的,可让您通过直观的互动式方式熟悉各种 API。我们建议您探索和修改示例代码,以了解如何使用:

  • 设备发现
  • 安全连接
  • 会话传输
  • 共享的会话

不妨查看 GitHub 上的“石头剪刀布”跨设备