同步数据

本文档介绍了如何在 Wear OS 设备和手持设备之间同步数据。

直接从网络发送和同步数据

构建 Wear OS 应用以直接与网络通信。使用与移动开发相同的 API，但请记住一些 Wear OS 特有的差异。

使用 Wear OS 数据层 API 同步数据

一个 DataClient 公开了一个 API，供组件读取或写入 DataItem 或 Asset。

在未连接任何设备时，也可以设置数据项和资产。当设备建立网络连接时，它们会同步。此数据对您的应用是私有的，并且只能由您应用在其他设备上访问。

  • 一个 DataItem 会在 Wear OS 网络中的所有设备上同步。它们通常体积较小。

  • 使用 Asset 来传输较大的对象，例如图像。系统会跟踪哪些资产已被传输，并自动执行去重操作。

在服务中监听事件

扩展 WearableListenerService 类。系统管理基础 WearableListenerService 的生命周期，在需要发送数据项或消息时绑定到服务，在不需要工作时解除绑定。

在 Activity 中监听事件

实现 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 示例项目。