同步處理資料

本文說明如何在 Wear OS 裝置和手持裝置之間同步處理資料。

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

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

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

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

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

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

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

監聽服務中的事件

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

監聽活動中的事件

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

轉移資料

如果想透過藍牙傳輸二進位大型物件 (如其他裝置的語音錄音)，您可以為資料項目附加 Asset，然後把該資料項目放到複製的資料儲存庫中。

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

注意：雖然資料項目的大小理論上不得超過 100 KB，但實際上可以使用更大的資料項目。針對較大的資料項目，請使用不重複的路徑分隔資料，避免讓所有資料使用同一個路徑。在很多情況下，轉移大型素材資源都會對使用者體驗造成影響，因此請測試應用程式，確定在轉移大型素材資源時能維持良好效能。

轉移素材資源

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

Kotlin

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

Java

private static Asset createAssetFromBitmap(Bitmap bitmap) {
    final ByteArrayOutputStream byteStream = new ByteArrayOutputStream();
    bitmap.compress(Bitmap.CompressFormat.PNG, 100, byteStream);
    return Asset.createFromBytes(byteStream.toByteArray());
}

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

以下範例使用 PutDataRequest：

Kotlin

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

Java

Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.image);
Asset asset = createAssetFromBitmap(bitmap);
PutDataRequest request = PutDataRequest.create("/image");
request.putAsset("profileImage", asset);
Task<DataItem> putTask = Wearable.getDataClient(context).putDataItem(request);

以下範例使用 PutDataMapRequest：

Kotlin

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

Java

Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.image);
Asset asset = createAssetFromBitmap(bitmap);
PutDataMapRequest dataMap = PutDataMapRequest.create("/image");
dataMap.getDataMap().putAsset("profileImage", asset);
PutDataRequest request = dataMap.asPutDataRequest();
Task<DataItem> putTask = Wearable.getDataClient(context).putDataItem(request);

接收素材資源

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

Kotlin

override fun onDataChanged(dataEvents: DataEventBuffer) {
    dataEvents
            .filter { it.type == DataEvent.TYPE_CHANGED && it.dataItem.uri.path == "/image" }
            .forEach { event ->
                val bitmap: Bitmap? = DataMapItem.fromDataItem(event.dataItem)
                        .dataMap.getAsset("profileImage")
                        .let { asset -> loadBitmapFromAsset(asset) }
                // Do something with the bitmap
            }
}

fun loadBitmapFromAsset(asset: Asset): Bitmap? {
    // Convert asset into a file descriptor and block until it's ready
    val assetInputStream: InputStream? =
            Tasks.await(Wearable.getDataClient(context).getFdForAsset(asset))
            ?.inputStream

    return assetInputStream?.let { inputStream ->
        // Decode the stream into a bitmap
        BitmapFactory.decodeStream(inputStream)
    } ?: run {
        Log.w(TAG, "Requested an unknown Asset.")
        null
    }
}

Java

@Override
public void onDataChanged(DataEventBuffer dataEvents) {
  for (DataEvent event : dataEvents) {
    if (event.getType() == DataEvent.TYPE_CHANGED &&
        event.getDataItem().getUri().getPath().equals("/image")) {
      DataMapItem dataMapItem = DataMapItem.fromDataItem(event.getDataItem());
      Asset profileAsset = dataMapItem.getDataMap().getAsset("profileImage");
      Bitmap bitmap = loadBitmapFromAsset(profileAsset);
      // Do something with the bitmap
    }
  }
}

public Bitmap loadBitmapFromAsset(Asset asset) {
    if (asset == null) {
        throw new IllegalArgumentException("Asset must be non-null");
    }
    // Convert asset into a file descriptor and block until it's ready
    InputStream assetInputStream =
        Tasks.await(Wearable.getDataClient(context).getFdForAsset(asset))
            .getInputStream();
    if (assetInputStream == null) {
        Log.w(TAG, "Requested an unknown Asset.");
        return null;
    }
    // Decode the stream into a bitmap
    return BitmapFactory.decodeStream(assetInputStream);
}

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