输入法的例子和源代码看了不少时间了,看得头很晕,很郁闷。静下心来把整个代码想了一遍,其实大部分代码都在处理绘制界面,以及事件的处理,核心代码很少,都被底层封装得很完美了。先看看一般输入法的界面:
分为两个部分,上部分是候选窗口(CandidateView),用来显示候选词,现在常用的输入法都有这个功能,如在搜狗、google输入法中输入abc,输入框中就会显示很多相关联的中文词。下部分就是软键盘了,这个没什么好说的。
输入法中核心类是InputMethodService,其次就是:CandidateView和KeyboardView。
CandidateView为候选窗口,InputMethodService在启动过程中会调用接口publicView onCreateCandidatesView(),在这个方法中把CandidateView对象返回后,InputMethodService内部会将其布局到相应的位置。
在android中没有CandidateView父类,得自己从头写,一般的做法是:
通过方法public voidsetService(InputMethodService listener)将Service类传进来,然后再通过publicvoid setSuggestions(List<String> suggestions…)方法将候选词列表传递过来,CandidateView将其显示到界面上,用户选择结束后,再通过service的方法pickSuggestionManually(mSelectedIndex),将选择的候选词在列表中的序号传递回去。至此,CandidateView就完成了它神圣的使命。
android中KeyboardView有一个通用类,继承它可以通过简单的配置文件就显示出很专业软键盘。在源代码中,它绝大部分代码都在做绘制工作和事件处理,不过就其本质功能来说是相当地简单,用户摁下软键盘上的某个键后,它把这个键所代表的值传递给InputMethodService类也完成了它的使命。InputMethodService在public View onCreateInputView()方法中获得该View。
InputMethodService就是输入法的核心了,该类是一个Service,跟其它默默无闻的Service不同的是,它是一个带有View的Service。其内部有几个个重要的接口:InputMethodImpl、InputMethodSessionImpl和InputConnection。
InputMethodService通过这几个类跟系统和输入框进行交互的。
1、输入框从InputMethodService获取信息是通过InputConnection来实现的,在启动输入法时,InputConnection由客户端控件创建,并传递给输入法应用,由输入法应用调用,进行信息反馈。
2、InputMethod接口定义了一套操纵输入法应用的方法。如bindInput、hideInput、startInput等。为了系统安全,这类接口只有系统可以访问,客户端控件无法直接调用这个接口。所有的输入法应用都需要客户端控件具有BIND_INPUT_METHOD权限,作为系统的安全机制,否则将无法与输入法服务交互。
3、InputMethodSession作为InputMethod的辅助接口类,为客户端控件开放了可直接调用的函数接口。包括向输入法应用分发键盘事件,更新光标位置,更新编辑区域内选择的问题信息等。客户端控件通过IIputMethodSession对于输入法应用的交互是单向的,即只能向输入法应用传递信息,无法获取信息。
以上几个点是从网上copy过来的,感觉这几点对于理解InputMethodService特别有用。代码看得太多反而看不清本质,这几个类中最实用的是InputConnection的。
public boolean commitText(CharSequence text, intnewCursorPosition)
通过KeyboardView和CandidateView,InputMethodService类已经获得了想要的内容,然后通过这个方法把值传递给输入框。
先来一个CandidateView,设想的布局如下:
这个View中不进行任何自绘制,用android现有的View,两边各一个按钮(Button),用来滚动多个候选词,中间显示候选词(TextView),为了方便CandidateView继承RelativeLayout的内部类,便于加入子控件和控制,setService和setSuggestions两个方法可以不用,反正是内部类,不过为了配合上面的说明加上:
public class helloIme extends InputMethodService { class CandidateView extends RelativeLayout { TextView tv; // 中间显示候选词 Button btLeft, btRight; // 左右按钮 helloIme listener; // helloIme 用于返回选中的 候选词下标 List<String> suggestions; // 候选词列表, KeyboardView 不同的键按下后会设置相关的列表 int mSelectedIndex = -1; // 当前 候选词下标 public CandidateView(Context context) { super(context); tv = new TextView(context); tv.setId(1); RelativeLayout.LayoutParams lpCenter = new RelativeLayout.LayoutParams( 200, ViewGroup.LayoutParams.WRAP_CONTENT); lpCenter.addRule(RelativeLayout.CENTER_IN_PARENT); addView(tv, lpCenter); tv.setOnClickListener(new OnClickListener() { public void onClick(View v) { <strong>listener.pickSuggestionManually(mSelectedIndex);</strong> } }); btLeft = new Button(context); btLeft.setText("<"); btLeft.setOnClickListener(new OnClickListener() { public void onClick(View arg0) { mSelectedIndex = mSelectedIndex > 0 ? (mSelectedIndex - 1) : 0; <strong>tv.setText(suggestions.get(mSelectedIndex));</strong> } }); RelativeLayout.LayoutParams lpLeft = new RelativeLayout.LayoutParams( 60, ViewGroup.LayoutParams.WRAP_CONTENT); lpLeft.addRule(RelativeLayout.LEFT_OF, 1); addView(btLeft, lpLeft); btRight = new Button(context); btRight.setText(">"); btRight.setOnClickListener(new OnClickListener() { public void onClick(View v) { mSelectedIndex = mSelectedIndex >= suggestions.size() - 1 ? suggestions .size() - 1 : mSelectedIndex + 1; tv.setText(suggestions.get(mSelectedIndex)); } }); RelativeLayout.LayoutParams lpRight = new RelativeLayout.LayoutParams( 60, ViewGroup.LayoutParams.WRAP_CONTENT); lpRight.addRule(RelativeLayout.RIGHT_OF, 1); addView(btRight, lpRight); } public void setService(helloIme listener) { this.listener = listener; } public void setSuggestions(List<String> suggestions) { mSelectedIndex = 0; tv.setText(suggestions.get(mSelectedIndex)); this.suggestions = suggestions; } } }
上面最重要的是加粗字体的那两行,View的布局还是花费了很多代码。KeyboardView的布局预想如下:
就两个按钮,点if时往输入框中输出if(){},if(){}else if(){},while时往输入框中输出while(){},这个类同样是继承于RelativeLayout的内部类:
class KeyboardView extends RelativeLayout { public KeyboardView(Context context) { super(context); Button btIf = new Button(context); btIf.setText("if"); btIf.setId(1); RelativeLayout.LayoutParams lpIf = new RelativeLayout.LayoutParams( 100, 50); lpIf.addRule(RelativeLayout.CENTER_HORIZONTAL); btIf.setOnClickListener(new OnClickListener() { public void onClick(View v) { setCandidatesViewShown(true); // 显示 CandidateView helloIme.this.onKey("if"); // 将点击按钮的值传回给 InputMethodService } }); addView(btIf, lpIf); Button btWhile = new Button(context); btWhile.setText("while"); RelativeLayout.LayoutParams lpWhile = new RelativeLayout.LayoutParams( 100, 50); lpWhile.addRule(RelativeLayout.BELOW, 1); lpWhile.addRule(RelativeLayout.ALIGN_LEFT, 1); btWhile.setOnClickListener(new OnClickListener() { public void onClick(View v) { setCandidatesViewShown(true); helloIme.this.onKey("while"); } }); addView(btWhile, lpWhile); } }
CandidateView默认是不显示的,所以需要调用InputMethodService的setCandidatesViewShown()方法。
接下来把helloIme的代码贴出来:
public class helloIme extends InputMethodService { private List<String> suggestionlist; // 当前候选词表 private Hashtable<String, List<String>> data; // 词典数据 private KeyboardView mkeyView; private CandidateView mCandView; // InputMethodService在启动时,系统会调用该方法,具体内容下回再表 public void onInitializeInterface() { // 初始化 词典数据 data = new Hashtable<String, List<String>>(); List<String> list = new ArrayList<String>(); list.add("if(){}"); list.add("if(){}else if(){}"); list.add("if(){}else{}"); data.put("if", list); list = new ArrayList<String>(); list.add("while(){}"); data.put("while", list); } public View onCreateInputView() { mkeyView = new KeyboardView(this); return mkeyView; } public View onCreateCandidatesView() { mCandView = new CandidateView(this); mCandView.setService(this); return mCandView; } public void pickSuggestionManually(int mSelectedIndex) { getCurrentInputConnection().commitText( suggestionlist.get(mSelectedIndex), 0); // 往输入框输出内容 setCandidatesViewShown(false); // 隐藏 CandidatesView } public void onKey(CharSequence text) { // 根据按下的按钮设置候选词列表 suggestionlist = data.get(text); mCandView.setSuggestions(suggestionlist); } class CandidateView extends RelativeLayout { TextView tv; // 中间显示候选词 Button btLeft, btRight; // 左右按钮 helloIme listener; // helloIme 用于返回选中的 候选词下标 // 候选词列表, KeyboardView 不同的键按下后会设置相关的列表 List<String> suggestions; int mSelectedIndex = -1; // 当前 候选词下标 public CandidateView(Context context) { super(context); tv = new TextView(context); tv.setId(1); RelativeLayout.LayoutParams lpCenter = new RelativeLayout.LayoutParams( 200, ViewGroup.LayoutParams.WRAP_CONTENT); lpCenter.addRule(RelativeLayout.CENTER_IN_PARENT); addView(tv, lpCenter); tv.setOnClickListener(new OnClickListener() { public void onClick(View v) { listener.pickSuggestionManually(mSelectedIndex); } }); btLeft = new Button(context); btLeft.setText("<"); btLeft.setOnClickListener(new OnClickListener() { public void onClick(View arg0) { mSelectedIndex = mSelectedIndex > 0 ? (mSelectedIndex - 1) : 0; tv.setText(suggestions.get(mSelectedIndex)); } }); RelativeLayout.LayoutParams lpLeft = new RelativeLayout.LayoutParams( 60, ViewGroup.LayoutParams.WRAP_CONTENT); lpLeft.addRule(RelativeLayout.LEFT_OF, 1); addView(btLeft, lpLeft); btRight = new Button(context); btRight.setText(">"); btRight.setOnClickListener(new OnClickListener() { public void onClick(View v) { mSelectedIndex = mSelectedIndex >= suggestions.size() - 1 ? suggestions .size() - 1 : mSelectedIndex + 1; tv.setText(suggestions.get(mSelectedIndex)); } }); RelativeLayout.LayoutParams lpRight = new RelativeLayout.LayoutParams( 60, ViewGroup.LayoutParams.WRAP_CONTENT); lpRight.addRule(RelativeLayout.RIGHT_OF, 1); addView(btRight, lpRight); } public void setService(helloIme listener) { this.listener = listener; } public void setSuggestions(List<String> suggestions) { mSelectedIndex = 0; tv.setText(suggestions.get(mSelectedIndex)); this.suggestions = suggestions; } } class KeyboardView extends RelativeLayout { public KeyboardView(Context context) { super(context); Button btIf = new Button(context); btIf.setText("if"); btIf.setId(1); RelativeLayout.LayoutParams lpIf = new RelativeLayout.LayoutParams( 100, 50); lpIf.addRule(RelativeLayout.CENTER_HORIZONTAL); btIf.setOnClickListener(new OnClickListener() { public void onClick(View v) { setCandidatesViewShown(true); // 显示 CandidateView helloIme.this.onKey("if"); // 将点击按钮的值传回给 InputMethodService } }); addView(btIf, lpIf); Button btWhile = new Button(context); btWhile.setText("while"); RelativeLayout.LayoutParams lpWhile = new RelativeLayout.LayoutParams( 100, 50); lpWhile.addRule(RelativeLayout.BELOW, 1); lpWhile.addRule(RelativeLayout.ALIGN_LEFT, 1); btWhile.setOnClickListener(new OnClickListener() { public void onClick(View v) { setCandidatesViewShown(true); helloIme.this.onKey("while"); } }); addView(btWhile, lpWhile); } } }
代码写完,再来写配置文件,在res目录下面建立一个新目录xml,然后创建一个method.xml:
<?xml version="1.0" encoding="utf-8"?> <!-- The attributes in this XML file provide configuration information --> <!-- for the Search Manager. --> <input-method xmlns:android="http://schemas.android.com/apk/res/android" />
设置Manifest.xml,在AndroidManifest.xml中加入:
<service android:name="helloIme" android:permission="android.permission.BIND_INPUT_METHOD" > <intent-filter> <action android:name="android.view.InputMethod" /> </intent-filter> <meta-data android:name="android.view.im" android:resource="@xml/method" /> </service>
直接运行程序,eclipse输出如下Log:
[2015-05-15 14:40:48 - Test006] Installing Test006.apk... [2015-05-15 14:40:50 - Test006] Success! [2015-05-15 14:40:50 - Test006] Test006binTest006.apk installed on device [2015-05-15 14:40:50 - Test006] Done!
安装成功了,还需在模拟器上进行设置:
点击settings->Language & keyboard,在下部出现了一个test006,右边有个checkbox,选上它。并设置默认输入法为test006。
找一个有输入框的应用,最简单到写短消息的画面,左键长按输入框,会弹出一个输入法选择提示框,点进去就会看到刚才创建的输入法了,点击右边的单选框,漂亮的hello输入法就展现在面前了:
demo