安卓SDK:身份证与护照识别接口指南

5星 · 超过95%的资源 需积分: 31 35 下载量 5 浏览量 更新于2024-09-05 1 收藏 109KB DOCX 举报
"安卓平台身份证识别云解码接口文档" 这篇文档是关于在安卓平台上实现身份证、护照和EID(欧洲身份证)识别的SDK接口指南。该SDK由成都鱼住未来科技有限公司提供,支持NFC(近场通信)和OTG(On-The-Go)两种读卡方式。二次开发和技术支持由该公司提供,包括官方网站、电子邮件和电话等多种联系方式。 SDK的主要功能包括: 1. **二代身份证识别**:接口包含身份鉴权操作,确保只有经过验证的用户才能使用解码服务器进行身份证信息解码。 2. **护照和EID识别**:这些功能需要单独向公司申请开通权限。 3. **NFC读卡**:适用于具备NFC功能的安卓设备,允许直接读取身份证等证件信息。 4. **OTG读卡**:适用于配备USB接口的安卓设备,但需要配合公司专用的证件读卡器。 接口文件`OTGReadCardAPI.java`包含了所有必要的方法。在使用SDK前,开发者需要实现`ActiveCallBack`接口,包含两个关键函数: - `readProgress(int nProgress)`:返回身份证读卡的进度,总共20步。 - `setUserInfo(String sztxt)`:通常用于接收调试信息,可以空实现。 主要接口包括: - **初始化接口**:`OTGReadCardAPI(Context context, ActiveCallBack cb, boolean bNFC)`,传入上下文、回调类以及一个布尔值bNFC(始终设为false)来初始化SDK。 - **获取版本号**:`GetVersion()`,用于获取当前SDK的版本信息。 - **设置服务器信息**:`setServerInfo(twoCardServerList, eidServerList, bTestServer)`,需在初始化后调用,传入身份证解码服务器列表、EID服务器列表(默认为null)以及测试服务器标志(通常设为false)。 - **NFC读卡**:`NfcReadCard(szAppID, userInfo, intent, defaultType, userData, bAuth)`,同步读取卡片信息,参数包括APPID、用户信息、NFC句柄、卡片类型标识、用户数据以及鉴权标志(通常设为false)。 - **获取卡片类型**:`GetCardType()`,在调用`NfcReadCard`后,可以通过此方法获取读取到的卡片类型。 在实际开发中,开发者需要根据应用需求正确调用这些接口,并处理相应的回调,以实现证件的高效、安全识别。同时,要注意与公司的沟通,获取必要的权限和服务支持。