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 Standalone SDK самостоятельно, у ZKTeco. SolaHR никогда не включает и не распространяет его. Скачивая, вы принимаете условия лицензии ZKTeco. Используйте версию 6.3.1.37 или новее: в ней есть папка 64bit с настоящей 64-разрядной zkemkeeper.dll, соответствующей 64-разрядному коннектору. О том, где её взять, см. примечание ниже.
  2. Распакуйте пакет в любое место на ПК (например, в папку «Загрузки»).
  3. Откройте папку 64bit, щёлкните правой кнопкой мыши Register_SDK_x64.bat и выберите Запуск от имени администратора. Он скопирует файлы SDK в системную папку Windows и зарегистрирует zkemkeeper.dll за вас.
  4. В SolaHR (страница устройства, Настроить необходимое ПО) или на странице коннектора нажмите Проверить установку.
  5. Прочитайте результаты проверок. Когда все они Готово, карточка устройства перестаёт показывать Требуется настройка, и Проверить подключение работает.

Где взять SDK. ZKTeco публикует материалы по SDK в своём Центре загрузок (категория SDK) и ведёт репозиторий Standalone-SDK в своём аккаунте GitHub. На момент написания нам удалось проверить, что в репозитории лежит более старый 32-разрядный пакет (Communication Protocol SDK 6.2.4.11) и что в списке SDK Центра загрузок показаны другие SDK (модули отпечатков и видимого света); публичную ссылку на 6.3.1.37 подтвердить не удалось. Для некоторых загрузок ZKTeco нужен бесплатный вход участника. Если найти не получается, обратитесь в 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 и настоящая библиотека DLL для Windows;
  • регистрирует этот единственный файл в Windows (regsvr32);
  • если файл 32-разрядный, заставляет Windows запускать его в отдельном 32-разрядном вспомогательном процессе.

Она ничего не скачивает, не запускает другие файлы и не изменяет устройства. В целях безопасности, когда коннектор работает как служба, он регистрирует DLL только из Program Files или Windows; для 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 Запланирован, не реализован В репозитории G-SDK Suprema сказано, что загрузки переносятся в Центр загрузок Suprema (с 2 марта 2026 года), а лицензия там не указана; для загрузки может потребоваться вход партнёра. Сейчас устройства Suprema читаются через сервер BioStar 2.
Hikvision Device Network SDK Не планируется Не нужен: терминалы Hikvision читаются по ISAPI (веб-протокол). Страницы SDK Hikvision предназначены для ваших собственных проектов; для руководств разработчика ISAPI на портале TPP нужны подписанное соглашение и данные партнёра.
Anviz CrossChex SDK Не планируется Не нужен: Anviz читается по своему сетевому протоколу или через CrossChex Cloud. У Anviz есть страница загрузки SDK для ваших собственных проектов.

Ничто здесь не является юридической консультацией: всегда читайте лицензию, поставляемую с загрузкой от производителя.