天天看点

[NFC]NFC App开发TAG APP开发介绍P2P APP开发介绍

   前面描述了NFC的Tag流程和P2P流程,从实用的角度来看,我们会在介绍一下Tag和P2P APP开发的流程的一些介绍。

TAG APP开发介绍

        为了清楚的描述问题,使用GITHUB上的开源项目NfcReader作为讲解对象,如果有兴趣的,可以下载到local研究一下。

分析方法:

1. 查看AndroidManifest.xml文件,查找到Activity的入口

2. 从入口文件开始分析 

        依据AndroidManifest.xml内容,我们会进入到TagView中,默认Android SDK提供的android.nfc和android.nfc.tech两个包,APP的操作都是基于SDK暴露的接口来实现的。

        在TagView.Java的onCreate()函数中:

[java]  view plain  copy  print ?

  1. @Override  
  2. protected void onCreate(Bundle savedInstanceState) {  
  3.     super.onCreate(savedInstanceState);  
  4.     setContentView(R.layout.tag_viewer);  
  5.     mTagContent = (LinearLayout) findViewById(R.id.list);  
  6.     //@Paul: APP创建的时候,分析当前APP接收到的intent信息  
  7.     //        getIntent():用于获取当前的Intent信息  
  8.     resolveIntent(getIntent());  
  9.     //@Paul:产生提示消息的对话框,后续有提示消息时,直接更新内容  
  10.     mDialog = new AlertDialog.Builder(this).setNeutralButton("Ok", null).create();  
  11.     //@Paul:产生NfcAdaptor,在SDK中所有对NFC的操作,都是透过NFCAdaptor来实现的  
  12.     //       NFCAdapter调用到NfcManager中的mAdaptor  
  13.     mAdapter = NfcAdapter.getDefaultAdapter(this);  
  14.     if (mAdapter == null) {  
  15.         //@Paul: 创建出错的处理  
  16.         showMessage(R.string.error, R.string.no_nfc);  
  17.         finish();  
  18.         return;  
  19.     }  
  20.     //@Paul:创建PendingIntent,后续会在onResume中使用  
  21.     mPendingIntent = PendingIntent.getActivity(this, 0,  
  22.             new Intent(this, getClass()).addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP), 0);  
  23.     //@Paul:创建NdefPushMessage,用于发送消息  
  24.     mNdefPushMessage = new NdefMessage(new NdefRecord[] { newTextRecord(  
  25.             "Message from NFC Reader :-)", Locale.ENGLISH, true) });  
  26. }  

        在onCreate()函数主要是生成一些后续会用到的变量,最关键部分就是生成了mAdaptor和mPendingIntent,这两个变量在后面的地位比较重要。所有对NFC的操作,都是基于mAdaptor来实现,而mPendingIntent在Tag分发时起到了重要的作用。

        接下来将分析onResume()和onPause()函数:

[java]  view plain  copy  print ?

  1.    @Override  
  2.    protected void onResume() {  
  3. //@Paul: 回到前台时,判断NFC是否enable  
  4. //        如果没有enable,则显示setting界面  
  5.        super.onResume();  
  6.        if (mAdapter != null) {  
  7.            if (!mAdapter.isEnabled()) {  
  8.                showWirelessSettingsDialog();  
  9.            }  
  10.     //@Paul: 调用类:NFCAdaptor->NFCService->NfcDispatcher  
  11.     //        最终调用NfcDispatcher.setForegroundDispatch()  
  12.            //        更新: mOverrideIntent   
  13.     //              mOverrideFilters   
  14.     //              mOverrideTechLists   
  15.            mAdapter.enableForegroundDispatch(this, mPendingIntent, null, null);<span style="font-family: Arial, Helvetica, sans-serif;">      </span>  
  16.            //@Paul: 调用类:NFCAdaptor->NFCActivityManager  
  17.     //        NFCActivityManager.setNdefPushMessage()  
  18.            mAdapter.enableForegroundNdefPush(this, mNdefPushMessage);  
  19.        }  
  20.    }  
  21.    @Override  
  22.    protected void onPause() {  
  23.        super.onPause();  
  24.        if (mAdapter != null) {  
  25.     //@Paul: 将onResume中设置的值都设为null  
  26.            mAdapter.disableForegroundDispatch(this);  
  27.     //@Paul: mNfcActivityManager.setNdefPushMessage(null)  
  28.         //        mNfcActivityManager.setNdefPushMessageCallback( null)  
  29.     //        mNfcActivityManager.setOnNdefPushCompleteCallback(null)  
  30.            mAdapter.disableForegroundNdefPush(this);  
  31.        }  
  32.    }  
  33. @Override  
  34. //@Paul: 和程序的启动方式有关,多个调用希望只有一个Activity的实例存在时  
  35.    public void onNewIntent(Intent intent) {  
  36. //@Paul:务必更新当前的intent值  
  37.        setIntent(intent);  
  38. //@Paul: 此例单独实现,将收到的数据解析成NDEF Message  
  39.        resolveIntent(intent);  
  40.    }  

       关于NFC Tag流程上面几乎都有介绍到,总结一下:

        1. 创建NFCAdaptor和PendingIntnet对象

        2. 在onPause()和onResume()中调用enable和disable,将上层APP的参数设置下去。 一旦底层Driver侦测到有Tag设备进入范围,就会调用到NfcDispatcher.java中的dispatchTag(),该函数就会调用到:

[java]  view plain  copy  print ?

  1. if (tryOverrides(dispatch, tag, message, overrideIntent, overrideFilters,  
  2.         overrideTechLists)) {  
  3.     return screenUnlocked ? DISPATCH_UNLOCK : DISPATCH_SUCCESS;  
  4. }  

        最终会调用到overrideIntent.send(mContext, Activity.RESULT_OK, intent), 此函数会将底层侦听的Tag信息发送到APP注册了enableForegroundDispatch()的app,并且上述app会进行Tag信息的解析和处理(当前例子就是进入onNewIntent()函数)。

        基本上Tag的流程就分析完成了。

P2P APP开发介绍

        其实在Tag的APP介绍中,隐含了部分P2P的处理,比如代码中enableForegroundNdefPush()的调用和处理。实际上调用enableForegroundNdefPush()就会进入到下面部分setNdefPushMessage()。

        此部分将重点介绍一下,一旦调用了setNdefPushMessage(),  setNdefPushMessageCallback(),  setOnNdefPushCompleteCallback()后,会影响到底层哪些模块。

        先从setNdefPushMessage()开始,在此函数中会依次将上层APP要传递的消息以及回调函数信息更新到framework层,最终这些信息会在prepareMessageToSend()中得到处理,并组成待发送数据。

[java]  view plain  copy  print ?

  1. public void setNdefPushMessage(Activity activity, NdefMessage message, int flags) {  
  2.     boolean isResumed;  
  3.     synchronized (NfcActivityManager.this) {  
  4.         //@Paul: 将当前APP设置的信息存储在NfcActivityState  
  5.         //       后续会NFCActivityManager/createBeamShareData()中使用到此消息  
  6.         NfcActivityState state = getActivityState(activity);  
  7.         state.ndefMessage = message;  
  8.         state.flags = flags;  
  9.         isResumed = state.resumed;  
  10.     }  
  11.     if (isResumed) {  
  12.         //@Paul: 一般来说,在此Activity中还会定义createBeamShareData(),前提是要支持Android Beam  
  13.         requestNfcServiceCallback();  
  14.     }  
  15. }  
  16. void requestNfcServiceCallback() {  
  17.     try {  
  18.         //@Paul: 调用NFCService中的setAppCallback中  
  19.         NfcAdapter.sService.setAppCallback(this);  
  20.     } catch (RemoteException e) {  
  21.         mAdapter.attemptDeadServiceRecovery(e);  
  22.     }  
  23. }  
  24. @Override  
  25. public void setAppCallback(IAppCallback callback) {  
  26.     NfcPermissions.enforceUserPermissions(mContext);  
  27.     UserInfo userInfo = mUserManager.getUserInfo(UserHandle.getCallingUserId());  
  28.     if(!userInfo.isManagedProfile()  
  29.             && !mUserManager.hasUserRestriction(  
  30.                     UserManager.DISALLOW_OUTGOING_BEAM, userInfo.getUserHandle())) {  
  31.         //@Paul: 此函数是关键,将更新mCallbackNdef的值,如果没有更新时,此值为null  
  32.         //       一旦此值不为null,就会调用mCallbackNdef.createBeamShareData()和mCallbackNdef.onNdefPushComplete()  
  33.         mP2pLinkManager.setNdefCallback(callback, Binder.getCallingUid());  
  34.     } else if (DBG) {  
  35.         Log.d(TAG, "Disabling default Beam behavior");  
  36.     }  
  37. }  

        需要注意的是,如果需要阻止系统发送默认的NDEF消息,那可以在AndroidManifest.xml中添加:

