常见问题目录一、概述?二、常见问题问答?1、脱机SDK触发事件前需要注册?2、脱机SDKONATTTRANSACTION事件无法及时触发问题?3、脱机SDK函数使用错误导致读到脏数据?4、脱机SDK是否能够用于WEB开发?5、脱机SDK能否上传考勤记录?7、脱机SDK连接设备后是否一直不中断的问题?8、脱机SDK TCP/IP通讯连接之后是否会超时?9、脱机SDK动态生成SDK控件?10、脱机SDK开发时ONDOOR事件无法触发?11、脱机SDK关于上传用户信息时上传用户卡号的问题?12、脱机SDK能够通过卡号获取工号?13、脱机SDK网络状况差导致数据丢失?14、脱机SDK通过TCP/IP协议与机器连接失败?15、脱机SDK忘记IP地址后能否找回?16、脱机SDK写入卡信息?17、脱机SDK下载的考勤记录数据不正确?18、脱机SDK编写软件是否可以抓取指纹机的图像?19、脱机SDK上传用户信息的具体过程?20、脱机SDK从机器中下载用户指纹模板的过程?21、脱机SDK中的函数SETUSERINFO密码参数设为空?22、ICLOCK100没有标配定时喇叭响铃也不支持短消息?23、ZKFINGER普通版和标准版的区别?24、普通版的ZKFINGER SDK和指纹仪的对应?25、普通版ZKFINGER SDK的授权许可问题?26、ZK系列指纹仪使用的SDK?27、ZKFINGER SDK中降低误判率的参数?32、ZKFINGER SDK用于WEB开发无法触发某些事件?33、ZKFINGER SDK的控件被杀毒软件当作病毒?34、ZKONLINE SDK所支持的指纹仪?35、固件升级是否需要收费?一、概述1、?本文档所设计的SDK技术问题包含中控目前主要的三种SDK，脱机SDK，ZKFinger SDK，ZKOnline SDK。

2、?本文档中所涉及到的问题不仅仅包括上述三种SDK，也包括与之相关的技术问题，比如固件、SDK与机器通信涉及到的机器操作、指纹仪、指纹仪与ZKFinger的通信涉及到的技术问题等等。

3、?本文档所涉及到的Demo或者软件案例，大多为VB、Delphi、C#、VC++，此外也包含使用java的特殊情况。

SDK本身并不支持Java。

4、?文档中有些表述可能不太清楚，出现错误的地方也在所难免，欢迎大家一起讨论，宝贵意见请Email至wjfen@。

二、常见问题问答1、脱机SDK触发事件前需要注册Q：客户自己开发软件，使用我们的指纹机，连接设备后在没有进行其他操作前，按压指纹，用户指纹验证通过后，没有触发OnAttTransaction事件（其他事件像OnFinger，OnVerify也没有触发）。

A：这种情况下提示客户使用在机器连接后调用RegEvent（）函数，如果未调用此函数，那么所有的事件都不会触发。

2、脱机SDKOnAttTransaction事件无法及时触发问题Q：客户使用C#语言，软件使用vs2008，开发系统为vista（32位，实际上装了我们支持64位的控件才能用），Demo连接机器后，如果不进行其他操作，直接按压指纹，OnFinger、OnVerify事件均可触发，如果验证通过，那么OnAttTransaction事件也可以触发。

但是如果连接后先进行下载考勤记录或者调用其他数据传输量相对大的函数后，将无法触发上述几个事件，断点跟踪后发现，如果此时点“断开”按钮，或者按刚才进行操作的按钮（也或者其他可能的按钮），那么代码会执行上述几个事件对应的代码。

A：让客户在窗体（Form）中加入一个计时器，然后调用ReadRTLog（）和GetRTLog（）两个函数。

让程序定时主动去找机器“要”数据。

3、脱机SDK函数使用错误导致读到脏数据Q：客户通过自己开发的软件读取到的数据（考勤记录，用户信息等）为脏数据，比如时间不对，考勤记录一条变多条等等。

A：遇到这种问题就需要考虑客户是否在使用彩屏机，然后并没有使用我们的彩屏机专用的函数，如果函数使用错误，是会读到脏数据的。

4、脱机SDK是否能够用于Web开发Q：客户使用C#语言开发，询问脱机SDK是否能够用于Web开发。

A：不能，我们的脱机SDK主要用于与脱机的机器进行通讯，并不支持Web开发，我们的ZKOnline SDK支持Web，不过它是关于指纹比对算法在Web上的应用的。

5、脱机SDK能否上传考勤记录Q：能否通过我们的脱机SDK开发软件上传考勤记录（或者通过U盘上传），客户用来反复调试程序用。

A：不能，通过脱机SDK只能下载考勤记录，不能上传考勤记录。

6、脱机SDK将算法9.0机器中的指纹模板上产到10.0机器中能否使用。

Q：将算法9.0机器中的指纹模板上产到10.0机器中能否使用。

A：两种算法的指纹模板不能兼容，所以不能使用。

9.0算法的指纹模板大概有608B（每个），10.0算法的指纹模板大概有1.2KB（每个）。

7、通过脱机SDK连接设备后是否一直不中断的问题Q：通过我们的脱机SDK开发的软件连接设备后，连接会不会一直中断？A：从软件角度来看，不会。

但是如果外部条件发生变化，比如硬件或者其他人为、非人为因素可能导致连接中断。

8、脱机SDK TCP/IP通讯连接之后是否会超时Q：客户使用脱机SDK进行开发，通讯方式为TCP/IP,和机器连接之后过段将无法下载到数据（比如客户定时下载考勤记录），是否是因为应用程序和机器连接后过段时间会自动断开。

