在 Wear 设备上创建输入法编辑器

Wear OS 通过扩展 Android 输入法编辑器 (IME) 框架来支持语音以外的输入方法。IME 框架支持虚拟屏幕键盘，允许用户通过按键、手写或手势输入文本。

Wear OS 用户可以从远程输入 (Remote Input) 中选择各种输入选项。这些选项包括

  • 听写
  • 表情符号
  • 预设回复
  • 智能回复
  • 默认 IME

为 Wear 设备创建输入法

Android 平台为创建 IME 提供了标准框架。要创建 Wear OS 专属 IME，您需要针对可穿戴设备的有限屏幕尺寸优化您的 IME。

Wear OS 专属 IME 过滤条件

要了解如何为 Wear OS 创建输入法，请按照手机上创建输入法的指南进行操作。然后将以下部分中的 Google Play 过滤条件添加到您的清单文件中，使其成为 Wear OS 专属 IME。

API 级别

如果您正在为 Wear OS 开发 IME，请记住此功能仅在 Android 6.0 (API 级别 23) 及更高版本上受支持。为了确保您的 IME 只能安装在支持语音以外输入方法的可穿戴设备上，请将以下内容添加到您的应用清单中

<uses-sdk android:minSdkVersion="23" />

设备功能集

为了控制您的应用如何从不支持 Wear OS IME 的设备（例如 iPhone）中过滤，请将以下内容添加到您的应用清单中

<uses-feature android:required="true" android:name="android.hardware.type.watch" />

调用输入法

Wear OS 在手表上提供用户设置，允许用户从已安装 IME 列表中启用多个 IME。用户启用您的 IME 后，可以从以下位置调用您的 IME

  • 使用 RemoteInput API 的通知或应用。
  • 带有 EditText 字段的 Wear OS 应用。轻触文本字段会将光标置于该字段中，并在获得焦点时自动显示 IME。

通用 IME 注意事项

在为 Wear 设备实现 IME 时，需要考虑以下几点

  • 设置默认操作。

    RemoteInput 和 Wear OS 应用只支持单行文本输入。始终使用 Enter 键触发对 sendDefaultEditorAction 的调用，这会使应用关闭键盘并继续执行下一步或操作。

  • 使用全屏模式 IME。

    Wear OS 上的输入法会覆盖大部分屏幕，只留下很少的应用可见。无论应用 UI 如何，使用全屏模式都能提供最佳用户体验。在全屏模式下，ExtractedText 提供正在编辑的文本字段的镜像视图，并且可以进行样式设置以与输入法 UI 的其余部分融合。有关全屏模式的更多详细信息，请参阅 InputMethodService。

  • 处理 InputType 标志。

    至少，出于隐私原因，在您的 IME 中处理 InputType 标志 TYPE_TEXT_VARIATION_PASSWORD。当您的 IME 处于密码模式时，请确保您的键盘针对单次按键进行了优化，这意味着自动拼写更正、自动完成和手势输入都被禁用。最重要的是，密码模式下的键盘必须支持美国信息交换标准码 (ASCII) 符号，无论输入语言如何。有关更多详细信息，请参阅指定输入法类型。

  • 提供用于切换到下一个输入法的键。

    Android 允许用户在平台支持的所有 IME 之间切换。在您的 IME 实现中，将布尔值 supportsSwitchingToNextInputMethod 设置为 true。这使得您的 IME 支持切换机制，以便应用可以切换到下一个平台支持的 IME。要了解有关如何在 IME 之间切换的更多信息，请参阅在 IME 子类型之间切换。