访问 Wearable Data Layer

如需调用 Data Layer API,请使用 Wearable 类获取各种客户端类的实例,例如 DataClient MessageClient

请参阅以下相关资源:

注意:Data Layer API 只能发送消息并与 Android 设备或 Wear OS 手表同步数据。这意味着,如果您的 Wear OS 设备与 iOS 设备配对,则 Data Layer API 将无法正常运行。

因此,您不应使用 Data Layer API 作为与网络进行通信的主要方式。您应采用与移动应用相同的模式,但有一些细微差异

使用最小客户端

刚开始使用时,最小客户端(见以下示例)就足够了。 如需了解详情,请参阅访问 Google API

Kotlin

val dataClient: DataClient = Wearable.getDataClient(context)

Java

DataClient dataClient = Wearable.getDataClient(context);

上下文可以是任何有效的 Android 上下文。如果您在 Activity 的范围内使用该 API,请使用 Wearable 类的 getDataClient(activity) 方法。该方法能让某些互动以对话框形式显示,而不是通知。例如,要求用户更新其 Google Play 服务版本时,就是如此。

默认情况下,监听器的回调在应用的主界面线程上进行。 如需在其他线程上进行回调,请使用 WearableOptions 对象指定自定义 Looper

Kotlin

val dataClient: DataClient =
        Wearable.WearableOptions.Builder().setLooper(myLooper).build().let { options ->
            Wearable.getDataClient(context, options)
        }

Java

WearableOptions options = new WearableOptions.Builder().setLooper(myLooper).build();
DataClient dataClient = Wearable.getDataClient(context, options);

如需了解详情,请参阅 WearableOptions.Builder 参考文档。

Wearable API 客户端的创建成本很低,例如 DataClient MessageClient 就是如此。API 客户端不需要保留,因此您可以根据需要创建任意次。使用适合您的应用的样式。客户端状态(例如,一组已注册的监听器)在所有客户端之间共享,并且如果 Google Play 服务在应用运行期间进行了更新,客户端状态会保留。