Google 致力于为黑人社区推动种族平等。查看具体举措

Wear 上的旋转输入

某些 Wear OS 设备支持旋转输入,如侧面旋钮 (RSB)。当用户旋转旋钮时,应用的当前视图应向上或向下滚动。

如果您在应用中使用 ScrollViewListViewHorizontalScrollViewWearableRecyclerView,那么您的应用视图将默认支持旋转输入。如果您使用上述视图以外的自定义视图,或者您想手动处理旋转输入事件,请参阅添加自定义旋转输入滚动

请参阅以下相关资源:

焦点最佳做法

为响应旋转输入事件,您的滚动视图必须获得焦点。大多数情况下,滚动视图会自动获得焦点。在您创建 Activity 后,您的滚动视图会立即获得焦点。但是,在某些情况下,您需要手动处理应用视图的焦点,例如:

  • 如果您的可滚动视图附加在 Activity.onCreate() 之后(例如,如果您在构建界面之前等待网络请求完成),您必须在附加该视图之后调用 requestFocus
  • 如果您的可滚动视图最初为 INVISIBLEGONE,在将其设置为 VISIBLE 时必须调用 requestFocus
  • 如果您的 Activity 包含多个可滚动视图(例如,如果您使用的是嵌套滚动),您需要从中选择一个要获得焦点的视图(通常通过 <requestFocus /> 标记进行设置)。RSB 滚动目前不支持嵌套滚动。
  • 如果您的界面包含其他某种在用户与它交互时会窃取焦点的视图(这种情况很少见;最常见的示例为 InputText),则您需要为用户提供某种方式,让他们能够在可滚动视图失去焦点后使其重新获得焦点。这通常可通过侦听可滚动视图上的点按操作并在响应中调用 requestFocus 实现。

添加自定义旋转输入滚动

如果您的可滚动视图本身不支持旋转输入滚动,或者您想要执行一些不同于滚动的操作以响应旋转输入事件(例如放大/缩小、旋转表盘等),您可以使用穿戴式设备支持库中的 RotaryEncoder 方法。

以下代码段说明了如何使用 RotaryEncoder 在应用视图中添加自定义滚动:

Kotlin

    myView.setOnGenericMotionListener(View.OnGenericMotionListener { v, ev ->
        if (ev.action == MotionEvent.ACTION_SCROLL && RotaryEncoder.isFromRotaryEncoder(ev)) {
            // Don't forget the negation here
            val delta = -RotaryEncoder.getRotaryAxisValue(ev) *
                    RotaryEncoder.getScaledScrollFactor(context)

            // Swap these axes if you want to do horizontal scrolling instead
            v.scrollBy(0, Math.round(delta))

            return@OnGenericMotionListener true
        }

        false
    })
    

Java

    myView.setOnGenericMotionListener(new View.OnGenericMotionListener() {
        @Override
        public boolean onGenericMotion(View v, MotionEvent ev) {
            if (ev.getAction() == MotionEvent.ACTION_SCROLL && RotaryEncoder.isFromRotaryEncoder(ev)) {
                // Don't forget the negation here
                float delta = -RotaryEncoder.getRotaryAxisValue(ev) * RotaryEncoder.getScaledScrollFactor(
                getContext());

                // Swap these axes if you want to do horizontal scrolling instead
                v.scrollBy(0, Math.round(delta));

                return true;
            }

            return false;
        }
    });
    

在模拟器上测试旋转输入按钮

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

如需在模拟器上测试旋转输入,请执行以下操作:

  1. SDK 管理器中,使用 SDK 工具标签获取 Android 模拟器 26.0.3 或更高版本。
  2. 使用 API 25 创建一个 AVD(Android 虚拟设备)。

    在 Studio 中,依次选择 Tools > Android > AVD Manager。使用 API 25 创建一个新的 Wear 设备

  3. 在 Android Studio 中运行模拟器
  4. 尝试执行旋转输入滚动。

    点击溢出按钮(模拟器工具栏底部的三个点)。点击新窗口中的 Rotary input 标签页以打开旋转输入界面。

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

焦点行为提示

  • 从 Android 9(API 级别 28)开始,视图不再隐式获得焦点,而是必须显式获得焦点。
  • 应使用 android:focusable="true"android:focusableInTouchMode="true" 将可滚动视图注册为可聚焦。
  • 默认情况下,启动 Activity 甚至点按某个视图不会使其聚焦(即使该视图可聚焦)。为了实现此行为,视图必须使用 <requestFocus /> 标记或手动调用 View.requestFocus()
  • 系统只会将旋转输入事件发送到聚焦的视图。这些事件不会在视图层次结构中向上传递。当且仅当没有聚焦的视图或聚焦的视图从 View.onGenericMotionEvent 返回 false 时,系统才会将事件发送到 Activity.onGenericMotionEvent