Skip to content

Latest commit

 

History

History
102 lines (64 loc) · 4.65 KB

input_method.md

File metadata and controls

102 lines (64 loc) · 4.65 KB

输入法

输入法是GUI重要的组件之一,虽然实现起来并不是太复杂,但其涉及的组件比较多,理解起来还是比较困难的,这里介绍一下AWTK中输入法的内部架构。

overview

一、软键盘

在嵌入式系统中,通常没有物理键盘,所以需要在屏幕上实现软键盘。AWTK中的软键盘是一个普通的窗口,其中的按钮和候选字控件,都是用AWTK的UI描述文件定义的,可以方便实现各种不同的软键盘。软键盘的描述文件放在res/raw/ui目录下,文件名以kb_打头。

与普通窗口相比,软键盘有以下不同:

  • 被点击时不会影响原有编辑器的焦点。
  • 不接受按键事件和输入文本事件。

为了实现方便,AWTK中引入了一个keyboard的窗口类,在设计时考虑了下面几个问题:

  • 1.软键盘上有多个页面。有的输入中文,有的输入大写字母,有的输入小写字母,有的输入数字,有的输入符号。

方案: 在软键盘中可以放多个页面,点击切按钮时进行切换。按钮的名字以"page:"开头,即意味着按下该按钮时切换到指定的页面。比如,下面的按钮被点击时就会切换到数字符号键盘:

 <button name="page:symnum" style="1:highlight" w="15%" text="123"/>
  • 2.不同的编辑器需要不同的软键盘。比如输入数值的编辑器得到焦点时,就应该只显示输入数值的软键盘。

方案: 为不同输入类型的编辑器提供不同软键盘,这些软键盘有各自的UI描述文件。输入类型和UI描述文件名之间的对应关系如下:

输入类型 键盘描述文件 说明
INPUT_PHONE kb_phone 电话号码
INPUT_INT kb_int 整数
INPUT_FLOAT kb_float 浮点数
INPUT_UINT kb_uint 非负整数
INPUT_UFLOAT kb_ufloat 非负浮点数
INPUT_HEX kb_hex 16进制
INPUT_EMAIL kb_ascii 邮件地址
INPUT_PASSWORD kb_ascii 密码
其它 kb_default

参考:input_methods/input_method_default.c

  • 3.软键盘上的按钮存在多种功能。有点用于切换软键盘上页面,有的用于输入文本,有的提交按键给输入法引擎进一步处理,有的用于删除最后输入的字符。

方案: 通过按钮的名字决定其功能:

按钮名称 功能说明
space 输入空格
backspace 删除最后输入的字符
key:开头 按键。需要交给输入法引擎进一步处理
page:开头 切换页面
其它 直接提交该文本到编辑器
  • 4.有时需要显示候选字有时不需要。

方案: 提供一个候选字控件,可以根据需要加入到软键盘描述文件中。

参考:res/raw/ui/kb_default.xml

二、输入法接口及实现

AWTK作为一个通用的GUI,需要考虑以下几种情况:

  • 1.不需要输入法。
  • 2.低端嵌入式设备没有资源启用输入法。
  • 3.手机/PC有原生的输入法,不需要AWTK提供一套输入法。
  • 4.在中高端嵌入式设备中,有资源启用输入法而且需要输入法。

针对上面几种情况,AWTK提供了三种不同的实现,可以根据需要加入对应的实现:

input method

  • null实现只是提供了空的实现,不启用输入法和软键盘。
  • sdl实现包装了原生输入法(SDL的实现有些问题,还需要进一步完善)。
  • default提供了自己的实现,负责软键盘的打开关闭和输入法引擎的创建。

三、输入法引擎及实现

输入法引擎主要负责将用户的按键转换成一组候选字(这些候选字将在软键盘上的候选字控件上显示出来)。输入法引擎有很多,不同的语言也有不同的输入法引擎,目前AWTK只提供了拼音输入法(基于google拼音)和一种null的实现,用户可以实现自己的输入法引擎,第三方开发者也可以集成自己的输入法引擎到AWTK中。

四、编辑器

编辑器只需要在得到焦点或失去焦点时,请求输入法打开或关闭输入法即可。

五、联想功能(因为目前没有数据,暂未实现)

联想功能实现比较简单,在用户点击候选字时,根据当前的选择提供一组新的候选字即可。

六、其它

目前AWTK的基本功能可用了,但易用性方面还需持续完善,比如:

  • 软键盘的按钮被点击时需要放大显示。
  • 候选字控件的展开和折叠。
  • 预编辑功能。

由于事情很多,上面的问题对架构影响不大,暂时先放一放。