Skip to content

Latest commit

 

History

History
65 lines (45 loc) · 3.5 KB

data-items.md

File metadata and controls

65 lines (45 loc) · 3.5 KB
Raw

同步数据单元

编写:wly2014 - 原文: http://developer.android.com/training/wearables/data-layer/data-items.html

DataItem是指系统用于同步手持设备与可穿戴设备间数据的接口。一个DataItem通常包括以下几点：

  • Pyload- 一个字节数组，你可以用来设置任何数据，让你的object序列化和反序列化。Pyload的大小限制在100k之内。

  • Path- 唯一的必须以斜线开头(如："/path/to/data")的string。

通常不直接实现DataItem，而是：

  1. 创建一个PutdataRequest对象，指明一个string path。
  2. 调用setData()方法。
  3. 调用DataApi.putDataItem()方法，请求系统创建数据元。
  4. 当请求的时候，系统会返回正确实现DataItem接口的对象。

然而，我们建议使用Data Map来显示装在一个易用的类似Bundle接口中的数据元，而用不是setData()来处理原始字节。

用 Data Map 同步数据

使用DataMap类，将数据元处理为 Android Bundle的形式，因此对象的序列化和反序列化就会完成，你就可以以 key-value 对的形式操纵数据。

如何使用：

  1. 创建一个 PutDataMapRequest对象，设置数据元的path。

Note: path 字符串对数据元是唯一确定的，这样能够使你从另一连接端访问。Path须以斜线开始。如果你想在应用中使用分层数据，就要创建一个适合数据结构的路径方案。

  1. 调用PutDataMapRequest.getDataMap()获取一个你可以使用的data map 对象。
  2. 使用put...()方法，如：[putString()](DataMap.html#putString(java.lang.String, java.lang.String)),为data map设置数据。
  3. 调用PutDataMapRequest.asPutDataRequest()获得PutDataRequest对象。
  4. 调用 [DataApi.putDataItem()](DataApi.html#putDataItem(com.google.android.gms.common.api.GoogleApiClient, com.google.android.gms.wearable.PutDataRequest)) 请求系统创建数据元

Note: 如果手机和可穿戴设备没有连接，数据会缓冲并在重新建立连接时同步。

接下来的例子展示如何创建一个data map，并设置数据：

PutDataMapRequest dataMap = PutDataMapRequest.create("/count");
dataMap.getDataMap().putInt(COUNT_KEY, count++);
PutDataRequest request = dataMap.asPutDataRequest();
PendingResult<DataApi.DataItemResult> pendingResult = Wearable.DataApi
        .putDataItem(mGoogleApiClient, request);

监听数据元事件

如果一端的数据层的数据发生改变，想要在另一端被提醒此改变，你可以通过实现一个数据元事件的监听器来完成。

例如，这是一个典型的用回调来实现特定的action,当数据发生改变时。

@Override
public void onDataChanged(DataEventBuffer dataEvents) {
    for (DataEvent event : dataEvents) {
        if (event.getType() == DataEvent.TYPE_DELETED) {
            Log.d(TAG, "DataItem deleted: " + event.getDataItem().getUri());
        } else if (event.getType() == DataEvent.TYPE_CHANGED) {
             Log.d(TAG, "DataItem changed: " + event.getDataItem().getUri());
        }
    }
}

这仅是一小片段，如何实现完整监听和activity 请见 Listening for Data Layer Events。