Solavel 文档
中文

厂商 SDK 设置(ZKTeco)

最后更新

大多数终端通过网络直接读取,无需其他任何东西。少数连接类型需要在连接器电脑上使用厂商自己的 Windows 软件(即“SDK”)。目前只有ZKTeco SDK属于此类。本页说明何时需要它、如何逐步安装、各项检查的含义以及许可规则。

预览版及如实说明。SDK 路径仅通过软件模拟构建和检查,尚未在装有真实 SDK 的 Windows 电脑上运行,也未在每种型号的真实终端上运行。在真实电脑上可能不同的细节包括:注册表结构、regsvr32 的行为,以及 SDK 对某些调用的确切响应。请先在一台设备上试用。如果无法使用,内置的直接连接始终可用。

#是否需要它?

很可能不需要。对于大多数 ZKTeco 终端,请选择ZKTeco(直连):它可以读取打卡和用户、设置时钟、重启设备并编辑用户,并已在真实的 iFace702 上验证。只有在需要直连无法完成的功能时才使用 SDK 类型:

功能 ZKTeco 直连 ZKTeco SDK
读取打卡、用户和设备时钟 是的 是的
编辑、添加、删除用户;设置时钟;重启 是的 是的
在设备上启用/停用用户 否(“此处不支持”) 是的
在两台设备之间复制人脸和指纹 否 是的
用户照片、打卡时的快照照片 否 是的
实时打卡事件 否(轮询) 是,仅经过软件测试(使用 64 位 SDK 效果最佳)
电脑上需要软件 否 是:已注册的 ZKTeco SDK
已在真实设备上验证 是(iFace702,只读功能) 否(仅模拟)

对设备的更改还必须在连接器页面上允许(参见安装),其中高级操作需要所有者。

连接器电脑必须是 Windows(64 位),并且您需要管理员权限。

  1. 请自行从 ZKTeco 下载 ZKTeco Standalone SDK。SolaHR 从不捆绑或再分发它。下载时您需接受 ZKTeco 的许可条款。请使用6.3.1.37 或更高版本:其中有一个名为 64bit 的文件夹,包含与 64 位连接器匹配的真正 64 位 zkemkeeper.dll。关于获取方式,请参阅下方说明。
  2. 将安装包解压到电脑上的任意位置(例如“下载”文件夹下)。
  3. 打开 64bit 文件夹,右键点击Register_SDK_x64.bat并选择以管理员身份运行。它会将 SDK 文件复制到 Windows 系统文件夹并为您注册 zkemkeeper.dll。
  4. 在 SolaHR(设备页面的设置所需软件)或连接器页面中,点击验证安装。
  5. 查看各项检查。全部显示就绪后,设备卡片将不再显示需要设置,测试连接即可使用。

在哪里获取 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 下载页面。

此处内容不构成法律意见:请务必阅读厂商下载内容附带的许可。