A：不会，可能是由于其他外部条件造成的连接中断，也有可能是应用程序本身的问题。

9、脱机SDK动态生成SDK控件Q：如果我现在用脱机SDK写程序，同时连接多台机器，那么是否需要拖n（n为机器个数）个控件到窗体中呢？你们的控件能够动态生成（开发语言VB）？A：可以。

如果拖n个控件到窗体中的话，太多控件会导致程序运行缓慢。

所以还是采用动态生成控件的形式来与机器建立连接。

类似于我们门禁机里轮巡的概念，客户可以根据自己机器的数量进行编程。

这种方法也适用于没有前台的程序，因为这种情况下只能动态生成。

10、脱机SDK开发时OnDoor事件无法触发Q：客户使用脱机SDK（开发语言VC），OnDoor事件无法触发。

客户使用门禁机F7。

A：发给客户我们的门禁机的demo，如果我们的demo中OnDoor事件触发正常，则让客户检查自己的程序。

如果我们的demo中OnDoor事件没有触发，那么可能是由于用户门禁机的接线等各种外部因素造成的，请客户按照我们的说明书等文档进行检查。

11、脱机SDK关于上传用户信息时上传用户卡号的问题Q：客户使用脱机SDK时，无法使用开发手册中的Cardnumber属性。

A：我们的开发手册中提到的Cardnumber属性实际上我们现行的SDK控件中并没有封装。

建议可以使用Set_cardnumber函数或者SetStrCardNumber（开发手册中没有），其作用和开发手册中提及的Cardnumber属性相同。

12、脱机SDK能够通过卡号获取工号Q：能否同时使用函数GetUserInfoByCard（结合set_cardnumber使用）来获取员工的工号，即通过卡号获取工号？A：不能！我们通过卡号只能得到用户的姓名，却无法得到用户的工号。

客户可以通过编写应用程序，通过对数据库的操作来实现相关的功能。

13、脱机SDK网络状况差导致数据丢失Q：我们自己开发软件来管理我们的考勤机，我们的局域网也比较大（距离也很远），相距比较远的考勤机网络不太好，然后会出现数据丢包现象（比较近的没什么问题）。

怎么解决？A：这种现象来看，通过我们的脱机SDK开发的软件是没问题的。

主要问题在于您的网络，如果问题要解决，是必须要改善远端考勤机的网络状况才行的。

14、脱机SDK通过TCP/IP协议与机器连接失败Q：使用脱机SDK通过TCP/IP协议与机器进行连接时，一直连接不上。

A：由于Connect_net（）函数比较简单，一般来讲参数不会用错。

这种情况下，主要是引导客户检查与网络连接相关的问题。

比如，电脑和机器的连接方式，通过电脑是否能够ping 通机器的IP地址，是否使用路由器或者集线器，如果是直接相连是否使用交叉线，机器和电脑ip是否存在相同网段（电脑多网段的情况下）。

15、脱机SDK忘记IP地址后能否找回Q：机器一侧的复位键是否能够改变IP地址？如果我们把键盘取掉，那么一旦忘记IP，如何能够找回？能够通过脱机SDK找回。

A：复位键不能改变IP地址。

键盘取掉后无法通过键盘是恢复出厂设置，而由于无法得知IP 地址，也就无法连接设备，故不能通过软件恢复出厂设置，所以无法找回IP地址，可以建议客户开始时将IP地址在机器里“写死”，然后在机器外壳贴相应的标签，标签上注明IP 地址和机器的编号，这样子就可以避免修改IP后忘记IP地址的情况。

16、脱机SDK写入卡信息Q：客户使用开发。

使用我们的脱机SDK无法写入卡信息（cardnumber）。

A：可能是客户在使用函数的时候，没有设置ID卡号，就直接用函数SetUserInfo（）。

在使用函数SetUserInfo()前，必须先上传ID卡号（比如使用函数set_cardnumber）。

17、脱机SDK下载的考勤记录数据不正确Q：我们使用M300机器，使用一段时间后发现通过我们的脱机SDK开发的软件下载考勤记录中多了一些多余的不该有（也不会有）的记录，验证状态中也多了一些密码验证（实际上员工都不知道密码），请问是我们软件问题吗？（固件版本号Ver6.20Aug122008，并非主流固件的版本号，客户机器是在市场上买的并没有做定制）A：这个问题首先要排除是否是我们SDK开发出来的软件的问题，排除的方式是用我们的考勤软件读取机器的数据，如果数据正常，则是客户开发软件的问题，反之，则是由于机器的问题，一般情况下是固件的问题，可以考虑给客户升级下我们的主流固件（如果客户使用的功能只是我们机器标配中的功能），问题一般都可以解决。

18、脱机SDK编写软件是否可以抓取指纹机的图像Q：使用脱机SDK编写软件是否可以抓取指纹机的图像？A：可以。

跟考勤软件中的功能类似。

（尽管我们的开发手册中说函数CaptureImage仅适用于zem100，实际上其他核心板的机器也是可以使用的）19、脱机SDK上传用户信息的具体过程Q：脱机SDK上传用户信息的具体过程是什么？A：假设现在有两个用户（设为A、B），每个用户有一个指纹模板（Ta，Tb），现在需要将他们传到指纹机中去。

如果是普通的上传方式，那么先将用户A的信息读入缓存中，然后读入用户A的指纹模板Ta，此时将A的用户信息和Ta从缓存中上传到机器中，然后再将B的用户信息读入缓存中，然后读入用户B的指纹模板Tb，此时将B的信息和Tb从缓存中上传到机器中,至此整个上传过程结束。