对接调试一共分为两部分，一部分为安卓应用对接的SDK，另一部分为应用服务器与商米服务器直接的云对接API。
应用软件集成身份证识别sdk，应用软件后端服务器集成云端api（集成云端api用于保护用户身份信息，保证整个数据链路中，只有应用软件可获取身份证明文信息）
1、安卓SDK
身份证云识别的Android SDK 的集成、初始化、使用流程等。
1.1、集成
资源文件( 解压文件夹 AAR 包文件，X.X.X 表示对应的版本号) ：
正式坏境:aar/SunmiEID-SDK_vX.X.X-release.aar
测试环境:aar/SunmiEID-SDK_vX.X.X-tes.aar
1.2、导入AAR包
打开项目后:File -> New -> New Module…
在新的对话框:New Module -> Import .JAR/.AAR Package -> Next
下一步:Import Module from Library -> 选择 aar 文件夹下的 SunmiEID-SDK_vX.X.X-release/tes.aar 文件 -> Finish
完成:
1.3、app 模块引用
点击-打开模块设置:
设置对话框：选择“app” -> 点击“+”号 -> 选择“Module Dependency”
显示：勾选上对应的模块（SunmiEID-SDK_vX.X.X-release/tes）-> 点击“OK”，相关SDK引用成功。
1.4、接口文档
1.4.1、初始化
推荐在Application实现SDK初始化实现：
public class IApp extends Application implements EidCall {
@Override
public void onCreate() {
super.onCreate();
try {
EidSDK.init(this, "appid", this);
} catch (Exception e) {
e.printStackTrace();
}
}
@Override
public void onTerminate() {
super.onTerminate();
EidSDK.destroy();
}
@Override
public void onCallData(int code, String msg) {
Log.d("app", "onCallData: code:" + code + ", msg:" + msg);
}
}1.4.2、获取 EidReader 实例
private void initEidReader() {
Log.d("Eid", String.format("商米SDK.Ver:%s, 读卡模块Ver:%s", EidSDK.getSunmiEidSDKVersion(), EidSDK.getEidSDKVersion()));
EidPic.init(this, fileNameBase);
eid = EidSDK.getEidReaderForNfc(1, this);
}1.4.3、实现 EidCall 接口
@Override
public void onCallData(int code, String msg) {
switch (code) {
case EidConstants.READ_CARD_START:
mState.setText("开始读卡，请勿移动");
Log.i(TAG, "开始读卡，请勿移动");
break;
case EidConstants.READ_CARD_SUCCESS:
closeNFCReader();//电子身份证需要关闭
Log.e("TAG", String.format(Locale.getDefault(), "正在获取身份信息(%s)，请稍等.....", msg));
mState.setText(String.format(Locale.getDefault(), "正在获取身份信息(%s)，请稍等.....", msg));
File file = new File(fileNameBase, "zp.bmp");
if (file.exists()) {
file.deleteOnExit();
}
getIDCardInfo(msg); //通过card_id请求识读卡片的信息
break;
case EidConstants.READ_CARD_FAILED:
closeNFCReader();//电子身份证需要关闭
Log.i(TAG, String.format(Locale.getDefault(), "读卡错误,请重新贴卡：%s", msg));
mState.setText(String.format(Locale.getDefault(), "读卡错误,请重新贴卡：%s", msg));
break;
case EidConstants.READ_CARD_DELAY:
Log.e("TAG", String.format(Locale.getDefault(), "延迟 %sms", msg));
mState.setText(String.format(Locale.getDefault(), "延迟 %sms", msg));
break;
default:
break;
}
}1.4.4、调用NFC识读卡片
识读身份证：
@Override
protected void onNewIntent(Intent intent) {
super.onNewIntent(intent);
eid.nfcReadCard(intent);
}识读电子身份证：
@Override
protected void onNewIntent(Intent intent) {
super.onNewIntent(intent);
try {
Tag tagFromIntent = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
try {
isodep = IsoDep.get(tagFromIntent);
isodep.connect();
if (isodep.isConnected()) {
eid.readCard(IDCardType.ECCARD, new EidReadCardCallBack() {
@Override
public byte[] transceiveTypeB(byte[] data) {
return data;
}
@Override
public byte[] transceiveTypeA(byte[] data) {
byte[] outData = new byte[data.length];
try {
outData = isodep.transceive(data);
} catch (Exception e) {
e.printStackTrace();
}
return outData;
}
});
} else {
closeNFCReader()
}
} catch (Exception e) {
e.printStackTrace();
}
} catch (Exception e) {
e.printStackTrace();
}
}
private void closeNFCReader() {
if (isodep != null) {
try {
isodep.close();
isodep = null;
} catch (IOException e) {
e.printStackTrace();
}
}
}
1.5、NFC及动态授权相关
详细处理参考：ReadCardDemo.zip
1.6、详细接口说明
详细接口文档：Javadoc.zip
1.7、错误码ErrorCode
2、云对接API
