Android Framework系列之IMF（二）

InputConnection是IMF裡面一個重要的接口，他是實現BaseInputConnection和InputConnectionWrapper 上層的接口。主要用於應用程序和InputMethod之間通信的通道，包括實現讀取關標周圍的輸入，向文本框中輸入文本以及給應用程序發送各種按鍵事件。

 

1. InputConnection ic = getCurrentInputConnection();   //獲取InputConnection接口   
2.   
3. if (ic != null){   
4.     ic.beginBatchEdit();    //開始輸入編輯操作                     
5.     if (isShifted()) {   
6.         text = text.toString().toUpperCase();   
7.     }                      
8.     ic.commitText(text, 1); //將text字符輸入文本框，並且將關標移至字符做插入態   
9.     ic.endBatchEdit();  //完成編輯輸入   
10. }          

 接口InputMethod是上節說到的AbstractInputMethodService和InputMethodService的上層接口，它可以產生各種按鍵事件和各種字符文本。

 

所有的IME客戶端都要綁定BIND_INPUT_METHOD，這是IMF出於對安全的角度的考量，對使用InputMethodService的一個所有客戶端的強制要求。否則系統會拒絕此客戶端使用InputMethod。

 

1. <service android:name="IME"  
2.         android:label="@string/SoftkeyIME"  
3.         android:permission="android.permission.BIND_INPUT_METHOD">  

 

在這個接口中有

bindInput(InputBinding binding) 綁定一個一個應用至輸入法；

createSession(InputMethod.SessionCallback callback) 創建一個新的InputMethodSession用於客戶端與輸入法的交互；

startInput(InputConnection inputConnection, EditorInfo info) 輸入法准備就緒開始接受各種事件並且將輸入的文本返回給應用程序；

unbindInput() 取消應用程序和輸入法的綁定；

showSoftInput(int flags, ResultReceiver resultReceiver) 和hideSoftInput(int flags, ResultReceiver resultReceiver) 顧名思義是顯示和隱藏軟鍵盤輸入。

 

InputMethodSession是一個可以安全暴露給應用程序使用的接口，他需要由InputMethodService和InputMethodSessionImpl 實現。

以下是一段在Framework中取到的代碼，可以比較全面的反應這個接口的使用：

  final InputMethodSession mInputMethodSession;     public void executeMessage(Message msg) {   

1.         switch (msg.what) {   
2.             case DO_FINISH_INPUT:   
3.                 mInputMethodSession.finishInput();  //應用程序停止接收字符   
4.                 return;   
5.             case DO_DISPLAY_COMPLETIONS:   
6.                 mInputMethodSession.displayCompletions((CompletionInfo[])msg.obj);  //輸入法自動完成功能   
7.                 return;   
8.             case DO_UPDATE_EXTRACTED_TEXT:   
9.                 mInputMethodSession.updateExtractedText(msg.arg1,   
10.                         (ExtractedText)msg.obj);   
11.                 return;   
12.             case DO_DISPATCH_KEY_EVENT: {   
13.                 HandlerCaller.SomeArgs args = (HandlerCaller.SomeArgs)msg.obj;   
14.                 mInputMethodSession.dispatchKeyEvent(msg.arg1,   
15.                         (KeyEvent)args.arg1,   
16.                         new InputMethodEventCallbackWrapper(   
17.                                 (IInputMethodCallback)args.arg2));  //處理按鍵   
18.                 mCaller.recycleArgs(args);   
19.                 return;   
20.             }   
21.             case DO_DISPATCH_TRACKBALL_EVENT: {   
22.                 HandlerCaller.SomeArgs args = (HandlerCaller.SomeArgs)msg.obj;   
23.                 mInputMethodSession.dispatchTrackballEvent(msg.arg1,   
24.                         (MotionEvent)args.arg1,   
25.                         new InputMethodEventCallbackWrapper(   
26.                                 (IInputMethodCallback)args.arg2));    
27.                 mCaller.recycleArgs(args);   
28.                 return;   
29.             }   
30.             case DO_UPDATE_SELECTION: {   
31.                 HandlerCaller.SomeArgs args = (HandlerCaller.SomeArgs)msg.obj;   
32.                 mInputMethodSession.updateSelection(args.argi1, args.argi2,   
33.                         args.argi3, args.argi4, args.argi5, args.argi6); //更新選取的字符   
34.                 mCaller.recycleArgs(args);   
35.                 return;   
36.             }   
37.             case DO_UPDATE_CURSOR: {   
38.                 mInputMethodSession.updateCursor((Rect)msg.obj); //更新關標   
39.                 return;   
40.             }   
41.             case DO_APP_PRIVATE_COMMAND: {   
42.                 HandlerCaller.SomeArgs args = (HandlerCaller.SomeArgs)msg.obj;   
43.                 mInputMethodSession.appPrivateCommand((String)args.arg1,   
44.                         (Bundle)args.arg2); //處理應用程序發給輸入法的命令   
45.                 mCaller.recycleArgs(args);   
46.                 return;   
47.             }   
48.             case DO_TOGGLE_SOFT_INPUT: {   
49.                 mInputMethodSession.toggleSoftInput(msg.arg1, msg.arg2); //切換軟鍵盤   
50.                 return;   
51.             }   
52.         }   
53.         Log.w(TAG, "Unhandled message code: " + msg.what);   
54.     }