旋转输入

某些 Wear OS 设备包含一个实体旋转侧按钮。当用户转动该按钮时,它会使您应用的当前视图上下滚动。这种输入类型称为旋转输入

注意:本指南主要介绍如何使用基于 View 的 UI 处理旋转输入。有关如何使用适用于 Wear OS 的 Compose 处理旋转输入的更多信息,请参阅Compose 上的旋转输入

许多可滚动容器(例如 ScrollViewListViewHorizontalScrollViewWearableRecyclerView)在具有焦点时支持旋转输入,无需任何 Wear OS 特定代码。具有焦点是一个重要先决条件,因为在 Android 9(API 级别 28)及更高版本中,视图不会隐式接收焦点。

焦点最佳实践

要响应旋转输入事件,可滚动容器必须具有焦点。旋转输入事件不会冒泡到视图层次结构中。如果没有焦点视图,或者焦点视图从 View.onGenericMotionEvent() 返回 false,则事件会发送到 Activity.onGenericMotionEvent()

以下是响应旋转输入事件的最佳实践:

  • 请注意,默认情况下,启动 Activity 甚至点按视图都不会使其获得焦点,即使它可获得焦点也是如此。要使您的视图获得焦点,视图必须使用 <requestFocus /> 标记或手动调用 View.requestFocus()
  • 使用 android:focusable="true"android:focusableInTouchMode="true" 将自定义可滚动视图标记为可获得焦点。
  • 如果您的可滚动视图在 Activity.onCreate() 之后附加(例如,等待网络请求完成再构建您的 UI),请在附加后调用 requestFocus()
  • 如果您的可滚动视图最初为 INVISIBLEGONE,请在将其设置为 VISIBLE 时调用 requestFocus()
  • 如果您的 Activity 包含多个可滚动视图,请使用 <requestFocus /> 标记选择一个视图作为焦点。旋转侧按钮不支持嵌套滚动。
  • 如果您的 UI 包含其他在用户与其互动时获得焦点的视图(例如 InputText),请通过监听可滚动视图上的点按并相应地调用 requestFocus(),为用户提供一种在可滚动视图失去焦点时恢复焦点的方法。

自定义旋转行为

如果您的可滚动视图本身不支持旋转输入滚动,或者您想将旋转输入用于滚动以外的其他目的(例如放大和缩小或转动刻度盘),您可以自行处理滚动事件。请记住,确保您的视图获得焦点,否则事件将无法传递。

以下代码段展示了如何使用 MotionEventInputDeviceCompatViewConfigurationCompat 为您的视图添加自定义滚动:

Kotlin

myView.setOnGenericMotionListener { v, ev ->
  if (ev.action == MotionEvent.ACTION_SCROLL &&
      ev.isFromSource(InputDeviceCompat.SOURCE_ROTARY_ENCODER)
  ) {
    // Don't forget the negation here
    val delta = -ev.getAxisValue(MotionEventCompat.AXIS_SCROLL) *
        ViewConfigurationCompat.getScaledVerticalScrollFactor(
             ViewConfiguration.get(context), context
        )
    // Swap these axes to scroll horizontally instead
    v.scrollBy(0, delta.roundToInt())
    true
  } else {
    false
  }
}

Java

myView.setOnGenericMotionListener(new View.OnGenericMotionListener() {
  @Override
  public boolean onGenericMotion(View v, MotionEvent ev) {
    if (ev.getAction() == MotionEvent.ACTION_SCROLL &&
        ev.isFromSource(InputDeviceCompat.SOURCE_ROTARY_ENCODER)
    ) {
      // Don't forget the negation here
      float delta = -ev.getAxisValue(MotionEventCompat.AXIS_SCROLL) *
          ViewConfigurationCompat.getScaledVerticalScrollFactor(
               ViewConfiguration.get(context), context
          );

      // Swap these axes to scroll horizontally instead
      v.scrollBy(0, Math.round(delta));

      return true;
    }
    return false;
  }
});

使用模拟器测试

使用 Android 模拟器来模拟 Wear 设备上的旋转输入滚动。在模拟器上启动您的 Wear 应用以运行项目,或者将 APK 文件拖到模拟器上进行安装。

如需在模拟器上测试旋转输入:

  1. SDK 管理器中,使用SDK 工具标签页获取 Android 模拟器 26.0.3 或更高版本。
  2. 在 Android Studio 中,依次选择工具 > Android > AVD Manager创建一个新的 Wear 设备,API 级别为 25 或更高。
  3. 从 Android Studio 运行模拟器.
  4. 点击模拟器工具栏底部的三点溢出菜单。在新窗口中点击旋转输入标签页,打开旋转输入界面并尝试旋转输入滚动。

以下视频展示了模拟器中的旋转输入: