商米介绍地址：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));
