如要呼叫資料層 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 服務時保留。