以下内容翻译自android wear的官方教程，本人水平有限，如有错误欢迎指出
home
以下正文
DataItem
定义了在手机(handhelds)和手表之间的数据同步接口。
一个DataItem一般包含一下的内容：
- Payload -- 一个二进制数组，你可以在里面存放任何数据，你可以自己设计序列化和反序列化的过程，最大可存放容量为100KB
- Path -- 一个唯一的字符串，必须用斜线开头(比如“/path/to/data”)
一般你不需要直接实现 （implement）DataItem
，你只需要通过下面的方式来使用它：
创建 PutDataRequest
对象，给它指定一个唯一的路径来标示数据。用 setData()
来设置payload.如果延迟会影响用户的体验，你可以调用 setUrgent()
来降低延迟。用 [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的步骤：
- 创建一个 PutDataMapRequest
对象，并设置data item的path。
注意path应该是这个数据项(data item)的唯一标示符，这样你就能在被连接起来的手机和手表上访问到正确的数据项(data item)。path必须由斜杠开头，如果你的app是用分级的数据，你应该建立一个符合你的数据层次的path结构。
调用PutDataMapRequest.getDataMap()
来获取一个你可以存放数据的data map。用put...()方法存放任何你想要存放的数据，比如putString().
如果延迟是需要避免的，调用 setUrgent()
调用 PutDataMapRequest.asPutDataRequest()
来获取 PutDataRequest
对象调用 [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<DataApi.DataItemResult> 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实现监听器进行监听，这将在后续的章节进行讨论。
