在 Wear 上使用手腕手势

在不方便轻触屏幕时，可通过手腕手势快速地与应用进行单手互动。

例如，用户可以用一只手滚动浏览通知，同时用另一只手拿着一杯水。展示手腕手势用途的示例还包括：

在一款慢跑应用中，浏览垂直屏幕，查看所跑的步数、经过的时间以及当前的步速
携带行李在机场时，滚动浏览航班和登机口信息
滚动浏览新闻报道

如需查看手表上的手腕手势，请通过依次选择设置 > 手势 > 手腕手势开启，确认已开启手势。然后，学完手表上的手势教程（依次选择设置 > 手势 > 启动教程）。

应用无法使用 Wear OS 帮助中的以下手势：

晃动手腕

可通过以下方式使用手腕手势：

使用曲线布局，该布局预定义了手势操作
直接使用按键事件定义新的用户操作

每个手腕手势都将映射到 KeyEvent 类中的 int 常量，如下表所示：

手势	KeyEvent	说明
向外翻动手腕	KEYCODE_NAVIGATE_NEXT	此键码用于转到下一项。
向内翻动手腕	KEYCODE_NAVIGATE_PREVIOUS	此键码用于转到上一项。

使用曲线布局支持手腕手势

WearableRecyclerView 类为列表提供一个曲线布局，并自动支持手腕手势。该类针对视图具有焦点时做出的手腕手势预定义了操作。如需了解如何使用 WearableRecyclerView 类，请参阅创建列表。另请参阅最佳做法。

注意：在穿戴式设备支持库中，WearableRecyclerView 类取代了一个相似的已弃用类。

即使使用 WearableRecyclerView，您可能也要使用 KeyEvent 类中的常量。可通过创建 WearableRecyclerView 的子类和重新实现 onKeyDown() 回调来重写预定义的操作。此行为可通过使用 setEnableGestureNavigation(false) 完全停用。另请参阅处理键盘操作。

直接使用按键事件

您可以使用 WearableRecyclerView 之外的按键事件触发新操作，以响应手势事件。重要的是，这些手势事件具有以下特点：

当设备处于活动模式时可识别
传递方式与所有按键事件相同

具体来说，这些事件将传递到顶部 Activity 具有键盘焦点的视图。就像其他任何按键事件一样，与实现 KeyEvent.Callback 的用户互动（如视图或 Activity）相关的类可监听与手腕手势相关的按键事件。Android 框架使用按键事件调用具有焦点的视图或 Activity；对于手势，在做出手势时调用 onKeyDown() 方法回调。

例如，应用可能会替换视图或 Activity（两者都实现 KeyEvent.Callback）中的预定义操作，如下所示：

Kotlin

    class GesturesActivity : Activity() {

        /* KeyEvent.Callback */
        override fun onKeyDown(keyCode: Int, event: KeyEvent): Boolean {
            return when (keyCode) {
                KeyEvent.KEYCODE_NAVIGATE_NEXT ->
                    // Do something that advances a user View to the next item in an ordered list.
                    moveToNextItem()
                KeyEvent.KEYCODE_NAVIGATE_PREVIOUS ->
                    // Do something that advances a user View to the previous item in an ordered list.
                    moveToPreviousItem()
                else -> {
                    // If you did not handle it, let it be handled by the next possible element as deemed
                    // by the Activity.
                    super.onKeyDown(keyCode, event)
                }
            }
        }

        /** Shows the next item in the custom list.  */
        private fun moveToNextItem(): Boolean {
            …
            // Return true if handled successfully, otherwise return false.
            return false
        }

        /** Shows the previous item in the custom list.  */
        private fun moveToPreviousItem(): Boolean {
            …
            // Return true if handled successfully, otherwise return false.
            return false
        }
    }

Java

    public final class GesturesActivity extends Activity {

     @Override /* KeyEvent.Callback */
     public boolean onKeyDown(int keyCode, KeyEvent event) {
      switch (keyCode) {
       case KeyEvent.KEYCODE_NAVIGATE_NEXT:
        // Do something that advances a user View to the next item in an ordered list.
        return moveToNextItem();
       case KeyEvent.KEYCODE_NAVIGATE_PREVIOUS:
        // Do something that advances a user View to the previous item in an ordered list.
        return moveToPreviousItem();
      }
      // If you did not handle it, let it be handled by the next possible element as deemed by the Activity.
      return super.onKeyDown(keyCode, event);
     }

     /** Shows the next item in the custom list. */
     private boolean moveToNextItem() {
      boolean handled = false;
      …
      // Return true if handled successfully, otherwise return false.
      return handled;
     }

     /** Shows the previous item in the custom list. */
     private boolean moveToPreviousItem() {
      boolean handled = false;
      …
      // Return true if handled successfully, otherwise return false.
      return handled;
     }
    }

最佳做法

查阅 KeyEvent 和 KeyEvent.Callback 页面，了解如何将按键事件传递到您的视图和 Activity。
保持一致的方向功能可见性：
- 使用“向外翻动手腕”手势可转到下一项，使用“向内翻动手腕”手势可转到上一项
为手势提供对等的轻触功能。
提供视觉反馈。
不要使用键码实现与系统其他部分的常理背道而驰的功能。例如，不要使用 KEYCODE_NAVIGATE_NEXT 取消操作，也不要使用翻动姿势导航左-右轴。
不要拦截不属于界面的元素（例如，在屏幕之外或部分被遮盖的视图）上的按键事件。这与其他任何按键事件都一样。
不要将重复的翻动手势重新解释为您自己的新手势。它可能与系统的“晃动手腕”手势冲突。
如需让视图接收手势按键事件，它必须具有焦点；请参阅 View::setFocusable()。由于手势被视为按键事件，因此它们会触发一个转换过程，让系统退出“轻触模式”，这可能会引发意外行为。又因为用户可能会交替使用轻触和手势，所以可能需要使用 View::setFocusableInTouchmode() 方法。在某些情况下，可能还需要使用 setDescendantFocusability(FOCUS_BEFORE_DESCENDANTS)，这样一来，当从其他模式改为“轻触模式”或从“轻触模式”改为其他模式后焦点发生变化时，您的目标视图会获得焦点。
谨慎使用 requestFocus() 和 clearFocus()：
- 调用 requestFocus() 时，请确保视图确实应该具有焦点。如果该视图在屏幕之外或被另一个视图遮盖，那么当手势触发回调时，可能会出现意外情况。
- clearFocus() 将启动焦点搜索，以查找一个合适的视图。根据视图层次结构，此搜索可能需要比较复杂的计算。它最后还可能会将焦点分配给您不希望其接收焦点的视图。
首先将按键事件传递到视图层次结构中具有焦点的视图。如果聚焦的视图不处理该事件（即，返回 false），那么即使父视图可以接收焦点并具有 KeyListener，系统也不会将该事件传递到父视图，而是将该事件传递到容纳具有焦点的视图层次结构的当前 Activity。因此，可能需要在更高的级别捕捉所有事件，然后将相关代码向下传递。或者，您也可以创建 Activity 的子类并替换 dispatchKeyEvent(KeyEvent event) 方法，以确保在必要时拦截相应按键，或对其进行处理（如果未在较低层对其进行处理）。