输入法扩展编指南.docVIP

API 开发指南 新增功能 输入法扩展API支持转换器扩展，在用户开启转换器时，可以对候选项做诸如装饰、特效、变换等操作。 新增一组用于UNICODE编码转换的字符串实用函数。 入门 为了帮助开发者在谷歌拼音输入法的基本输入功能基础上，开发和定义更丰富的扩展输入功能，谷歌拼音输入法提供了以Lua脚本编程语言为基础的输入法扩展API。利用输入法扩展API，开发者可以编写自定义的输入功能，并将脚本分享给谷歌拼音输入法的用户安装、使用。 一段简单的Lua脚本程序就可以构成一个最基本的输入法扩展模块。下面是“Hello,World!”程序示例： helloworld.lua function HelloWorld() return Hello,World! end ime.register_command(hw, HelloWorld, test) 这一段代码由一个自定义的Lua函数和一行ime.register_command函数调用组成。自定义的Lua函数HelloWorld()简单地返回一个Lua字符串Hello,World!，这表明该输入法扩展函数被调用后，显示给最终用户的候选项为Hello,World!。ime.register_command函数调用将自定义函数注册为谷歌拼音输入法的一个命令扩展。其中，第一个参数hw表示该命令扩展在i扩展模式中对应的命令是hw，第二个参数表示该命令扩展对应的入口函数（自定义的Lua函数）是HelloWorld，第三个参数是显示在i扩展模式命令列表内的简短说明文字。 使用任何文本编辑器输入上述程序后，以helloworld.lua为文件名保存到安装有谷歌拼音输入法的计算机中。然后，打开谷歌拼音输入法选项设置窗口，在扩展页面中，点击安装扩展包按钮，选择保存在计算机内的helloworld.lua（也可以从Windows资源管理器，右键单击helloworld.lua文件，选择“安装到谷歌拼音输入法”）。安装后，打开记事本程序，切换到谷歌拼音输入法，键入ihw，谷歌拼音输入法的候选项窗口中将出现唯一候选项Hello,World!。 除了显式用ihw这样的命令来激活扩展函数以外，扩展函数还可以由用户在使用拼音输入法时输入的特定内容或特定候选词激活。例如，在上述helloworld.lua最后添加一行： ime.register_trigger(HelloWorld, test, { hello }, {}) 这一行的作用是将函数HelloWorld注册为谷歌拼音输入法的一个整合扩展。第一个参数是扩展对应的入口函数HelloWorld，第二个参数是简短说明文字，第三个参数给出希望将扩展关联到哪个或哪几个用户输入串（这里是字符串hello），第四个参数给出希望将扩展关联到哪个或哪几个特定的候选词（这里是空表，表示不关联）。 打开谷歌拼音输入法选项设置窗口，在扩展页面中，使用移除扩展包按钮将刚才安装的helloworld.lua删除，然后重新安装更新后的helloworld.lua。打开记事本程序，切换到谷歌拼音输入法，键入hello，谷歌拼音输入法的候选项窗口中，除了出现通常的中文英文候选词提示外，还将出现由整合扩展函数返回的候选项Hello,World!。 事实上，谷歌拼音输入法提供的输入法扩展API可以用来开发各种不同的输入体验，例如，根据用户输入的参数返回相应的信息内容，查表输入特定的文字信息，完成自定义的甚至包含随机变量的计算并以不同形式返回结果，将用户刚刚输入的文字内容转换为另一种表现形式，等等。谷歌拼音输入法提供的i模式的缺省功能，包括时间和日期格式转换，查星座，掷骰子，打印字符等，都是一些最简单的示例。 本指南的后续内容详细介绍了开发输入法扩展所需要的各种知识。我们也鼓励开发者直接参考已有的示例程序。例如，i扩展模式的缺省功能是由安装在以下位置的Lua脚本程序实现的： XP: C:\Documents and Settings\All Users\Application Data\Google\Google Pinyin 2\Extensions\base.lua Vista / Windows 7: C:\ProgramData\Google\Google Pinyin 2\Extensions\base.lua 三种不同的扩展方式[回页首] 谷歌拼音输入法扩展API提供了三种扩展拼音输入法的方式：命令扩展、整合扩展与转换器扩展。 命令扩展：将脚本程序中的某个入口函数关联到一个两字母长的自定义命令。当用户先键入i然后键入该命令时，输入法即激活该扩展函数，然后在候选项列表中显示扩展函数返回的候选项结果。 命令扩展适用于那些用户明确希望在特定场景下使用特定输入功能，且候