存取穿戴式裝置資料層

如要呼叫資料層 API，請使用 Wearable 類別以取得各種用戶端類別的執行個體，例如 DataClient 和 MessageClient。

請參閱下列相關資源：

注意：Data Layer API 只能傳送訊息並與 Android 裝置或 Wear OS 手錶同步處理資料。也就是說，如果您的 Wear OS 裝置與 iOS 裝置配對，Data Layer API 將無法運作。

因此，請「不要」使用 Data Layer API 做為與網路通訊的主要方式。請改用行動應用程式的模式，並做出些微調整。

使用最基本的用戶端

如以下範例所示，以最基本的用戶端即可啟動。如需其他資訊，請參閱「存取 Google API」。

Kotlin

val dataClient: DataClient = Wearable.getDataClient(context)

Java

DataClient dataClient = Wearable.getDataClient(context);

結構定義可以是任何有效的 Android 結構定義。如果您在 Activity 的範圍內使用 API，請使用 Wearable 類別的 getDataClient(activity) 方法。這樣一來，特定互動能夠以對話方塊顯示 (而非通知)，例如要求使用者更新自己的 Google Play 服務版本時。

根據預設，監聽器的回呼是在應用程式的主要 UI 執行緒上進行。如要在不同執行緒上進行回呼，請使用 WearableOptions 物件指定自訂 Looper：

Kotlin

val dataClient: DataClient =
        Wearable.WearableOptions.Builder().setLooper(myLooper).build().let { options ->
            Wearable.getDataClient(context, options)
        }

Java

WearableOptions options = new WearableOptions.Builder().setLooper(myLooper).build();
DataClient dataClient = Wearable.getDataClient(context, options);

詳情請參閱 WearableOptions.Builder 參考資料。

DataClient 和 MessageClient 等 Wearable API 用戶端的建立成本較低。API 用戶端不必保留，因此您可以視需要多次建立 API 用戶端。請使用適合應用程式的樣式。用戶端狀態 (例如已註冊的事件監聽器組合) 會在所有用戶端共用，並於應用程式執行期間更新 Google Play 服務時保留。