掌富刷卡外接设备接口说明.doc

掌富外接刷卡设备接口(Android) Androidmanifast.xml文件需要添加 uses-permission android:name=android.permission.RECORD_AUDIO / 刷卡器接口类 SwiperCtrl(建议使用单例模式) 方法 说明 Void SwiperCtrl(Context context, SwiperCtrlListener listener); 构造函数 Context Listener—刷卡器监听器 String getSwiperKsn(); 返回刷卡器设备序列号, 如果刷卡器状态为STATE_NONE返回null Boolean startSwiper(int requestType); 启动刷卡，仅当状态调用，否则public boolean desPin(String pin) 加密PIN Pin:格式化的PIN数据 PoseeyCtrlState getPoseeyCtrlState(); 获取刷卡器状态 Boolean isPoseey(); 检测刷卡硬件设备的是否连接True 已连接 False 未连接 Void setSwiperTimeout(int timeout); 设置刷卡超时时间 Void Release(); 删除PoseeyCtrl释放资源 刷卡器状态SwiperCtrlState 状态 说明 STATE_NONE 等待设备状态，刷卡器设备未插入 STATE_DETECTING 检测中，刷卡器设备检测中 STATE_IDLE 空闲中，刷卡器检测成功 STATE_PROCESSING 处理中，刷卡器等待用户刷卡（刷卡超时时间默认30S, 30S后执行onTimeout回调, 随后进入IDLE状态） 刷卡器监听器SwiperCtrlListener接口 这个接口是用刷卡器和应用程序的交互对象。开发者Void onPoseeyPlugged() 通知监听刷卡器插入手机Void onPoseeyUnPlugged() 通知监听刷卡器手机Void onNoPoseeyDetected() 通知刷卡器监听器没有检测到刷卡器 Void onDetectingPoseey() 通知刷卡器监听器正在检测刷卡器 Void onGetPanComplete(String pan) 通知刷卡器监听器刷卡完成 Pan—刷卡的银行卡号(未屏蔽) Void onGetTrackInfoComplete(String ksn, String randomNumber, String encrypTrack int track1Len, int track2Len, int track3Len, String maskedPAN, String expiryDate) 通知刷卡器监听器刷卡完成 Ksn--刷卡器序列号 randomNumber—用于对master key进行分散的随机数 encrypTrack—加密后的磁道信息 track1Len—一磁信息长度 track2Len—二磁信息长度 track3Len—三磁信息长度 maskedPAN—屏蔽后的卡号信息 前面6位和最后4位明文，中间每个数字用*代替 expiryDate—银行卡有效期 Void onDetectedComplete() 检测刷卡器完成 Void onInterrupted() 通知刷卡器监听器刷卡被中断, 如启动刷卡后拨出刷卡器调用此接口 Void onTimeout() 通知刷卡器监听器刷卡操作超时(超出预定时间默认30秒, 可设置) Void onStatusChange(PoseeyCtrlState state) 通知刷卡器监听器刷卡器状态发生变化 Void onError(int errCode, String msg) 通知刷卡器监听器刷卡器出现错误 errCode: 错误代码 msg: 错误信息, 可以为null void onDesPinComplete(String random, String pinDes); 通知刷卡器监听器加密PIN完成 Random:加密PIN用的随机数(8字节) pinDes:加密以后的PIN数据 错误信息码表： 错误代码 描述 0x00 成功 0x01 没有psam卡 0x02 sim卡已下电 0x03 psam初始化失败 0x04 psam选择DF错误 0x05 psam双向认证失败 0x06 加密密码错误 0x07 加密数据错误 0x08 计算MAC错误 0x09 读记录文件错误 0x0A psam卡没有响应 0x0B 执行pasm指令错误