与手表同步Data Items

以下内容翻译自android wear的官方教程，本人水平有限，如有错误欢迎指出
home
以下正文

---

DataItem
定义了在手机(handhelds)和手表之间的数据同步接口。
一个DataItem一般包含一下的内容：

• Payload -- 一个二进制数组，你可以在里面存放任何数据，你可以自己设计序列化和反序列化的过程，最大可存放容量为100KB
• Path -- 一个唯一的字符串，必须用斜线开头(比如“/path/to/data”)

一般你不需要直接实现 （implement）DataItem
，你只需要通过下面的方式来使用它：

1. 创建 PutDataRequest
   对象，给它指定一个唯一的路径来标示数据。

2. 用 setData()
   来设置payload.

3. 如果延迟会影响用户的体验，你可以调用 setUrgent()
   来降低延迟。

4. 用 [DataApi.putDataItem()
   ](http://developer.android.youdaxue.com/reference/com/google/android/gms/wearable/DataApi.html#putDataItem(com.google.android.gms.common.api.GoogleApiClient, com.google.android.gms.wearable.PutDataRequest))让系统帮你创建data item.

如果你按照上面的步骤，系统将会帮你实现一个合适的DataItem.但是，如果不想使用纯二进制数组，我们推荐你阅读下面的小结，创建一个像Bundle一样易用的数据接口。

用Data Map同步数据

如果可能的话，我们推荐你使用 DataMap
这个类。用这种方法让你可以像在使用Bundle，系统将会帮你完成Object的序列化和反序列化，而且你也可以使用key-value对的方式。

使用data map的步骤：

1. 创建一个 PutDataMapRequest
   对象，并设置data item的path。

注意path应该是这个数据项(data item)的唯一标示符，这样你就能在被连接起来的手机和手表上访问到正确的数据项(data item)。path必须由斜杠开头，如果你的app是用分级的数据，你应该建立一个符合你的数据层次的path结构。

2. 调用PutDataMapRequest.getDataMap()
   来获取一个你可以存放数据的data map。

3. 用put...()方法存放任何你想要存放的数据，比如putString().

4. 如果延迟是需要避免的，调用 setUrgent()
   

5. 调用 PutDataMapRequest.asPutDataRequest()
   来获取 PutDataRequest
   对象

6. 调用 [DataApi.putDataItem()
   ](http://developer.android.youdaxue.com/reference/com/google/android/gms/wearable/DataApi.html#putDataItem(com.google.android.gms.common.api.GoogleApiClient, com.google.android.gms.wearable.PutDataRequest))来建立数据项(data item)

注意：如果当手机和手表连接中断，那么这个数据将会被缓存并在重新连接之后再尝试同步

下面的increaseCounter()方法将展示如何创建并使用data map.

public class MainActivity extends Activity implements
        DataApi.DataListener,
        GoogleApiClient.ConnectionCallbacks,
        GoogleApiClient.OnConnectionFailedListener {

    private static final String COUNT_KEY = "com.example.key.count";

    private GoogleApiClient mGoogleApiClient;
    private int count = 0;
    ...

    // 创建并使用data map
    private void **increaseCounter**() {
        PutDataMapRequest putDataMapReq = PutDataMapRequest.create("/count");
        putDataMapReq.getDataMap().putInt(COUNT_KEY, count++);
        PutDataRequest putDataReq = putDataMapReq.asPutDataRequest();
        PendingResult pendingResult =
                Wearable.DataApi.putDataItem(mGoogleApiClient, putDataReq);
    }
    ...
}

设置DataItem的优先级

从 Google Play services 8.3以来，DataApi接口允许设置紧急同步数据。一般，系统会延迟发送数据，因为这样可以更加省点。但是如果延迟同步数据会让用户感觉非常难受，你可以把他设成紧急数据。比如，用户在使用远程控制app（控制智能家居之类的）的时候希望TA们的动作将会立刻实现，你可以用setUrgent()让你的数据马上开始同步。

如果你不调用setUrgent(),系统将会延迟30分钟再同步数据，或有有消息调用了setUrgent()。一般的话只需要等几分钟。

监听Data Item事件

如果某一端的数据层改变了数据项，你可能希望在另一端会发现这个事件。你可以实现一个监听器来监听这个事件。

下面的代码片将会通知你的app，当上面的代码改变了counter的值。

public class MainActivity extends Activity implements
        DataApi.DataListener,
        GoogleApiClient.ConnectionCallbacks,
        GoogleApiClient.OnConnectionFailedListener {

    private static final String COUNT_KEY = "com.example.key.count";

    private GoogleApiClient mGoogleApiClient;
    private int count = 0;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        mGoogleApiClient = new GoogleApiClient.Builder(this)
                .addApi(Wearable.API)
                .addConnectionCallbacks(this)
                .addOnConnectionFailedListener(this)
                .build();
    }

    @Override
    protected void onResume() {
        super.onResume();
        mGoogleApiClient.connect();
    }
    
    @Override
    public void onConnected(Bundle bundle) {
        Wearable.DataApi.addListener(mGoogleApiClient, this);
    }

    @Override
    protected void onPause() {
        super.onPause();
        Wearable.DataApi.removeListener(mGoogleApiClient, this);
        mGoogleApiClient.disconnect();
    }

    @Override
    public void onDataChanged(DataEventBuffer dataEvents) {
        for (DataEvent event : dataEvents) {
            if (event.getType() == DataEvent.TYPE_CHANGED) {
                // 被改变的DataItem 
                DataItem item = event.getDataItem();
                if (item.getUri().getPath().compareTo("/count") == 0) {
                    DataMap dataMap = DataMapItem.fromDataItem(item).getDataMap();
                    updateCount(dataMap.getInt(COUNT_KEY));
                }
            } else if (event.getType() == DataEvent.TYPE_DELETED) {
                // 被删除的DataItem
            }
        }
    }

    // 我们更新count的方法
    private void updateCount(int c) { ... }
    ...
}

这个activity实现了 DataItem.DataListener
接口。这个activity把自己作为listener监听器，在onConnected()方法里添加监听，在onPause()方法里移除监听。

你可以用service实现监听器进行监听，这将在后续的章节进行讨论。