智能云POS SDK开发指南:接入与接口调用

需积分: 12 7 下载量 156 浏览量 更新于2024-09-08 收藏 386KB PDF 举报
"本文档是关于银联智能云POS开发的SDK,主要为APP开发者提供接入规范和指导。" 智能云POSSDK技术文档详细介绍了如何进行银联智能云POS的开发集成,适用于第三方应用开发商。SDK的目标是为应用程序提供统一的接口来操作终端设备,由终端厂商根据自身设备实现并开放给开发者。开发工具包由Java接口构成,允许开发者通过调用特定接口来控制硬件设备,如磁条卡阅读器、IC卡阅读器、打印机等。 设计总体原则强调了扩展性和兼容性。扩展性意味着即使添加新设备也不会影响已有的API接口,而兼容性则确保设备具有额外功能时,开发者无需关心这些额外功能,可以继续使用原有的API。 总体要求包括获取终端信息、设备发现、设备判断、设备列表、接口版本管理、设备特性获取以及异步操作支持。这些要求确保了SDK的全面性和灵活性,以适应不同终端设备的需求。 总体框架对第三方应用开发商来说,主要是通过SDK接口访问终端设备。接口大部分定义为Java Interface,部分如异常处理和特定数据类型(如ATR、MoneyValue、Format)为具体实现。SDK包的目录结构包括示例代码(demo)、开发文档(doc)和接口库(lib),方便开发者学习和引用。 使用SDK的过程包括下载最新SDK,通常将lib目录下的接口jar包添加到开发环境的类路径中,以便于引用和编译。这使得开发过程更为简便,降低了接入门槛。 通过这份文档,开发者不仅可以了解智能云POS的基本操作,还能掌握如何有效地集成和控制各种终端设备,为创建与银联智能云POS系统兼容的APP提供了明确的指导。
2011-09-30 上传
支持所有标准ESC/POS指令集打印机,北洋、佳博、商祺等 支持串口、并口、USB、网口 1.4是目前最新的公用版本了,其它后续版本都有厂家的标示 包含DLL文件,帮助,VB/VC/DELPHI例程 下边是POS_OPEN函数原型 HANDLE POS_Open(LPCTSTR lpName, int nComBaudrate, int nComDataBits, int nComStopBits, int nComParity, int nParam) 描述 打开端口。 参数 lpName [in] 指向以 null 结尾的打印机名称或端口名称。 当参数nParam的值为POS_COM_DTR_DSR、POS_COM_RTS_CTS、POS_COM_XON_XOFF或POS_COM_NO_HANDSHAKE 时, “COM1”,“COM2”,“COM3”,“COM4”等表示串口; 当参数nParam的值为POS_OPEN_PARALLEL_PORT时,“LPT1”,“LPT2”等表示并口; 当参数nParam的值为POS_OPEN_BYUSB_PORT时,“BYUSB-0”、“BYUSB-1”、“BYUSB-2”、“BYUSB-3”等表示USB端口。 当参数nParam的值为POS_OPEN_PRINTNAME时,表示打开指定的打印机。 当参数nParam的值为POS_OPEN_NETPORT时,表示打开指定的网络接口,如“192.168.10.251”表示网络接口IP地址,打印时参考“网络打印简介”。 nComBaudrate [in] 指定串口的波特率(bps)。 可以为以下值之一: 2400,4800,9600,19200,38400,57600,115200等。 具体的值与打印机的端口参数有关,不过最大不应超过256000。 nComDataBits [in] 指定串口通讯时的数据位数。 可以为 5 到 8。 具体的值与打印机的端口参数有关。 nComStopBits [in] 指定串口通讯时的数据停止位数。 可以为以下值之一: Flag Value Meaning POS_COM_ONESTOPBIT 0x00 停止位为1 POS_COM_ONE5STOPBITS 0x01 停止位为1.5 POS_COM_TWOSTOPBITS 0x02 停止位为2 nComParity [in] 指定串口的奇偶校验方法。 可以为以下值之一: Flag Value Meaning POS_COM_NOPARITY 0x00 无校验 POS_COM_ODDPARITY 0x01 奇校验 POS_COM_EVENPARITY 0x02 偶校验 POS_COM_MARKPARITY 0x03 标记校验 POS_COM_SPACEPARITY 0x04 空格校验 nParam [in] 指定串口的流控制(握手)方式、或表示通讯方式。请参考参数lpName的说明。 可以为以下值之一: Flag Value Meaning POS_COM_DTR_DSR 0x00 流控制为DTR/DST POS_COM_RTS_CTS 0x01 流控制为RTS/CTS POS_COM_XON_XOFF 0x02 流控制为XON/OFF POS_COM_NO_HANDSHAKE 0x03 无握手 POS_OPEN_PARALLEL_PORT 0x12 打开并口通讯端口 POS_OPEN_BYUSB_PORT 0x13 打开USB通讯端口 POS_OPEN_PRINTNAME 0X14 打开打印机驱动程序 POS_OPEN_NETPORT 0x15 打开网络接口 其中前两项也统称为硬件流控制,一般选用 RTS/CTS 方式。 返回值 如果函数调用成功,返回一个已打开的端口句柄。 如果函数调用失败,返回值为 INVALID_HANDLE_VALUE (-1)。 备注 1.如果打开的是并口(LPT1,LPT2等),那么后面的参数 nComBaudrate,nComDataBits,nComStopBits,nComParity将被忽略,可以设置为0,并且参数nParam必需指定为POS_OPEN_PARALLEL_PORT。同样,打开USB端口或打印机驱动程序,nParam必需指定为相应的参数修改。 2.如果由 lpName 指定的通讯端口被其他程序占用,那么返回值为 INVALID_HANDLE_VALUE。 3.如果参数出错,也返回INVALID_HANDLE_VALUE。 4.如果通讯端口已经打开,则会尝试关闭已经打开的端口,然后再去打开。 5.如果参数nParam指定打开USB端口,则需要安装随机附带的端口驱动程序,并把打印机配置为支持USB端口模式。 6.另请参考 POS_Close,POS_Reset。