在表盘上显示信息

编写:heray1990 - 原文: http://developer.android.com/training/wearables/watch-faces/information.html

为了显示时间，Android Wear 设备以 cards、notifications 和其它可穿戴应用的形式向用户提供相关的信息。创建自定义表盘不仅可以以丰富的方式显示时间，还可以在用户扫视设备的时候显示相关的信息。

像其它可穿戴应用一样，我们的表盘可以通过可穿戴数据层 API 与可穿戴设备上的应用通信。某些情况下，我们需要在工程中的手持式应用模块里创建一个 activity，该 activity 从互联网或者用户的配置文件中检索数据，然后将数据分享给表盘。

在表盘上显示信息 - 图1在表盘上显示信息 - 图2

Figure 1. 表盘集成数据的例子

创建丰富的体验

在设计和实现上下文感知的表盘前，先回答下面几个问题：

  • 我们想要包含什么类型的数据？
  • 我们可以从哪里获得数据？
  • 数据多久会显著变化？
  • 如何表达数据，使得用户瞥一眼就明白其中的意思？

Android Wear 设备通常与一个带有 GPS 或者蜂窝数据连接的配套设备配对，所以我们有无限的可能来整合不同数据到表盘中，例如位置、日历事件、社交媒体、图片、股票市场报价、新闻事件体育得分等等。然而，并不是所有类型的数据都适合表盘，所以我们需要考虑哪种类型的数据与用户最相关。当可穿戴没有配对的设备或者互联网连接断开时，表盘应该优雅地处理这些情况。

Android Wear 设备上活动的表盘是一个一直在运行的应用，所以我们必须使用高效节能的方法来获取数据。例如，我们每隔10分钟而不是每隔1分钟去获取当前的天气然后将结果保存到本地。当设备从环境模式切换到交互模式时，我们可以刷新上下文数据。这是因为在切换到交互模式时，用户很可能想瞥一眼手表。

由于屏幕的空间有限，并且用户看手表也只是一次看一两秒，所以我们应该在表盘上面将上下文信息归纳起来。有时表达上下文信息最好的方法是用图形和颜色来反应。例如，表盘可以根据当前的天气改变自身的背景图片。

添加数据到表盘

Android SDK 中的 WatchFace 示例展示了如何在 CalendarWatchFaceService 类里从用户的配置文件中获得日程数据，然后显示接下来的24小时有多少个会议。这个示例位于 android-sdk/samples/android-21/wearable/WatchFace 目录下。

在表盘上显示信息 - 图3

Figure 2. 日程表盘

按照下面的步骤实现包含上下文数据的表盘：

  1. 提供一个任务来检索数据。
  2. 创建一个自定义定时器来周期性地调用任务，或者当外部数据变化时通知表盘服务。
  3. 用更新的数据重新绘制表盘。

下面的内容详细介绍了上述几个步骤。

提供一个任务来检索数据

在 CanvasWatchFaceService.Engine 实现里创建一个继承 AsyncTask 的类。然后添加用于接收我们感兴趣的数据的代码。

下面是 CalendarWatchFaceService 类获取第二天会议数量的代码：

  1. /* Asynchronous task to load the meetings from the content provider and
  2.  * report the number of meetings back using onMeetingsLoaded() */
  3. private class LoadMeetingsTask extends AsyncTask<Void, Void, Integer> {
  4.     @Override
  5.     protected Integer doInBackground(Void... voids) {
  6.         long begin = System.currentTimeMillis();
  7.         Uri.Builder builder =
  8.                 WearableCalendarContract.Instances.CONTENT_URI.buildUpon();
  9.         ContentUris.appendId(builder, begin);
  10.         ContentUris.appendId(builder, begin + DateUtils.DAY_IN_MILLIS);
  11.         final Cursor cursor = getContentResolver() .query(builder.build(),
  12.                 null, null, null, null);
  13.         int numMeetings = cursor.getCount();
  14.         if (Log.isLoggable(TAG, Log.VERBOSE)) {
  15.             Log.v(TAG, "Num meetings: " + numMeetings);
  16.         }
  17.         return numMeetings;
  18.     }
  20.     @Override
  21.     protected void onPostExecute(Integer result) {
  22.         /* get the number of meetings and set the next timer tick */
  23.         onMeetingsLoaded(result);
  24.     }
  25. }

Wearable Support 库的 WearableCalendarContract 类可以直接存取配套设备用户的日历事件。

当任务检索完数据时，我们的代码会调用一个回调方法。下面的内容详细介绍了如何实现这个回调方法。

更多关于从日历获取数据的内容，请参考 Calendar Provider API 指南。

创建自定义定时器

我们可以实现一个周期计数的自定义定时器来更新数据。CalendarWatchFaceService 类使用一个 Handler 实例通过线程的消息队列来发送和处理延时的消息：

  1. private class Engine extends CanvasWatchFaceService.Engine {
  2.     ...
  3.     int mNumMeetings;
  4.     private AsyncTask<Void, Void, Integer> mLoadMeetingsTask;
  6.     /* Handler to load the meetings once a minute in interactive mode. */
  7.     final Handler mLoadMeetingsHandler = new Handler() {
  8.         @Override
  9.         public void handleMessage(Message message) {
  10.             switch (message.what) {
  11.                 case MSG_LOAD_MEETINGS:
  12.                     cancelLoadMeetingTask();
  13.                     mLoadMeetingsTask = new LoadMeetingsTask();
  14.                     mLoadMeetingsTask.execute();
  15.                     break;
  16.             }
  17.         }
  18.     };
  19.     ...
  20. }

当可以看到表盘时，这个方法初始化了定时器：

  1. @Override
  2. public void onVisibilityChanged(boolean visible) {
  3.     super.onVisibilityChanged(visible);
  4.     if (visible) {
  5.         mLoadMeetingsHandler.sendEmptyMessage(MSG_LOAD_MEETINGS);
  6.     } else {
  7.         mLoadMeetingsHandler.removeMessages(MSG_LOAD_MEETINGS);
  8.         cancelLoadMeetingTask();
  9.     }
  10. }

下面的内容介绍在 onMeetingsLoaded() 方法设置下一个定时器。

用更新的数据重新绘制表盘

当任务检索完数据时，调用 invalidate() 方法使得系统可以重新绘制表盘。将数据保存到 Engine 类的成员变量，这样我们就可以在 onDraw() 方法中访问数据。

CalendarWatchFaceService 类提供一个回调方法给任务在检索完日程数据后调用：

  1. private void onMeetingsLoaded(Integer result) {
  2.     if (result != null) {
  3.         mNumMeetings = result;
  4.         invalidate();
  5.     }
  6.     if (isVisible()) {
  7.         mLoadMeetingsHandler.sendEmptyMessageDelayed(
  8.                 MSG_LOAD_MEETINGS, LOAD_MEETINGS_DELAY_MS);
  9.     }
  10. }

回调方法将结果保存在一个成员变量中，销毁 view，和调度下一个定时器再次运行任务。