IC卡读卡器web开发指南之云服务篇

Web开发指南RFID读写器云服务Web开发指南为了在BS结构下使用RFID读写器和IC卡读卡器，我们提供了基于ocx技术的安装包，使大家可以在web页面调用和使用IC卡读卡器，但是ocx的局限就是只能在IE浏览器中使用。为了突破这种局限，我们又发布了RFID读写器云服务，他不仅支持IE浏览器，也支持Firefox，Chrome，Safari，Opera等等主流的浏览器，让软件工程师的作品无需再注明只支持IE，极大的提高用户体验。RFID读写器云服务是为RFID读写器和IC卡读卡器为在BS结构下，更方便更容易更稳定的嵌入到各种主流的浏览器中提供的的数据流服务。RFID读写器云服务采用js脚本，无需ocx控件嵌入，通过异步回调的方式，就可以在web端实现IC卡的读写。RFID读写器云服务支持的RFID读写器有YW-605HA，YW-607等Web开发指南Web端开发指南首先包含js文件<scriptlanguage="javascript"src="http://127.0.0.1:8008/YOWOCloudRFIDReader.js"></script>在自己的文件中引用类：YOWORFIDReader，如下代码创建一个读卡器的object。varrfidreader=YOWORFIDReader.createNew();然后就可以使用。类YOWORFIDReader的输入输出图：Web开发指南类YOWORFIDReader的属性：属性名类型默认值名称备注Connnetedboolfalse是否连接云服务Version字符串“”云服务版本云服务的版本号，如“1.0.0.0”，此版本号可以通过回调函数取得ReaderID数字1读卡器ID此参数在使用USB接口的读卡器时可以忽略，无须设置。UID数字0自己定义的序号自定义序号会随着回调函数返回，即可以在回调函数中确定是在哪里调用函数的。但是前Web开发指南提是这个序号必须是唯一的。RequestActive数字1寻卡模式0：寻所有的卡1：寻激活的卡所有的卡，包括了halt休眠的卡，激活的卡不含halt休眠的卡。KeyMode数字0密钥类型0：A密钥1：B密钥KeyString字符串"FFFFFFFFFFFF"密钥字符串如果是16进制字符串，必须是6字节12个16进制字符。如果是普通字符串可以随意长度，不足部分自动补0x00，超出部分自动截掉。KeyStringMode数字0密钥字符串的格式0：16进制字符串1：普通字符串Repeat数字0重复执行标志重复执行得情况下，如果执行成功，通过回调函数返回结果，Web开发指南0：只执行一次1：重复执行如果失败，则不返回任何结果。只执行一次的情况下，不管成功还是失败都会通过回调函数返回结果。BeepOnSuccess数字1如果函数执行成功，蜂鸣器Beep次数BeepOnFail数字0如果函数执行失败，蜂鸣器Beep次数HaltAfterSuccess数字0如果函数执行成功，是否将卡休眠0：不休眠1：休眠类YOWORFIDReader的回调函数：onResult可以做如下调用：rfidreader.onResult(function(resultdata){}Web开发指南参数resultdata是一个结构，结构类型如下：FunctionID：数字，执行的函数编号,Result：数字，函数执行后的返回值,小于0位失败，大于0为成功。UID：数字，执行函数前，自定义的序号,ReaderID：数字，读卡器的ID,CardNo：字符串，所操作的卡的卡号，16进制正常顺序,strData：字符串，执行函数根据函数参数返回的数据,ValData：数字，执行函数根据函数参数返回数字结果。类YOWORFIDReader的：1、寻TypeA卡的卡号，包含M1卡RequestTypeACardNo(FormatID,OrderID)参数：FormatID，返回的卡号格式，0：16进制(8HEX)，1：10进制(10DEC).OrderID,卡号的现实顺序，0：正常顺序，1：倒序回调函数返回结果：FunctionID=0，Result：数字，函数执行后的返回值,UID：自定义的序号,Web开发指南CardNo：所操作的卡的卡号，16进制正常顺序,strData：字符串，执行函数根据函数参数给定的格式的卡号,2、寻二代证的卡号，不是证件号码RequestChinaIDCardNo()参数：无回调函数返回结果：FunctionID=3，Result：数字，函数执行后的返回值,UID：自定义的序号,CardNo：所操作的卡的卡号，16进制正常顺序,strData：所操作的卡的卡号，16进制正常顺序,3、寻15693卡的卡号Request15693CardUID()参数：无回调函数返回结果：Web开发指南FunctionID=2，Result：数字，函数执行后的返回值,UID：自定义的序号,CardNo：所操作的卡的卡号，16进制正常顺序,strData：所操作的卡的卡号，16进制正常顺序,4、M1卡读块M1ReadBlock(blockIndex，FormatID)参数：blockIndex，块号，绝对地址，从0开始FormatID，格式，0：16进制字符串返回，1：普通字符串返回。回调函数返回结果：FunctionID=5，Result：数字，函数执行后的返回值,UID：自定义的序号,CardNo：所操作的卡的卡号，16进制正常顺序,strData：根据参数返回的块数据,5、M1卡写块M1WriteBlock(blockindex,blockdata,FormatIDWeb开发指南参数：blockIndex，块号，绝对地址，从0开始blockdata：要写入的字符串，由于M1卡的每块为16字节，故blockdata最终转换的16进制不够16字节长度，后面将补0x00，如果超过16字节，将去掉多余的字节。FormatID，格式，0：16进制字符串返回，1：普通字符串返回。回调函数返回结果：FunctionID=6，Result：数字，函数执行后的返回值,UID：自定义的序号,CardNo：所操作的卡的卡号，16进制正常顺序,strData：实际写入的数据的16进制字符串,6、M1卡读扇区M1ReadSector(sectorindex，FormatID)参数：blockIndex，块号，绝对地址，从0开始FormatID，格式，0：16进制字符串返回，1：普通字符串返回。回调函数返回结果：FunctionID=7，Result：数字，函数执行后的返回值,Web开发指南UID：自定义的序号,CardNo：所操作的卡的卡号，16进制正常顺序,strData：根据参数返回的扇区数据,7、M1卡写扇区M1WriteSectorn(blockindex,blockdata,FormatID)参数：blockIndex，块号，绝对地址，从0开始blockdata：要写入的字符串，由于M1卡的扇区有4块和16块，可用字节为48字节和240字节故blockdata最终转换的16进制不够字节长度，后面将补0x00，如果超过字节长度，将去掉多余的字节。FormatID，格式，0：16进制字符串返回，1：普通字符串返回。回调函数返回结果：FunctionID=8，Result：数字，函数执行后的返回值,UID：自定义的序号,CardNo：所操作的卡的卡号，16进制正常顺序,strData：实际写入的数据的16进制字符串,Web开发指南8、M1卡初始化钱包M1IntialValue(blockIndex,value)参数：blockIndex，块号，绝对地址，从0开始value：要初始化的值回调函数返回结果：FunctionID=9，Result：数字，函数执行后的返回值,UID：自定义的序号,CardNo：所操作的卡的卡号，16进制正常顺序,strData：要初始化的值,ValData：初始化后的余额,9、M1卡获取钱包余额M1GetValue(blockIndex)参数：blockIndex，块号，绝对地址，从0开始回调函数返回结果：FunctionID=10，Result：数字，函数执行后的返回值,UID：自定义的序号,Web开发指南CardNo：所操作的卡的卡号，16进制正常顺序,strData：钱包余额,ValData：钱包余额,10、M1卡钱包充值M1IncreaseValue(blockIndex,value)参数：blockIndex，块号，绝对地址，从0开始value：要充值的值回调函数返回结果：FunctionID=11，Result：数字，函数执行后的返回值,UID：自定义的序号,CardNo：所操作的卡的卡号，16进制正常顺序,strData：要充值的值,ValData：充值后的钱包余额,11、M1卡钱包消费，即减值M1DecreaseValue(blockIndex,value)参数：blockIndex，块号，绝对地址，从0开始Web开发指南value：要减值的值回调函数返回结果：FunctionID=12，Result：数字，函数执行后的返回值,UID：自定义的序号,CardNo：所操作的卡的卡号，16进制正常顺序,strData：要减值的值,ValData：减值后的钱包余额,12、蜂鸣器鸣叫Beep(TimeOn,TimeOff,Times)参数：TimeOn，鸣叫的时间(*100ms)TimeOff,：不鸣叫的时间(*100ms)Times,：循环的次数注：蜂鸣器函数在类属性中可以配置每次执行后的动作，一般不需要单独调用。回调函数返回结果：Web开发指南FunctionID=13，Result：数字，函数执行后的返回值,UID：自定义的序号,13、获取云服务的版本Ver()参数：无注：在连接云服务时，自动调用了Ver()函数，中途可以通过Version属性获取或者在回调函数中读取。回调函数返回结果：FunctionID=14，Result：数字，函数执行后的返回值,UID：自定义的序号,strData：版本号,14、断开云服务连接Disconnect()参数：无Web开发指南注：断开云服务连接，一般在页面的unload中调用。