開始使用

跨裝置 SDK 開發人員預覽版是透過開放原始碼專案發布。這個預覽功能可讓開發人員社群進行設計原型及驗證多裝置體驗的原型，但不適用於正式版應用程式。

注意： 您必須開啟快速分享功能，才能使用跨裝置 SDK。詳情請參閱「與鄰近裝置分享檔案和連結」一文。

設定 Google Play 服務

開始編寫程式碼之前，請先確認已安裝 Google Play 服務。「跨裝置 SDK」目前為開發人員預覽版，只能透過 Google Play 服務 Beta 版計畫取得。如要瞭解如何註冊 Beta 版計畫，請參閱這份指南。

註冊 Beta 版計畫並安裝適當的 Google Play 服務 Beta 版後，即可開始使用跨裝置 SDK 開發多裝置體驗。

依附元件和權限

首先，開啟應用程式模組 build.gradle 檔案，然後新增跨裝置 SDK 的依附元件，如下所示：

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

在開發人員預覽版期間，API 可能會有所變動，因此請定期查看版本資訊，確保您使用的是最新版的跨裝置 SDK。

使用跨裝置 SDK 的其中一項優點是可讓您省去本機探索作業，例如 BLUETOOTH_CONNECT、BLUETOOTH_SCAN 和 ACCESS_FINE_LOCATION。

注意： 您仍須宣告及要求跨裝置 SDK 外的應用程式功能和 API 所需的執行階段權限。舉例來說，您可能需要 BLUETOOTH_SCAN 權限，才能在跨裝置 SDK 以外執行藍牙掃描。

跨裝置 API

跨裝置 SDK 中的每個 API 都是為瞭解決多裝置架構中的常見工作：

• 裝置探索：輕鬆尋找鄰近裝置、授權點對點通訊，並在接收端裝置上啟動目標應用程式。
• 安全通訊：啟用已授權裝置間的加密、低延遲且雙向資料共用功能。
• 多裝置工作階段：在各種裝置上轉移或擴充應用程式的使用體驗。

這些 API 可透過 Discovery 和 Sessions 類別使用：

Kotlin

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

Java

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

如要進一步瞭解這些 API 的特定用途，請參閱以下各節，或參閱範例應用程式存放區。

注意： 跨裝置 SDK 的設計為非同步設計。如果您不熟悉非同步作業，建議您瞭解 Kotlin 適用的 Coroutines 或 Java 適用的 ListenableFuture。

範例應用程式

我們準備了一些應用程式，可以用來示範跨裝置 SDK 的實際運作情形。 這些範例應用程式是以簡單的《Rock》、《Paper》和《Sissors》遊戲為主軸打造而成，提供直覺化的互動方式，有助您熟悉 API。建議您探索並修改程式碼範例，以便瞭解如何使用：

• 探索裝置
• 安全連線
• 工作階段轉移
• 共用工作階段

查看 GitHub 上的跨裝置搖滾、報告、剪刀。