商米介紹地址：https://www.sunmi.com/
商米是一個提供手持PDA的一個很好的解決方案廠商，
也有其他的一些桌面設備。
其中商米提供的軟件服務中，比較特別的是 身份證云解功能。
此處重點說明一下，身份證云解功能。
以往市面上的身份證讀卡功能，都是找公安申請身份證讀卡器硬件模塊。比較貴。
商米的身份證讀卡，是利用商米的NFC功能，配合身份證云解功能來實現
單獨實現身份證讀卡，和單獨實現NFC刷IC卡，在商米提供的SDK很容易能實現
但是同時實現兼容 讀IC卡和身份證，現在的商米SDK 就兼容性做的很差。
這里主要說明一下同時兼容 讀IC卡和身份證，
1、引用jar包：implementation ‘com.sunmi:SunmiEID-SDK:1.3.16’
2、主界面上，初始化NFC，NfcUtils
package com.smk.travelpda.common.nfc;import android.app.Activity;
import android.content.Context;
import android.nfc.NfcAdapter;
import android.nfc.Tag;
import android.util.Log;
import android.widget.Toast;import com.smk.travelpda.common.util.RString;/*** luoyang*/public class NfcUtils {private static final String TAG = "NfcUtils";private static NfcAdapter mNfcAdapter;private NfcUtils(){}private static NfcUtils nfcUtils = null;private static boolean isOpen = false;/*** 獲取NFC的單例* @return NfcUtils*/public static NfcUtils getInstance(){if (nfcUtils == null){synchronized (NfcUtils.class){if (nfcUtils == null){nfcUtils = new NfcUtils();}}}return nfcUtils;}private NfcListener nfcListener;public void setNfcListener(NfcListener listener){nfcListener = listener;}/*** 在onStart中檢測是否支持nfc功能* @param context 當前頁面上下文*/public void onStartNfcAdapter(Context context){//設備的NfcAdapter對象mNfcAdapter = NfcAdapter.getDefaultAdapter(context);}/*** 在onResume中開啟nfc功能* @param activity*/public void onResumeNfcAdapter(final Activity activity){if(mNfcAdapter==null){//判斷設備是否支持NFC功能RString.showDia(activity,"提醒","設備不支持NFC功能");return;}if (!mNfcAdapter.isEnabled()){//判斷設備NFC功能是否打開RString.showDia(activity,"提醒","請到系統設置中打開NFC功能!");return;}if (!isOpen) {mNfcAdapter.enableReaderMode(activity, new NfcAdapter.ReaderCallback() {@Overridepublic void onTagDiscovered(final Tag tag) {if (nfcListener != null){(activity).runOnUiThread(new Runnable() {@Overridepublic void run() {nfcListener.nfcReadHander(tag);}});}}},(NfcAdapter.FLAG_READER_NFC_A |NfcAdapter.FLAG_READER_NFC_B |NfcAdapter.FLAG_READER_NFC_F |NfcAdapter.FLAG_READER_NFC_V |NfcAdapter.FLAG_READER_NFC_BARCODE ),null);isOpen = true;}}/*** 在onPause中關閉nfc功能* @param activity*/public void onPauseNfcAdapter(Activity activity){if(mNfcAdapter!=null && mNfcAdapter.isEnabled()){if (isOpen){mNfcAdapter.disableReaderMode(activity);}isOpen = false;}}}
NFC監聽組件
package com.smk.travelpda.common.nfc;import android.nfc.Tag;/*** 自定義的NFC接口*/public interface NfcListener{/*** 用于掃到nfc后的后續操作*/void nfcReadHander(Tag tag);}
設置商米SDK的回調方法
package com.smk.travelpda.common.yidcard;import android.util.Log;import com.smk.travelpda.MainActivity;
import com.smk.travelpda.common.util.RJson;
import com.sunmi.eidlibrary.EidCall;
import com.sunmi.eidlibrary.EidConstants;
import com.sunmi.eidlibrary.EidSDK;import java.util.Map;//云解身份證讀卡回調方法
public class EidCardReadCall implements EidCall {private String TAG = "IdCardHander";private EidcardListener eidcardListener;private String eventType;public EidCardReadCall(EidcardListener eidcardListener,String eventType){this.eidcardListener = eidcardListener;this.eventType = eventType;}@Overridepublic void onCallData(int code, String msg) {if(this.eventType.endsWith(EidHanderEo.EID_INIT)){initEidHanderCall(code, msg);}else if(this.eventType.endsWith(EidHanderEo.Eid_READY_NFC)){readerForNfc(code, msg);} else if (this.eventType.endsWith(EidHanderEo.GETIDCARDINFO)) {getIDCardInfo(code, msg);}}public void initEidHanderCall(int i, String s){EidHanderEo inttEo = new EidHanderEo(this.eventType);inttEo.setEventCode(i);switch (i) {case EidConstants.EID_INIT_SUCCESS:inttEo.setSucces(true);break;default:inttEo.setSucces(false);inttEo.setMsg(s);break;}eidcardListener.handEidEvent(inttEo);}public void getIDCardInfo(int i, String s) {EidHanderEo eo = new EidHanderEo(this.eventType);eo.setEventCode(i);if (i == EidConstants.DECODE_SUCCESS) {eo.setSucces(true);eo.setCardType("sfz");try{Map<String,Object> sfzMap = RJson.parseJson2Map(s);String idnum = (String)((Map<String,Object>)sfzMap.get("base_info")).get("idnum");eo.setCardId(idnum);}catch (Exception e){eo.setSucces(false);eo.setMsg("身份證解析失敗，請重試");}} else {//解碼失敗，code 為錯誤嗎，data為錯誤原因// typetext.setText("解析失敗：code:"+i);//typetext.setText("解析失敗：data:"+s);eo.setSucces(false);eo.setMsg(s);}eidcardListener.handEidEvent(eo);}public void readerForNfc(int code, String msg) {System.out.println("code:" + code + ":msg:" + msg);EidHanderEo eidHanderEo = new EidHanderEo(this.eventType);eidHanderEo.setEventCode(code);switch (code) {case EidConstants.EID_INIT_SUCCESS:eidHanderEo.setSucces(true);break;case EidConstants.ERR_NFC_NOT_SUPPORT:// 該機器不支持NFC功能，無法使用SDKeidHanderEo.setSucces(false);eidHanderEo.setMsg("機器不支持NFC");break;case EidConstants.ERR_NETWORK_NOT_CONNECTED:eidHanderEo.setSucces(false);eidHanderEo.setMsg("網絡未連接，請聯網后重試");// *** 異常處理： 連接網絡后，需要重新調用 startCheckCard 方法 （手動觸發，非自動）***break;case EidConstants.ERR_NFC_CLOSED:eidHanderEo.setSucces(false);eidHanderEo.setMsg("NFC 未打開，打開后重試 ");// *** 異常處理： 打開NFC后，需要重新調用 startCheckCard 方法 （手動觸發，非自動）***break;case EidConstants.READ_CARD_READY://Step 3 讀卡準備完成 -> 業務方可以引導用戶開始進行刷卡操作eidHanderEo.setSucces(true);eidHanderEo.setMsg("SDK準備完成，請刷卡");break;case EidConstants.READ_CARD_START://Step 4 讀卡中 -> 業務方可以提醒用戶"讀卡中，請勿移動卡片"eidHanderEo.setSucces(true);eidHanderEo.setMsg("開始讀卡，請勿移動");break;case EidConstants.READ_CARD_SUCCESS://Step 5 讀卡成功 -> 返回的msg為reqId，通過 reqId 業務方走云對云方案獲取身份證信息//注：如不需要循環讀卡，可在此處調用stopCheckCard方法eidHanderEo.setSucces(true);eidHanderEo.setMsg("讀卡成功");eidHanderEo.setCardId(msg);//設置讀取的身份證IDbreak;case EidConstants.READ_CARD_FAILED://*** 異常處理： 讀卡失敗，請重新讀卡 ***eidHanderEo.setSucces(false);eidHanderEo.setMsg("讀卡失敗,請重試"+ msg);break;case EidConstants.ERR_ACCOUNT_EXCEPTION://*** 異常處理： 讀卡失敗，請重新讀卡 ***eidHanderEo.setSucces(false);eidHanderEo.setMsg("該設備未開通身份證讀卡權限！");break;default://*** 異常處理： 其他失敗 - code為錯誤碼，msg為詳細錯誤原因 需要重新調用 startCheckCard 方法 （手動觸發，非自動）***eidHanderEo.setSucces(false);eidHanderEo.setMsg("讀卡異常,請重試code:"+code+ msg);break;}eidcardListener.handEidEvent(eidHanderEo);}}商米SDK的監聽方法
package com.smk.travelpda.common.yidcard;/*** 處理EID的事件*/
public interface EidcardListener {public void handEidEvent(EidHanderEo eidHanderEo);
}主界面
package com.smk.travelpda;import android.content.IntentFilter;
import android.nfc.Tag;
import android.nfc.tech.IsoDep;
import android.nfc.tech.MifareClassic;
import android.nfc.tech.NfcA;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.TextView;import androidx.activity.EdgeToEdge;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.graphics.Insets;
import androidx.core.view.ViewCompat;
import androidx.core.view.WindowInsetsCompat;import com.smk.travelpda.common.macinfo.MacInfoHander;
import com.smk.travelpda.common.nfc.NfcListener;
import com.smk.travelpda.common.nfc.NfcReadHander;
import com.smk.travelpda.common.nfc.NfcUtils;
import com.smk.travelpda.common.scan.ScanEventEo;
import com.smk.travelpda.common.scan.ScanListener;
import com.smk.travelpda.common.util.BusinessException;
import com.smk.travelpda.common.util.RString;
import com.smk.travelpda.common.util.VersionCheckUtil;
import com.smk.travelpda.common.yidcard.EidCardReadCall;
import com.smk.travelpda.common.yidcard.EidHanderEo;
import com.smk.travelpda.common.scan.ScanMachinReceive;
import com.smk.travelpda.common.yidcard.EidcardListener;
import com.sunmi.eidlibrary.EidCall;
import com.sunmi.eidlibrary.EidConstants;
import com.sunmi.eidlibrary.EidReader;
import com.sunmi.eidlibrary.EidSDK;/*** luoyang 2024-04-17*/
public class MainActivity extends AppCompatActivity implements NfcListener, ScanListener, EidcardListener {public final static String APP_ID = "商米的APPID";public final static String APP_KEY = "商米的APPKEY";private TextView datatext;//綁定的歸屬方，景區名稱private TextView tourname;private TextView sntext;private TextView visionnum;private NfcUtils nfcUtils = NfcUtils.getInstance();private EidReader eid;private ScanMachinReceive myReceiver ;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);EdgeToEdge.enable(this);setContentView(R.layout.activity_main);ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main), (v, insets) -> {Insets systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars());v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom);return insets;});datatext = findViewById(R.id.data);tourname = findViewById(R.id.tourname);sntext = findViewById(R.id.sntext);visionnum = findViewById(R.id.visionnum);sntext.setText("序列號："+MacInfoHander.getSN());visionnum.setText("V1.0.0");tourname.setText("景區");//初始化NFC讀卡器nfcUtils.setNfcListener(this);//商米的掃碼監聽initScanReceiveLislen();//初始話監聽//初始化身份證讀卡initCardEidSdk();}@Overrideprotected void onDestroy() {super.onDestroy();// 注銷掃碼接收廣播unregisterReceiver(myReceiver);//注銷讀卡服務EidSDK.destroy();}@Overrideprotected void onStart() {super.onStart();System.out.println("onStart................................");nfcUtils.onStartNfcAdapter(this); //初始化Nfc對象}@Overrideprotected void onResume() {super.onResume();System.out.println("onResume................................");nfcUtils.onResumeNfcAdapter(this); //activity激活的時候開始掃描datatext.append("NFC初始化成功\n");}@Overrideprotected void onPause() {super.onPause();System.out.println("onPause................................");nfcUtils.onPauseNfcAdapter(this); //activity切換到后臺的時候停止掃描}//讀NFC卡后的返回事件@Overridepublic void nfcReadHander(Tag tag) {datatext.setText("start new card");String tl[] = tag.getTechList();//POS機器，只支持2代和3代卡，身份證，其他證件不支持try {boolean isHandCard = false;for (String s:tl) {if(s.equals("android.nfc.tech.MifareClassic")){//String data = NfcReadHander.readMifareTag(tag,MifareClassic.get(tag));datatext.setText(RString.byteToString(tag.getId()));isHandCard = true;break;//旅游卡PDA 無需支持M1卡類型}else if(s.equals("android.nfc.tech.IsoDep")){String cardType = "smk";//讀取IC卡String cardId = NfcReadHander.readIsoDepTag(tag, IsoDep.get(tag));System.out.println("cardId"+cardId);datatext.setText(cardId);isHandCard = true;break;}else if(s.equals("android.nfc.tech.NfcB")){//跳轉到身份證云解讀取，NFCB為身份證模塊，此處調用身份證云解，其他的為IC卡讀取eid.nfcReadCard(tag);isHandCard = true;break;}}if(!isHandCard){throw new BusinessException("請刷IC卡或身份證");}}catch (BusinessException e){//捕獲自定義異常datatext.setText(e.getMessage());}}/*** 實現掃碼事件* @return*/@Overridepublic void scanEventHander(ScanEventEo eventEo) {String eventType = eventEo.getEventType();if(eventType.equals(ScanEventEo.SCAN_START)){//typetext.setText("開始掃碼");datatext.setText("開始掃碼");} else if (eventType.equals(ScanEventEo.SCAN_RECEVIE)) {//typetext.setText("掃碼成功");datatext.setText("");datatext.append(eventEo.isAllow()+":"+ eventEo.getQrData());} else if (eventType.equals(ScanEventEo.SCAN_END)) {datatext.setText("掃碼結束");}}//實現云解身份證的事件@Overridepublic void handEidEvent(EidHanderEo eidHanderEo) {String eventType = eidHanderEo.getEventType();if(eventType.equals(EidHanderEo.EID_INIT)){//typetext.setText("init success");//init初始化監聽時間if(eidHanderEo.isSucces() && eidHanderEo.getEventCode() == EidConstants.EID_INIT_SUCCESS){eid = EidSDK.getEidReaderForNfc(3, new EidCardReadCall(this,EidHanderEo.Eid_READY_NFC));}else {//其他都是失敗的，RString.showDia(this,"身份證模塊初始化失敗",eidHanderEo.getMsg());}} else if (eventType.equals(EidHanderEo.Eid_READY_NFC)) {// typetext.setText("Eid_READY_NFC");//讀卡的回調if(eidHanderEo.isSucces() && eidHanderEo.getEventCode() == EidConstants.READ_CARD_SUCCESS){datatext.setText(eidHanderEo.getCardId());//讀卡成功的回調EidSDK.getIDCardInfo(eidHanderEo.getCardId(), MainActivity.APP_KEY, new EidCardReadCall(this,EidHanderEo.GETIDCARDINFO));}else if(!eidHanderEo.isSucces()){RString.showDia(this,"提醒",eidHanderEo.getMsg());}else{//有些成功，是否需要干預流程處理，不需要就不做任何事情//datatext.setText(eidHanderEo.getMsg());datatext.append("身份證模塊初始化成功");}} else if (eventType.equals(EidHanderEo.GETIDCARDINFO)) {//typetext.setText("GETIDCARDINFO");//調用if(eidHanderEo.isSucces() && eidHanderEo.getEventCode() == EidConstants.DECODE_SUCCESS){//解析成功datatext.setText("");datatext.append(eidHanderEo.getCardId());}else {RString.showDia(this,"提醒",eidHanderEo.getMsg());}}}private void initScanReceiveLislen(){myReceiver = new ScanMachinReceive(this);IntentFilter intentFilter = new IntentFilter();intentFilter.addAction(ScanEventEo.SCAN_RECEVIE); // 監聽網絡變化廣播intentFilter.addAction(ScanEventEo.SCAN_START); // 監聽網絡變化廣播intentFilter.addAction(ScanEventEo.SCAN_END); // 監聽網絡變化廣播// 注冊廣播 只從原生獲取，不從外部APP獲取registerReceiver(myReceiver, intentFilter);datatext.append("掃碼初始化成功\n");}private void initCardEidSdk(){EidSDK.init(this, APP_ID, new EidCardReadCall(this,EidHanderEo.EID_INIT));// EidSDK.startCheckCard不要使用這個API}public void visionClick(View view){//startActivity(VersionCheckUtil.check(false));}
}
這個兼容身份證和IC讀卡的關鍵點在于，不要使用SDK里面 EidSDK.startCheckCard();
1、EidSDK.init方法，
2、在EidSDK.init的成功回調函數中，獲取NFC讀卡的
EidReader eid = EidSDK.getEidReaderForNfc(3, new EidCardReadCall(this,EidHanderEo.Eid_READY_NFC));
將Object類型轉換成String類型)
