Android Wear数据层：深入理解DataItem数据同步机制

最新推荐文章于 2025-06-04 09:08:17 发布

原创最新推荐文章于 2025-06-04 09:08:17 发布 · 318 阅读

CC 4.0 BY-SA版权

Android Wear数据层：深入理解DataItem数据同步机制

android-training-course-in-chinese Android官方培训课程中文版项目地址: https://gitcode.com/gh_mirrors/an/android-training-course-in-chinese

本文基于kesenhoo/android-training-course-in-chinese项目中关于Wearable数据层的内容，深入讲解Android Wear设备间数据同步的核心机制——DataItem。

什么是DataItem？

DataItem是Android Wear数据层中最基础的数据同步单元，它构成了手持设备与可穿戴设备之间数据通信的基础。理解DataItem的工作机制对于开发高效的Wear应用至关重要。

DataItem的核心组成

每个DataItem包含两个关键部分：

路径(Path)：唯一标识符，必须以"/"开头，如"/sensor/data"
负载(Payload)：最大100KB的字节数组，用于存储实际数据

创建DataItem的标准流程

开发者通常不直接实现DataItem接口，而是遵循以下标准流程：

创建PutDataRequest对象并指定唯一路径
使用setData()方法设置负载数据
通过DataApi.putDataItem()请求系统创建DataItem
系统返回实现了DataItem接口的对象

更优雅的数据处理：DataMap

虽然可以直接操作原始字节数据，但Android Wear提供了更高级的DataMap类，它类似于Android中的Bundle，提供了键值对存储的便利接口。

DataMap使用最佳实践

创建PutDataMapRequest：指定数据路径，路径应反映数据结构
获取DataMap对象：通过getDataMap()方法
填充数据：使用putString()、putInt()等方法
转换为请求：通过asPutDataRequest()转换
提交请求：使用DataApi.putDataItem()

// 示例：使用DataMap同步计数器值
private void syncCounter(int count) {
    PutDataMapRequest putRequest = PutDataMapRequest.create("/counters/main");
    putRequest.getDataMap().putInt("counter_value", count);
    PutDataRequest request = putRequest.asPutDataRequest();
    Wearable.DataApi.putDataItem(mGoogleApiClient, request);
}

实时数据监听机制

为了响应另一端设备的数据变化，我们需要实现数据监听器。

监听器实现要点

实现DataApi.DataListener接口
在连接建立时注册监听器
在适当时候取消注册
处理onDataChanged回调

@Override
public void onDataChanged(DataEventBuffer dataEvents) {
    for (DataEvent event : dataEvents) {
        if (event.getType() == DataEvent.TYPE_CHANGED) {
            DataItem item = event.getDataItem();
            if (item.getUri().getPath().equals("/counters/main")) {
                DataMap dataMap = DataMapItem.fromDataItem(item).getDataMap();
                updateUI(dataMap.getInt("counter_value"));
            }
        }
    }
}