同步處理資料

本文說明如何在 Wear OS 裝置和手機之間同步資料。如要瞭解何時應使用 Data Layer API，何時應使用基礎架構，請參閱總覽指南。

直接從網路傳送及同步處理資料

建構 Wear OS 應用程式，以便直接與網路通訊。您可以採用和行動開發相同的 API，但請留意 Wear OS 的特定差異。

使用 Wear OS Data Layer API 同步處理資料

DataClient 會公開 API，讓元件能夠讀取或寫入 DataItem 或 Asset。

注意： 這個類別是用於同步處理資料，而非做為儲存機制。建立應用程式可存取的資料副本，例如在 Room 資料庫中。

您可以在不連線至任何裝置的情況下設定資料項目和資產。裝置建立網路連線後，系統就會同步處理這些資料。這項資料僅供您的應用程式使用，且僅供您在其他裝置上存取。

• DataItem 會同步到 Wear OS 網路中的所有裝置。 這些通常是小型項目；

  注意： 在手機上解除安裝應用程式時，系統會重設資料項目和資產。

• 如要傳輸較大的物件 (例如圖片)，請使用 Asset。系統會追蹤已轉移的資產，並自動執行重複資料刪除作業。

監聽服務中的事件

擴充 WearableListenerService 類別。系統會管理基本 WearableListenerService 的生命週期，在需要傳送資料項目或訊息時繫結至服務，以及在不需要執行任何工作時解除服務繫結。

監聽活動中的事件

實作 OnDataChangedListener 介面。如果只想在使用者主動使用應用程式時監聽變更，請使用這個介面，而非 WearableListenerService。

description: Transfer large binary objects, such as images, between Android phones and Wear OS watches using Assets in the Data Layer API. keywords_public: Wear OS, Data Layer API, Assets, Bluetooth data transfer, data synchronization, DataMap, PutDataRequest

同步處理資料

如要透過藍牙傳輸大型二進位物件 (例如其他裝置的語音錄音)，可以為資料項目附加 Asset，然後將該資料項目放到複製的資料儲存庫中。不過，如果只是在兩部連線裝置之間進行一次性交換，請考慮是否更適合使用較簡單的直接轉移。

注意：Data Layer API 只能使用 Android 手機或 Wear OS 手錶傳送訊息和同步處理資料。如果 Wear OS 裝置與 iOS 裝置配對，Data Layer API 將無法運作。

因此，請勿使用 Data Layer API 做為與網路通訊的主要方式。請改為在 Wear OS 應用程式中使用與手機應用程式相同的模式，略有差異處請參考「Wear OS 的網路存取與同步」一節。

素材資源會自動處理資料快取作業，可防止系統重新傳輸，並節省藍牙頻寬。以手機應用程式來說，常見的模式是將下載的圖片縮小為適合手錶顯示的尺寸，再以素材資源形式分享到手錶應用程式內。以下範例會示範這個模式。

轉移素材資源

使用 Asset 類別內任一種 create...() 方法建立素材資源。將點陣圖轉換為位元組陣列，然後呼叫 createFromBytes() 建立素材資源，如以下範例所示。

private fun createAssetFromBitmap(bitmap: Bitmap): Asset =
    ByteArrayOutputStream().let { byteStream ->
        bitmap.compress(Bitmap.CompressFormat.PNG, 100, byteStream)
        Asset.createFromBytes(byteStream.toByteArray())
    }
DataLayerActivity.kt

接著，使用 DataMap 或 PutDataRequest 中的 putAsset() 方法，將素材資源附加到資料項目。然後使用 putDataItem() 方法，將資料項目放入資料儲存庫，如以下範例所示。

下列範例使用 PutDataRequest：

private fun Context.sendImagePutDataRequest(): Task<DataItem> {

    val asset: Asset = createAssetFromBitmap(BitmapFactory.decodeResource(resources, R.drawable.ic_walk))
    val request: PutDataRequest = PutDataRequest.create("/image").apply {
        putAsset("profileImage", asset)
    }
    val putTask: Task<DataItem> = Wearable.getDataClient(this).putDataItem(request)

    return putTask
}
DataLayerActivity.kt

下列範例使用 PutDataMapRequest：

private fun Context.sendImagePutDataMapRequest(): Task<DataItem> {

    val asset: Asset = createAssetFromBitmap(BitmapFactory.decodeResource(resources, R.drawable.ic_walk))
    val request: PutDataRequest = PutDataMapRequest.create("/image").run {
        dataMap.putAsset("profileImage", asset)
        asPutDataRequest()
    }
    val putTask: Task<DataItem> = Wearable.getDataClient(this).putDataItem(request)

    return putTask
}
DataLayerActivity.kt

注意： 使用 Wearable Data Layer API 前，請先確認該 API 是否可用，否則會發生例外狀況。使用 GoogleApiAvailability 類別，如總覽所示。

接收素材資源

建立資產後，您通常會在連線另一端的裝置讀取並擷取這個資產。以下範例說明如何實作回呼來偵測素材資源變動情形，並擷取該素材資源：

override fun onDataChanged(dataEvents: DataEventBuffer) {
    dataEvents
        .filter { it.type == DataEvent.TYPE_CHANGED && it.dataItem.uri.path == "/image" }
        .forEach { event ->
            val asset = DataMapItem.fromDataItem(event.dataItem)
                .dataMap.getAsset("profileImage")

            asset?.let { safeAsset ->
                lifecycleScope.launch {
                    val bitmap = loadBitmapFromAsset(safeAsset)
                    // Do something with the bitmap
                }
            }
        }
}

private suspend fun loadBitmapFromAsset(asset: Asset): Bitmap? = withContext(Dispatchers.IO) {
    try {
        val assetResult = Wearable.getDataClient(this@DataLayerActivity2)
            .getFdForAsset(asset)
            .await()

        assetResult?.inputStream?.use { inputStream ->
            BitmapFactory.decodeStream(inputStream)
        }
    } catch (e: Exception) {
        e.printStackTrace()
        null
    }
}
DataLayerActivity.kt

詳情請參閱 GitHub 上的 DataLayer 範例專案。