中控考勤机SDK开发指南：接口与事件处理

中控考勤机 SDK 开发文档是一份详细的技术指南，针对 iFace系列脱机通讯开发包，主要针对中控考勤机的软件开发人员设计。这份文档于2013年9月发布，由 ZKSoftware Inc.提供，强调了版权和商标信息，其中包含了重要的开发流程和功能介绍。 **1. SDK介绍**: 文档首先概述了 SDK（软件开发工具包）的概念，它是用于简化软件开发过程，特别是与中控考勤机进行交互的关键组件。开发者可以利用 SDK 进行考勤记录下载、操作记录下载、门禁设置、用户信息管理和实时事件处理等功能。 **2. 快速开始**： - **常用词介绍**：文档列出了在开发过程中可能会用到的专业术语，帮助理解 SDK 的工作原理。 - **工作流程**：详细介绍了五个核心流程： - 考勤记录下载：从考勤机获取员工的打卡记录。 - 操作记录下载：下载设备的操作历史记录。 - 门禁设置：管理门禁权限和访问控制。 - 用户信息和生物识别模板下载：如指纹和面部模板的上传和下载。 - 实时事件接收：监听并处理设备发送的实时事件，如连接/断开、报警、门禁事件等。 **3. 属性相关介绍**：文档列举了几个关键属性及其用途，如 AccGroup（访问组）、AccTimeZones（时间区设置）、BASE64 编码、CardNumber（卡片号）、CommPort（通信端口）、ConvertBIG5（字符编码转换）、PINWidth（密码键盘宽度）等，这些都是开发者在编写代码时需要理解和配置的参数。 **4. 实时事件相关**：这部分是文档的重点，详细介绍了如何通过 RegEvent、ReadRTLog、GetRTLog 等方法来获取和处理实时事件，包括连接/断开通知（OnConnected 和 OnDisConnected）、报警（OnAlarm）、门禁状态（OnDoor）、交易异常（OnAttTransactionEx）、指纹操作（OnEnrollFingerEx、OnFinger、OnFingerFeature）等，以及新用户注册（OnNewUser）、验证（OnVerify）等关键事件。 这份文档为中控考勤机 SDK 开发者提供了详尽的指导，涵盖了从基础概念到实际操作的方方面面，确保开发者能够高效地集成和管理考勤机的功能，实现定制化的应用开发。开发者在遇到问题时，需自行解决非开发包范围内的技术难题，并注意数据安全和责任归属问题。