本文将结合前面五篇文章所讲解的知识,综合起来,实现一个接口扩展的功能。
如果还没有阅读过前面五篇文章的内容,请先阅读:
《Android Telephony分析(一) — Phone详解 》
《Android Telephony分析(二) — RegistrantList详解 》
《Android Telephony分析(三) — RILJ详解 》
《Android Telephony分析(四) — TelephonyManager详解 》
《Android Telephony分析(五) — TelephonyRegistry详解 》
至于接口扩展,也就是新增一个接口给APP调用,从APP至RIL,大体流程如下:
1. 发送请求的实现
1.1 扩展BaseCommands接口
扩展BaseCommands接口主要为了在RIL.java 中实现向modem发送请求的方法。
RILJ的继承关系如下:
所以要在RILJ中新增一个向modem发送Request的方法,需要扩展BaseCommands,再在RIL.java重写该方法。
在BaseCommands.java (frameworksopttelephonysrcjavacomandroidinternaltelephony)添加一个方法:
public void setValueToModem(int input,Message response) { //这个方法为空,由让子类按需要去重写 }
在RILConstants.java (frameworksbasetelephonyjavacomandroidinternaltelephony)中新增一个主动请求的消息:
//200这个数字需要根据实际项目进行修改 int RIL_REQUEST_SET_VALUE = 200;
在RIL.java (frameworksopttelephonysrcjavacomandroidinternaltelephony)中新增发送请求的方法:
@Override public void setValueToModem(int input,Message response) { //得到一个RILRequest对象 RILRequest rr = RILRequest.obtain(RIL_REQUEST_SET_VALUE, response); //将APP传递过来的参数放到RILRequest对象中 rr.mParcel.writeInt(input); //输出关键log if (RILJ_LOGD) riljLog(rr.serialString() "> " requestToString(rr.mRequest) " " input); send(rr); //for test //response.sendToTarget(); }
至于RILC的扩展省略,调试为了这个接口是否可用,故意写了
response.sendToTarget();这行代码用于调试。
1.2 扩展PhoneInternalInterface接口
扩展PhoneInternalInterface接口主要为了封装RILJ的方法,只要得到Phone的实例即可间接调用RILJ的方法。
Phone的继承关系如下:
Phone.java是整个关系的中心枢纽,所以假如不用针对ImsPhone而走IMS流程的话,我们可以扩展PhoneInternalInterface接口,然后在Phone.java中具体实现即可。
先在PhoneInternalInterface.java (frameworksopttelephonysrcjavacomandroidinternaltelephony)中新增一个接口:
void setValueToModem(int value);
在Phone.java (frameworksopttelephonysrcjavacomandroidinternaltelephony)统一实现该接口,Phone所有子类都使用这个方法:
@Override public void setValueToModem(int input){ //对于回调事件的处理,第2小节再讲 Message resp = obtainMessage(EVENT_SET_VALUE_DONE,0,0); //直接调用RILJ中的方法 mCi.setValueToModem(input,resp); }
1.3 扩展ITelephony接口
扩展ITelephony接口主要是为了进一步封装Phone对象中的方法,让那些不能直接得到Phone对象的类也可以间接地调用Phone对象中的方法。
先在ITelephony.aidl(frameworksbasetelephonyjavacomandroidinternaltelephony)中新增一个接口:
void setValueToModem(int input);
在PhoneInterfaceManager.java (packagesservicestelephonysrccomandroidphone)中实现该接口:
@Override public void setValueToModem(int input){ try{ //得到Phone对象 Phone phone = PhoneFactory.getDefaultPhone(); if(phone != null){ phone.setValueToModem(input); } }catch(IllegalStateException e){ } }
由于PhoneInterfaceManager运行在Phone进程中,所以还需进一步封装,让不运行在Phone进程中的类也可以调用。
在TelephonyManager.java (frameworksbasetelephonyjavaandroidtelephony)中封装Phone Service的方法:
/** @hide */ public void setValueToModem(int input){ try { //得到PhoneInterfaceManager的代理对象 ITelephony telephony = getITelephony(); if (telephony != null){ telephony.setValueToModem(input); } } catch (RemoteException ex) { } catch (NullPointerException ex) { } }
从RILJ—>Phone—>PhoneInterfaceManager—>TelephonyManager,经过一层层的封装,APP终于可以通过TelephonyManager来间接调用RILJ中的方法了。
整个过程的时序图如下:
2. 返回结果的实现
2.1 RILJ中的处理
在RILJ向modem发送请求之后,modem处理完会上报Solicited Response消息并且附带着结果
所以我们需要在RIL.java (frameworksopttelephonysrcjavacomandroidinternaltelephony)的processSolicited()方法中增加
case RIL_REQUEST_SET_VALUE: ret = responseInts(p); break;
在requestToString方法中增加
case RIL_REQUEST_SET_VALUE: return "RIL_REQUEST_SET_VALUE";
2.2 Phone中的处理
在《Android Telephony分析(三) — RILJ详解 》的2.2.1小节中我们说过,接着会通过rr.mResult.sendToTarget();返回到创建Message对象的地方,也就是上面1.2小节说到的
在Phone.java (frameworksopttelephonysrcjavacomandroidinternaltelephony)中:
@Override public void setValueToModem(int input){ //对于回调事件的处理,第2小节再讲 Message resp = obtainMessage(EVENT_SET_VALUE_DONE,0,0); //直接调用RILJ中的方法 mCi.setValueToModem(input,resp); }
还需要对于回调事件进行处理,也就是先在Phone.java中定义EVENT_SET_VALUE_DONE消息:
//100这个数字需要根据实际项目进行修改 protected static final int EVENT_SET_VALUE_DONE = 100; protected static final int EVENT_LAST = EVENT_SET_VALUE_DONE;
接着在handleMessage()方法中增加对EVENT_SET_VALUE_DONE的处理:
case EVENT_SET_VALUE_DONE: //取出返回结果 ar = (AsyncResult)msg.obj; String result = null; //如果返回结果不为空且没有异常 if (ar != null && ar.exception == null) { result = "success"; }else{ result = "fail"; } //其实最偷懒的方式是直接在这里发广播通知APP, //但是为了结合我们学过的知识,我还是通过PhoneNotifier来实现 mNotifier.notifySetValueDone(result); break;
2.3 扩展PhoneNotifier接口
扩展PhoneNotifier接口主要为了进一步上报消息并且附带这结果。PhoneNotifier的常用子类是DefaultPhoneNotifier。
先在PhoneNotifier.java (frameworksopttelephonysrcjavacomandroidinternaltelephony)中新增一个接口:
public void notifySetValueDone(String result);
接着在DefaultPhoneNotifier.java (frameworksopttelephonysrcjavacomandroidinternaltelephony)中实现该接口:
@Override public void notifySetValueDone(String result){ try { if (mRegistry != null) { //需要依赖TelephonyRegistry进一步上报通知 mRegistry.notifySetValueDone(result); } } catch (RemoteException ex) { ex.printStackTrace(); } }
2.4 扩展ITelephonyRegistry接口
先在ITelephonyRegistry.aidl(frameworksbasetelephonyjavacomandroidinternaltelephony)中新增接口:
void notifySetValueDone(String result);
在TelephonyRegistry.java (frameworksbaseservicescorejavacomandroidserver)中实现该接口:
@Override public void notifySetValueDone(String result){ synchronized (mRecords) { for (Record r : mRecords) { //通知所有监听了LISTEN_SET_VALUE_DONE的类 if((r.matchPhoneStateListenerEvent(PhoneStateListener.LISTEN_SET_VALUE_DONE))){ try { r.callback.onSetValueDone(result); } catch (RemoteException ex) { mRemoveList.add(r.binder); } } } handleRemoveListLocked(); } }
2.5 扩展IPhoneStateListener接口
扩展IPhoneStateListener接口主要为了新增一个可以监听的事件LISTEN_SET_VALUE_DONE。通过APP事先监听,当有该事件上报的时候,就会通知到APP。
先IPhoneStateListener.aidl(frameworks/base/telephony/java/com/android/internal/telephony)中新增接口:
void onSetValueDone(String result);
在PhoneStateListener.java (frameworksbasetelephonyjavaandroidtelephony)中新增可监听的事件,并且初步实现接口中的方法
/** @hide */ //这个数字按项目实际需要修改 public static final int LISTEN_SET_VALUE_DONE = 0x00800000; /** @hide*/ public void onSetValueDone(String result){ //由子类来重写 }
在IPhoneStateListener callback = new IPhoneStateListener.Stub()中新增:
public void onSetValueDone(String result){ Message.obtain(mHandler, LISTEN_SET_VALUE_DONE, 0, 0, result).sendToTarget(); }
在handleMessage中新增:
case LISTEN_SET_VALUE_DONE: //调用子类重写的方法,也就是APP中的方法 PhoneStateListener.this.onSetValueDone((String)msg.obj); break;
到这里,从RILJ—>Phone—>DefaultPhoneNotifier—>TelephonyRegistry—>APP,消息和结果就上报到APP了。
整个过程的时序图如下(步骤10~15):
3. APP如何使用接口
在APP中可以这样调用并调试接口:
//监听事件 TelephonyManager.getDefault().listen(new PhoneStateListener(){ @Override public void onSetValueDone(String result){ //对结果进行处理 } }, PhoneStateListener.LISTEN_SET_VALUE_DONE); //发送请求 TelephonyManager.getDefault().setValueToModem(1);
————————————————
版权声明:本文为CSDN博主「linyongan」的原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/linyongan/article/details/52151651