大多数终端通过网络直接读取,无需其他任何东西。少数连接类型需要在连接器电脑上使用厂商自己的 Windows 软件(即“SDK”)。目前只有ZKTeco SDK属于此类。本页说明何时需要它、如何逐步安装、各项检查的含义以及许可规则。
预览版及如实说明。SDK 路径仅通过软件模拟构建和检查,尚未在装有真实 SDK 的 Windows 电脑上运行,也未在每种型号的真实终端上运行。在真实电脑上可能不同的细节包括:注册表结构、
regsvr32的行为,以及 SDK 对某些调用的确切响应。请先在一台设备上试用。如果无法使用,内置的直接连接始终可用。
#是否需要它?
很可能不需要。对于大多数 ZKTeco 终端,请选择ZKTeco(直连):它可以读取打卡和用户、设置时钟、重启设备并编辑用户,并已在真实的 iFace702 上验证。只有在需要直连无法完成的功能时才使用 SDK 类型:
| 功能 | ZKTeco 直连 | ZKTeco SDK |
|---|---|---|
| 读取打卡、用户和设备时钟 | 是的 | 是的 |
| 编辑、添加、删除用户;设置时钟;重启 | 是的 | 是的 |
| 在设备上启用/停用用户 | 否(“此处不支持”) | 是的 |
| 在两台设备之间复制人脸和指纹 | 否 | 是的 |
| 用户照片、打卡时的快照照片 | 否 | 是的 |
| 实时打卡事件 | 否(轮询) | 是,仅经过软件测试(使用 64 位 SDK 效果最佳) |
| 电脑上需要软件 | 否 | 是:已注册的 ZKTeco SDK |
| 已在真实设备上验证 | 是(iFace702,只读功能) | 否(仅模拟) |
对设备的更改还必须在连接器页面上允许(参见安装),其中高级操作需要所有者。
#分步说明:64 位 SDK(推荐)
连接器电脑必须是 Windows(64 位),并且您需要管理员权限。
- 请自行从 ZKTeco 下载 ZKTeco Standalone SDK。SolaHR 从不捆绑或再分发它。下载时您需接受 ZKTeco 的许可条款。请使用6.3.1.37 或更高版本:其中有一个名为
64bit的文件夹,包含与 64 位连接器匹配的真正 64 位zkemkeeper.dll。关于获取方式,请参阅下方说明。 - 将安装包解压到电脑上的任意位置(例如“下载”文件夹下)。
- 打开
64bit文件夹,右键点击Register_SDK_x64.bat并选择以管理员身份运行。它会将 SDK 文件复制到 Windows 系统文件夹并为您注册zkemkeeper.dll。 - 在 SolaHR(设备页面的设置所需软件)或连接器页面中,点击验证安装。
- 查看各项检查。全部显示就绪后,设备卡片将不再显示需要设置,测试连接即可使用。
在哪里获取 SDK。ZKTeco 在其下载中心(类别SDK)发布 SDK 资料,并在其 GitHub 账号上维护一个Standalone-SDK 代码库。截至撰写时,我们可以确认该代码库中有一个较旧的32 位包(Communication Protocol SDK 6.2.4.11),并且下载中心的SDK列表显示的是其他 SDK(指纹和可见光模块);我们无法确认 6.3.1.37 有公开链接。部分 ZKTeco 下载需要免费会员登录。如果找不到,请向 ZKTeco 或其经销商索取“Standalone SDK 6.3.1.37 或更高版本,64 位”。SolaHR 中显示的链接同样未经独立验证。
#各项就绪检查的含义
| 检查 | 含义 | 如果显示“缺失” |
|---|---|---|
| Windows | 电脑运行 Windows。 | SDK 类型无法在其他系统上运行(“此连接类型无法在该电脑上运行”)。 |
| Python COM 组件 | 连接器可以与 Windows 组件(pywin32)通信。 | 属于连接器的一部分。请重新安装或升级连接器。 |
| SDK 已注册 | Windows 已识别该 SDK(zkemkeeper)。 |
以管理员身份运行Register_SDK_x64.bat。 |
| DLL 文件 | 已注册的 zkemkeeper.dll 存在于磁盘上。 |
重新注册;之后不要移动或删除这些文件。 |
| 位数 | SDK 为 32 位或 64 位,而连接器为 64 位。 | 仅限 32 位的 SDK 不能直接使用:请使用 64 位 SDK,或采用下面的备用方案。 |
每次连接测试和轮询之前都会运行就绪检查。缺少 SDK 属于一种状态,即“需要设置”:SolaHR 不会循环重试,也不会判定设备无法连接。
#备用方案:较旧的仅限 32 位的 SDK
较旧的包只有 32 位组件,64 位连接器无法直接加载。此时连接器页面会提供选择 DLL/注册(需要管理员权限;Windows 会要求您确认)。它只做以下几件事:
- 检查所选文件是否为本地文件、名称是否恰好为
zkemkeeper.dll,且是真正的 Windows DLL; - 将该文件注册到 Windows(
regsvr32); - 如果文件是 32 位的,则让 Windows 在单独的 32 位辅助进程中承载它。
它从不下载任何内容,从不运行其他文件,也从不更改设备。出于安全考虑,连接器以服务方式运行时,只会注册位于Program Files或Windows下的 DLL;对于其他位置的 DLL,需由管理员在提升权限的命令提示符中运行 solahr-dc sdk-setup --dll <path>。solahr-dc readiness 会输出当前报告,solahr-dc sdk-setup --candidates 会列出它能找到的 DLL 副本。通过此途径,实时事件可能不够可靠;如需实时事件,请使用 64 位 SDK。撤销方法:regsvr32 /u <path to dll>。卸载 Device Connect 不会影响您的 SDK 注册。
#如果 SDK 无法使用:改用内置连接
在设置所需软件面板中点击改用内置连接。确认后,SolaHR 会将连接类型改为直连,保留 IP 地址和端口,清除 SDK 设置,并重新测试设备。打卡和员工映射均予保留。未经您确认,不会切换任何内容。
#厂商许可限制及其他厂商
| 厂商 SDK | 在 Device Connect 中的状态 | 需要了解的限制 |
|---|---|---|
ZKTeco Standalone SDK(zkemkeeper) |
已实现,仅经过软件测试 | 由 ZKTeco 授权。我们不捆绑,也不能再分发:您需自行从 ZKTeco 下载并接受其条款(我们查看的 GitHub 代码库没有许可文本,请阅读您下载内容附带的条款)。仅限 Windows。注册对整台机器生效,需要管理员权限。 |
| Suprema G-SDK | 计划中,尚未实现 | Suprema 的 G-SDK 代码库说明,下载已迁移到 Suprema 下载中心(自 2026 年 3 月 2 日起),且那里未注明许可;下载可能需要合作伙伴登录。目前 Suprema 设备改为通过 BioStar 2 服务器读取。 |
| Hikvision Device Network SDK | 无计划 | 无需使用:Hikvision 终端通过 ISAPI(网络协议)读取。Hikvision 的SDK 页面面向您自己的项目;其位于TPP 门户上的 ISAPI 开发指南需要签署协议并提供合作伙伴信息。 |
| Anviz CrossChex SDK | 无计划 | 无需使用:Anviz 通过其网络协议或 CrossChex Cloud 读取。Anviz 提供面向您自己项目的SDK 下载页面。 |
此处内容不构成法律意见:请务必阅读厂商下载内容附带的许可。