某些 Wear OS 设备包含一个实体旋转侧按钮。当用户转动该按钮时,它会使您应用的当前视图上下滚动。这种输入类型称为旋转输入。
注意:本指南主要介绍如何使用基于 View 的 UI 处理旋转输入。有关如何使用适用于 Wear OS 的 Compose 处理旋转输入的更多信息,请参阅Compose 上的旋转输入。
许多可滚动容器(例如 ScrollView
、ListView
、HorizontalScrollView
和 WearableRecyclerView
)在具有焦点时支持旋转输入,无需任何 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()
。 - 如果您的可滚动视图最初为
INVISIBLE
或GONE
,请在将其设置为VISIBLE
时调用requestFocus()
。 - 如果您的 Activity 包含多个可滚动视图,请使用
<requestFocus />
标记选择一个视图作为焦点。旋转侧按钮不支持嵌套滚动。 - 如果您的 UI 包含其他在用户与其互动时获得焦点的视图(例如
InputText
),请通过监听可滚动视图上的点按并相应地调用requestFocus()
,为用户提供一种在可滚动视图失去焦点时恢复焦点的方法。
自定义旋转行为
如果您的可滚动视图本身不支持旋转输入滚动,或者您想将旋转输入用于滚动以外的其他目的(例如放大和缩小或转动刻度盘),您可以自行处理滚动事件。请记住,确保您的视图获得焦点,否则事件将无法传递。
以下代码段展示了如何使用 MotionEvent
、InputDeviceCompat
和 ViewConfigurationCompat
为您的视图添加自定义滚动:
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 文件拖到模拟器上进行安装。
如需在模拟器上测试旋转输入:
- 在 SDK 管理器中,使用SDK 工具标签页获取 Android 模拟器 26.0.3 或更高版本。
- 在 Android Studio 中,依次选择工具 > Android > AVD Manager。创建一个新的 Wear 设备,API 级别为 25 或更高。
- 从 Android Studio 运行模拟器.
- 点击模拟器工具栏底部的三点溢出菜单。在新窗口中点击旋转输入标签页,打开旋转输入界面并尝试旋转输入滚动。
以下视频展示了模拟器中的旋转输入: