输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
指南

输入法子类型开发指南

更新时间: 2026-09-09 06:54
本文导读

输入法子类型允许输入法展现不同的输入模式或语言，用户可以根据需要在不同模式和语言中切换。如输入法的中文键盘、英文键盘等，都属于输入法的子类型。

输入法子类型的配置与实现

  1. 输入法应用开发者只需要注册实现一个InputMethodExtensionAbility，所有的输入法子类型共用该InputMethodExtensionAbility，在module.json5配置文件中添加metadata，name为ohos.extension.input_method，用于配置所有子类型的资源信息。

    收起
    自动换行
    深色代码主题
    复制
    1. "extensionAbilities": [
    2.   {
    3.     "srcEntry": "./ets/InputMethodExtensionAbility/InputMethodService.ets",
    4.     "name": "InputMethodService",
    5.     "label": "$string:MainAbility_label",
    6.     "description": "$string:extension_ability_descriptor",
    7.     "type": "inputMethod",
    8.     "exported": true,
    9.     "metadata": [
    10.       {
    11.         "name": "ohos.extension.input_method",
    12.         "resource": "$profile:input_method_config"
    13.       }
    14.     ]
    15.   }
    16. ],
    module.json5

  2. 子类型配置文件input_method_config.json需要放在应用资源目录的profile文件夹中，格式如下，字段释义参照InputMethodSubtype；开发者需要严格按照配置文件格式及字段进行子类型信息配置，locale字段的配置参照i18n-locale-culture。

    收起
    自动换行
    深色代码主题
    复制
    1. {
    2.   "subtypes": [
    3.     {
    4.       "icon": "$media:icon",
    5.       "id": "InputMethodExtAbility",
    6.       "label": "$string:english",
    7.       "locale": "en-US",
    8.       "mode": "lower"
    9.     },
    10.     {
    11.       "icon": "$media:icon",
    12.       "id": "InputMethodExtAbility1",
    13.       "label": "$string:chinese",
    14.       "locale": "zh-CN",
    15.       "mode": "lower"
    16.     }
    17.   ]
    18. }

  3. 输入法应用中监听子类型事件，根据不同的子类型，可以加载不同的软键盘界面，或者通过状态变量控制软键盘显示效果。

    收起
    自动换行
    深色代码主题
    复制
    1. // 设置监听子类型事件，改变输入法应用界面
    2. inputMethodAbility.on('setSubtype', (inputMethodSubtype: InputMethodSubtype) => {
    3.   if (inputMethodSubtype.id === 'InputMethodExtAbility') {
    4.     AppStorage.setOrCreate('subtypeChange', CustomInputMethodSubtype.english);
    5.   }
    6.   if (inputMethodSubtype.id === 'InputMethodExtAbility1') {
    7.     AppStorage.setOrCreate('subtypeChange', CustomInputMethodSubtype.chinese);
    8.   }
    9. });
    KeyboardController.ets

输入法子类型相关信息的获取

  1. 开发者可以通过调用getCurrentInputMethodSubtype获取当前输入法应用的当前子类型。

  2. 开发者可以通过调用listCurrentInputMethodSubtype获取当前输入法应用的所有子类型。

  3. 开发者可以通过调用listInputMethodSubtype获取指定输入法应用的所有子类型。

输入法子类型的切换

  1. 开发者可以通过调用switchCurrentInputMethodSubtype切换当前输入法应用的子类型。

  2. 开发者可以通过调用switchCurrentInputMethodAndSubtype切换至指定输入法应用的指定子类型。

相关推荐
文档切换输入法应用
文档@ohos.InputMethodSubtype (输入法子类型)
文档@ohos.inputMethodList (输入法切换列表控件)
文档@ohos.inputMethod.ExtraConfig (输入法扩展信息)
文档@ohos.inputMethodEngine (输入法服务)
文档@ohos.inputMethod.Panel (输入法面板)
文档input开发指导
文档@ohos.inputMethod (输入法框架)
文档InputMethod_TextConfig
文档inputmethod_inputmethod_proxy_capi.h
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 指南 中进行搜索
请输入您想要搜索的关键词