mirror of
https://gitee.com/zlgopen/awtk.git
synced 2024-12-05 13:38:15 +08:00
213 lines
7.6 KiB
Markdown
213 lines
7.6 KiB
Markdown
# T9 输入法笔记(触屏版)
|
||
|
||
## 1. T9 输入法的中文字典数据
|
||
|
||
网上可以找到 T9 输入法的中文字典数据,但是通常有两个问题:
|
||
|
||
* 采用 GPL 协议,不太适合加入 AWTK。
|
||
|
||
* 只支持单个汉字的输入,不支持词组的输入。
|
||
|
||
经过考虑之后,决定自己生成 T9 输入法的中文字典数据。AWTK 使用了谷歌拼音输入法作为缺省的拼音输入法,谷歌拼音输入法的字典数据质量还是不错的,写一个工具把谷歌拼音输入法的字典数据转换为 T9 输入法的中文字典数据即可。
|
||
|
||
谷歌拼音输入法的字典数据原始格式为:
|
||
|
||
```
|
||
汉字 频率 简体/繁体标志 拼音
|
||
```
|
||
|
||
如:
|
||
|
||
```
|
||
中 243213.912993 0 zhong
|
||
```
|
||
|
||
转换工具要做的事情的是:
|
||
|
||
* 把拼音转换成对应的数字。比 zhong 对应的是 83553。
|
||
|
||
* 生成适合查询的格式。本来想复用谷歌拼音输入的引擎,但是没有成功,最后决定自己写程序来查询。
|
||
|
||
转换工具完整的代码请参考:awtk/tools/t9_gen/to_t9_zh.js
|
||
|
||
> 如果需要对字典进行裁剪,可以先编辑原始数据,然后重新生成数据。
|
||
|
||
## 2. T9 输入法的英文字典数据
|
||
|
||
要生成英文字典数据,获取一个英文单词列表,并且按照单词的使用频率进行排序。找 [github](https://github.com/first20hours/google-10000-english.git) 上找到了这样的数据。
|
||
|
||
同样需要写个小工具,把该数据转成生成适合查询的格式。
|
||
|
||
转换工具完整的代码请参考:awtk/tools/t9_gen/to_t9_en.js
|
||
|
||
> 该工具应该同样适用于其它西文语言。
|
||
|
||
## 3. 对键盘、输入法框架和编辑器进行改进
|
||
|
||
为了支持 T9 输入法,需要对键盘、输入法框架和编辑器进行改进。
|
||
|
||
> 随便提一下,SOLID 原则中的开闭原则通常只存在于理想(简单)情况下,一种切实可行的方法是,在早期设计时要考虑将来的扩展,但也无需过度设计,而是每次扩展时都对框架进行完善,让它更适应于将来的扩展。
|
||
|
||
### 3.1 支持语言切换
|
||
|
||
同样是在中文环境下,你可能需要输入中文,也可能需要输入英文。在中文键盘下输入中文,在英文键盘下输入英文。 在键盘切换时需要让输入法引擎知道当前的语言。
|
||
|
||
#### 3.1.1 键盘
|
||
|
||
如果需要切换语言,可以给键盘的页面设置一个 lang 属性,用于标识改键盘的语言,切换到该页面时,自动设置输入法引擎的语言。
|
||
|
||
如:
|
||
|
||
```xml
|
||
<view name="chinese" lang="zh_cn"
|
||
x="0" y="0" w="100%" h="100%" children_layout="default(r=4,c=4,s=2,m=2)">
|
||
<button repeat="300" name="," text=","/>
|
||
<button repeat="300" name="key:1" text="ABC"/>
|
||
<button repeat="300" name="key:2" text="DEF"/>
|
||
<button repeat="300" name="key:backspace" style="highlight">
|
||
<image draw_type="icon" image="backspace" x="center" y="middle" w="100%" h="100%"/>
|
||
</button>
|
||
<button repeat="300" name="key:3" text="GHI"/>
|
||
<button repeat="300" name="key:4" text="JKL"/>
|
||
<button repeat="300" name="key:5" text="MNO"/>
|
||
<button name="page:lower" style="highlight" text="abc"/>
|
||
|
||
<button repeat="300" name="key:6" text="PQRS"/>
|
||
<button repeat="300" name="key:7" text="TUV"/>
|
||
<button repeat="300" name="key:8" text="WXYZ"/>
|
||
<button name="page:symbols" style="highlight" text="#+="/>
|
||
<button repeat="300" name="opt:。?!" text="。?!"/>
|
||
<button repeat="300" name="space" text="Space"/>
|
||
<button name="action" style="highlight" text="Return"/>
|
||
<button name="page:number" style="highlight" text="123"/>
|
||
</view>
|
||
```
|
||
|
||
在切换键盘时,如果存在 lang 属性,将其设置到输入法。
|
||
|
||
```c
|
||
value_t v;
|
||
widget_t* active = widget_get_child(iter, widget_get_value(iter));
|
||
|
||
if (widget_get_prop(active, WIDGET_PROP_IM_LANG, &v) == RET_OK) {
|
||
input_method_set_lang(input_method(), value_str(&v));
|
||
}
|
||
```
|
||
|
||
#### 3.1.2 输入法提供设置语言的函数
|
||
|
||
```c
|
||
/**
|
||
* @method input_method_set_lang
|
||
* 设置语言。
|
||
*
|
||
* > 有的输入法,同时支持输入多种语言。
|
||
* > 比如 T9,可以同时支持中文和英文输入,配合软键盘随时切换输入的语言。
|
||
*
|
||
* @annotation ["scriptable"]
|
||
* @param {input_method_t*} im 输入法对象。
|
||
* @param {const char*} lang 语言。
|
||
*
|
||
* @return {ret_t} 返回 RET_OK 表示成功,否则表示失败。
|
||
*/
|
||
ret_t input_method_set_lang(input_method_t* im, const char* lang);
|
||
```
|
||
|
||
#### 3.1.3 输入法引擎提供设置语言的函数
|
||
|
||
```c
|
||
/**
|
||
* @engine input_engine_set_lang
|
||
* 设置语言。
|
||
* @annotation ["scriptable"]
|
||
* @param {input_engine_t*} engine 输入法引擎对象。
|
||
* @param {const char*} lang 语言。
|
||
*
|
||
* @return {ret_t} 返回 RET_OK 表示成功,否则表示失败。
|
||
*/
|
||
ret_t input_engine_set_lang(input_engine_t* engine, const char* lang);
|
||
|
||
```
|
||
|
||
### 3.2 支持预编辑状态 (preedit)
|
||
|
||
预编辑状态是在文本真正提交到编辑器之前的状态,在预编辑状态下输入的文本,可以被后面的输入覆盖。比如软键盘上,一个按键有 ABC 三个字符,按一下输入 A,再按一下输入 B,继续按钮输入 C,在指定时间内没有按,则提交当前的字符到编辑器。
|
||
|
||
![](images/t9_1.gif)
|
||
|
||
#### 3.2.1 软键盘
|
||
|
||
键盘的按钮名称以"opt:"开头的按钮,表示这个按钮需要预编辑处理。为了支持预编辑输入,软键盘在按钮事件处理函数中,要做下列处理:
|
||
|
||
* 当前不在预编辑状态时,则进入预编辑状态,并启动定时器,把当前字符的序数设置为 0,并提交字符到编辑器。
|
||
|
||
* 当前在预编辑状态,更新定时器,把字符的序数设置为下一个,并提交字符到编辑器。
|
||
|
||
* 定时器超时或点击其它按钮,退出预编辑。
|
||
|
||
> 详情参考函数:keyboard\_on\_button\_click
|
||
|
||
#### 3.2.2 输入法
|
||
|
||
输入法需要提供几个函数用于中转消息:
|
||
|
||
```c
|
||
/**
|
||
* @method input_method_dispatch_preedit
|
||
* 分发进入预编辑状态的事件。
|
||
* @annotation ["scriptable"]
|
||
* @param {input_method_t*} im 输入法对象。
|
||
*
|
||
* @return {ret_t} 返回 RET_OK 表示成功,否则表示失败。
|
||
*/
|
||
ret_t input_method_dispatch_preedit(input_method_t* im);
|
||
|
||
/**
|
||
* @method input_method_dispatch_preedit_confirm
|
||
* 分发确认预编辑状态的事件(提交预编辑内容,退出预编辑状态)。
|
||
* @annotation ["scriptable"]
|
||
* @param {input_method_t*} im 输入法对象。
|
||
*
|
||
* @return {ret_t} 返回 RET_OK 表示成功,否则表示失败。
|
||
*/
|
||
ret_t input_method_dispatch_preedit_confirm(input_method_t* im);
|
||
|
||
/**
|
||
* @method input_method_dispatch_preedit_abort
|
||
* 分发取消预编辑状态的事件(提交预编辑内容,退出预编辑状态)。
|
||
* @annotation ["scriptable"]
|
||
* @param {input_method_t*} im 输入法对象。
|
||
*
|
||
* @return {ret_t} 返回 RET_OK 表示成功,否则表示失败。
|
||
*/
|
||
ret_t input_method_dispatch_preedit_abort(input_method_t* im);
|
||
|
||
```
|
||
|
||
#### 3.2.3 编辑器
|
||
|
||
编辑器需要处理相关事件:
|
||
|
||
```c
|
||
case EVT_IM_PREEDIT: {
|
||
text_edit_preedit(edit->model);
|
||
break;
|
||
}
|
||
case EVT_IM_PREEDIT_CONFIRM: {
|
||
text_edit_preedit_confirm(edit->model);
|
||
break;
|
||
}
|
||
case EVT_IM_PREEDIT_ABORT: {
|
||
text_edit_preedit_abort(edit->model);
|
||
break;
|
||
}
|
||
```
|
||
|
||
>具体请参考:edit.c/mledit.c
|
||
|
||
## 4. T9 输入法引擎的实现
|
||
|
||
T9 输入法引擎的实现很简单,不到 300 行代码。查找算法为:先精确查找,如果找到,将其添加到候选字列表中,否则使用前缀查找,在满足前缀的候选字中,挑选词频最高的,放到候选字列表中。
|
||
|
||
> 详情参考:input_engine_t9.c/t9.c
|