android IME/軟鍵盤調用淺談I–IME解析

最近在android NDK開發遇到了一個麻煩問題：在底層通過opengl繪製輸入介面，但沒辦法調用IME(IME)，只能往上調用，通過jni通知java層調用IME。

而對java層的需求就是只彈出IME，把IME鍵盤的按鍵事件和輸入內容直接往底層傳遞。看似簡單的需求，卻讓我瞎轉了幾天。

這裡把我碰到的問題和解決方案進行總結。

1.調用IME的方法

InputMethodManager input = (InputMethodManager)mApp.getSystemService(Context.INPUT_METHOD_SERVICE);input.toggleSoftInput(InputMethodManager.SHOW_FORCED, InputMethodManager.HIDE_NOT_ALWAYS);

input.toggleSoftInput()如果IME已經開啟則隱藏它，如果是隱藏的則顯示它。也可直接調用input的show()或者hide()方法直接顯示或隱藏。

註：測試結果顯示，系統IME始終處於開啟狀態，只能隱藏它，不能關閉。

2.必須為IME提供一個View或者EditText對象用於接收輸入內容

在View或者EditText中調用Input.toggleSoftInput()方法，或者Input.showSoftInput(view, flags)把View或者EditText作為參數傳遞進去來開啟軟鍵盤，IME會把輸入內容傳遞到指定的對象中。

EditText可以通過getText()直接擷取輸入內容；

View則需要實現以下方法

    public InputConnection onCreateInputConnection(EditorInfo outAttrs) {        return new MyInputConnection(this, false);     }

並建立繼承BaseInputConnection的類

    class MyInputConnection extends BaseInputConnection{        public MyInputConnection(View targetView, boolean fullEditor) {             super(targetView, fullEditor);        }                public boolean commitText(CharSequence text, int newCursorPosition) {            Log.i("ime", "input text:" + text);            return true;         }                public boolean sendKeyEvent(KeyEvent event) {        Log.i("ime", "sendKeyEvent()" + event.getKeyCode());        return true;        }    }

通過InputConnection建立於輸入的聯絡，一旦有輸入內容IME會調用commText把內容傳遞進來；

其中還有另外一個重要的方法是sendKeyEvent()。點擊軟鍵盤的enter和backspace按鍵事件並沒有傳遞到commText，而是將事件傳遞到sendKeyEvent(),通過這個方法可以自訂地處理該事件。

3.軟鍵盤樣式、屬性設定

EditText API中有許多方法可直接調用來設定軟體盤的屬性，詳細見android api文檔，這裡不再贅述。View則需要在OnCreateInputConnection(EditorInfo outAttrs)方法，通過outAttrs屬性進行設定。

    public InputConnection onCreateInputConnection(EditorInfo outAttrs) {    outAttrs.imeOptions = EditorInfo.IME_FLAG_NO_EXTRACT_UI;//    outAttrs.inputType = EditorInfo.TYPE_TEXT_VARIATION_PASSWORD;//    outAttrs.imeOptions = EditorInfo.IME_ACTION_DONE;        return new MyInputConnection(this, false);     }

軟體盤最主要的樣式是全螢幕模式和非全螢幕模式；在豎屏的情況下沒有全螢幕模式，而在橫屏的情況下（尤其是遊戲開發）這兩種模式都用得比較多。

值得注意的是，在橫屏情況下通過View調用IME，如果是非全螢幕模式需要設定outAttrs.imeOptions = EditorInfo.IME_FLAG_NO_EXTRACT_UI，否則會出現軟鍵盤沒有候選欄的情況，導致無法輸入中文，具體原因尚不清楚，如果有瞭解的朋友還請多指教。

/* TODO 持續更新 */