<meta-data android:name="android.nfc.disable_beam_defaulte" android:value="true"/>

        下面开始介绍setNdefPushMessageCallback()函数,此函数的作用就是设置产生Beam数据的回调,代码分析如下:

[java]  view plain  copy  print ?

  1. public void setNdefPushMessageCallback(Activity activity,  
  2.         NfcAdapter.CreateNdefMessageCallback callback, int flags) {  
  3.     boolean isResumed;  
  4.     synchronized (NfcActivityManager.this) {  
  5.         NfcActivityState state = getActivityState(activity);  
  6.         //@Paul: 更新NfcActivityState中的ndefMessageCallback  
  7.         state.ndefMessageCallback = callback;  
  8.         state.flags = flags;  
  9.         isResumed = state.resumed;  
  10.     }  
  11.     if (isResumed) {  
  12.         requestNfcServiceCallback();  
  13.     }  
  14. }  

        其中ndefMessageCallback变量会最终在下面的函数中被调用到:

[java]  view plain  copy  print ?

  1. void prepareMessageToSend(boolean generatePlayLink) {  
  2.     synchronized (P2pLinkManager.this) {  
  3.         mMessageToSend = null;  
  4.         mUrisToSend = null;  
  5.         if (!mIsSendEnabled) {  
  6.             return;  
  7.         }  
  8.         List<Integer> foregroundUids = mForegroundUtils.getForegroundUids();  
  9.         if (foregroundUids.isEmpty()) {  
  10.             Log.e(TAG, "Could not determine foreground UID.");  
  11.             return;  
  12.         }  
  13.         //@Paul: 如果定义了callback  
  14.         if (mCallbackNdef != null) {  
  15.             if (foregroundUids.contains(mNdefCallbackUid)) {  
  16.                 try {  
  17.                     //@Paul: 调用callback对应的createBeamShareData()函数  
  18.                     BeamShareData shareData = mCallbackNdef.createBeamShareData();  
  19.                     mMessageToSend = shareData.ndefMessage;  
  20.                     mUrisToSend = shareData.uris;  
  21.                     mSendFlags = shareData.flags;  
  22.                     return;  
  23.                 } catch (Exception e) {  
  24.                     Log.e(TAG, "Failed NDEF callback: " + e.getMessage());  
  25.                 }  
  26.             } else {  
  27.                 ...  
  28.             }  
  29.         }  
  30.         ...  
  31.     }  
  32. }  

        上面createBeamShareData()需要在APP中进行定义。 

        补充一下,setNdefPushMessage()和setNdefPushMessageCallback()在系统同时被调用时,setNdefPushMessageCallback()的优先级较高,系统会优先选择callback产生NDEF Message; 这两个API的差异是:setNdefPushMessage()发送的数据为固定数据,而setNdefPushMessageCallback()则是APP可以更新的。

nfc

继续阅读