google 輸入法lua擴(kuò)展編指南

1、API開發(fā)指南新增功能新增功能?輸入法擴(kuò)展API支持轉(zhuǎn)換器擴(kuò)展，在用戶開啟轉(zhuǎn)換器時(shí)，可以對(duì)候選項(xiàng)做諸如裝飾、特效、變換等操作。?新增一組用于UNICODE編碼轉(zhuǎn)換的字符串實(shí)用函數(shù)。入門為了幫助開發(fā)者在谷歌拼音輸入法的基本輸入功能基礎(chǔ)上，開發(fā)和定義更豐富的擴(kuò)展輸入功能，谷歌拼音輸入法提供了以Lua腳本編程語(yǔ)言為基礎(chǔ)的輸入法擴(kuò)展API。利用輸入法擴(kuò)展API，開發(fā)者可以編寫自定義的輸入功能，并將腳本分享給谷歌拼音輸入法的用戶安裝、使用。一段簡(jiǎn)

2、單的Lua腳本程序就可以構(gòu)成一個(gè)最基本的輸入法擴(kuò)展模塊。下面是“HelloWld!”程序示例：hellowld.luafunctionHelloWld()return“HelloWld!“endime.register_comm(“hw““HelloWld““test“)這一段代碼由一個(gè)自定義的Lua函數(shù)和一行ime.register_comm函數(shù)調(diào)用組成。自定義的Lua函數(shù)HelloWld()簡(jiǎn)單地返回一個(gè)Lua字符串“HelloWl

3、d!“，這表明該輸入法擴(kuò)展函數(shù)被調(diào)用后，顯示給最終用戶的候選項(xiàng)為“HelloWld!“。ime.register_comm函數(shù)調(diào)用將自定義函數(shù)注冊(cè)為谷歌拼音輸入法的一個(gè)命令擴(kuò)展。其中，第一個(gè)參數(shù)“hw“表示該命令擴(kuò)展在i擴(kuò)展模式中對(duì)應(yīng)的命令是“hw“，第二個(gè)參數(shù)表示該命令擴(kuò)展對(duì)應(yīng)的入口函數(shù)（自定義的Lua函數(shù)）是“HelloWld“，第三個(gè)參數(shù)是顯示在i擴(kuò)展模式命令列表內(nèi)的簡(jiǎn)短說明文字。使用任何文本編輯器輸入上述程序后，以hellowl

4、d.lua為文件名保存到安裝有谷歌拼音輸入法的計(jì)算機(jī)中。然后，打開谷歌拼音輸入法選項(xiàng)設(shè)置窗口，在“擴(kuò)展“頁(yè)面中，點(diǎn)擊“安裝擴(kuò)展包“按鈕，選擇保存在計(jì)算機(jī)內(nèi)的hellowld.lua（也可以從Windows資源管理器，右鍵單擊hellowld.lua文件，選擇“安裝到谷歌拼音輸入法”）。安裝后，打開記事本程序，切換到谷歌拼音輸入法，鍵入“ihw“，谷歌拼音輸入法的候選項(xiàng)窗口中將出現(xiàn)唯一候選項(xiàng)“HelloWld!“。除了顯式用“ihw“這樣

5、的命令來激活擴(kuò)展函數(shù)以外，擴(kuò)展函數(shù)還可以由用戶在使用拼音輸入法時(shí)輸入的特定內(nèi)容或特定候選詞激活。例如，在上述hellowld.lua最后添加一行：ime.register_trigger(“HelloWld““test““hello“)這一行的作用是將函數(shù)“HelloWld“注冊(cè)為谷歌拼音輸入法的一個(gè)整合擴(kuò)展。第一個(gè)參數(shù)是擴(kuò)展對(duì)應(yīng)的入口函數(shù)“HelloWld“，第二個(gè)參數(shù)是簡(jiǎn)短說明文字，第三個(gè)參數(shù)給出希望將擴(kuò)展關(guān)聯(lián)到哪個(gè)或哪幾個(gè)用戶輸入

6、串（這里是字符串“hello“），第四個(gè)參數(shù)給出希望將擴(kuò)展關(guān)聯(lián)到哪個(gè)或哪幾個(gè)特定的候選詞（這里是空表，表示不關(guān)聯(lián)）。打開谷歌拼音輸入法選項(xiàng)設(shè)置窗口，在“擴(kuò)展“頁(yè)面中，使用“移除擴(kuò)展包“按鈕將剛才安裝的hellowld.lua刪除，然后重新安裝更新后的hellowld.lua。打開記事本程序，切換到谷歌拼音輸入法，鍵入“hello“，谷歌拼音輸入法的候選項(xiàng)窗口中，除了出現(xiàn)通常的中文英文候選詞提示外，還將出現(xiàn)由整合擴(kuò)展函數(shù)返回的候選項(xiàng)“He

7、lloWld!“。擴(kuò)展方式命令擴(kuò)展整合擴(kuò)展轉(zhuǎn)換器擴(kuò)展冊(cè)方式(...)(...)(...)適用范圍用戶明確希望在特定場(chǎng)景下使用特定輸入功能，且候選項(xiàng)較多，或較復(fù)雜的情況在不妨礙用戶正常輸入的情況下，根據(jù)當(dāng)前輸入或候選內(nèi)容，插入少數(shù)相關(guān)候選項(xiàng)的情況為所有候選項(xiàng)增加裝飾、特效，或者對(duì)所有候選項(xiàng)按規(guī)則進(jìn)行變換的情形應(yīng)用實(shí)例根據(jù)輸入的生日查詢星座；列舉并輸入特定的字符畫用戶輸入中文“時(shí)間”時(shí)，在候選項(xiàng)列表里插入當(dāng)前時(shí)間；用戶輸入中文“哈哈”時(shí)，在

8、候選項(xiàng)列表插入相應(yīng)的表情符號(hào)為候選項(xiàng)或候選項(xiàng)的每個(gè)字增加星號(hào)修飾；直接在候選項(xiàng)的每個(gè)字后面輸出該字對(duì)應(yīng)的Unicode編碼；將簡(jiǎn)體漢字變?yōu)榉斌w漢字激活方式用戶輸入i加2字符長(zhǎng)的命令，激活相應(yīng)的命令擴(kuò)展用戶輸入的拼音字符串或輸入法產(chǎn)生的某個(gè)候選項(xiàng)與整合擴(kuò)展關(guān)聯(lián)的特定字符串（可包含通配符）匹配時(shí)，激活相應(yīng)的整合擴(kuò)展用戶從輸入法的用戶界面（如功能菜單）開啟特定的轉(zhuǎn)換器，激活相應(yīng)的轉(zhuǎn)換器擴(kuò)展注冊(cè)命令擴(kuò)展[回頁(yè)首]在Lua腳本中，向谷歌拼音輸入法

9、注冊(cè)一個(gè)命令擴(kuò)展的基本語(yǔ)法是：ime.register_comm(comm_namelua_function_namedeionleadinghelp)ime是提供給Lua腳本使用的，與輸入法內(nèi)核交互的專用模塊。register_comm是向谷歌拼音輸入法注冊(cè)新的i擴(kuò)展模式命令擴(kuò)展所使用的函數(shù)。函數(shù)的各參數(shù)含義如下：?comm_name?o2字符長(zhǎng)的字符串，必須由兩個(gè)英文字母（az）組成。定義了要注冊(cè)的命令名字。如果新注冊(cè)的命令名稱和此