pyhikvision: A Python repository from Rennbon

pyhikvision [一闪一闪亮晶晶，star一下好心情]

支持Linux,Windows下32位及64位系统
针对官方接口文档中的基础类型做了Python映射，可以简化接口出入参编写复杂度
example中实现了海康威视设备用户登录，视频实时预览等基础功能，可供参考

注：该库融入了面向对象的概念，理论上理解本库后，对于后期迭代维护复杂度会大大降低

新变动

视频预览使用tk代替win32gui，解决未响应及跨平台问题
移除PC系统类型配置
32/64位系统自动区分特定变量类型

分支 feature/rennbon 有rstp的实现，加了点异步能提升一些性能

配套理解sdk二次开发原理

pyhivision使用指南https://www.jianshu.com/p/c3c4bf3d1ef8
海康威视官方音视频技术方案对比 https://open.hikvision.com/docs/docId?productId=612781c8ec4acb28e0e1c0c3&version=%2Fff026cfc47a14e79a6c9acf21d9d8769&curNodeId=2e231666a7854dc4a2dc29b9ed06782a
官方硬件产品文档 https://open.hikvision.com/docs/docId?productId=5cda567cf47ae80dd41a54b3&version=%2F16e18c75bd644f1dbf9e8301d6fc9b73&tagPath=%E9%80%9A%E7%94%A8%E8%A7%86%E9%A2%91-%E5%AE%9E%E6%97%B6%E9%A2%84%E8%A7%88

提示

海康有些设备的SDK需要跟海康的技术要，官网的版本可能是对不上的，已经有部分开发者遇到这个问题了，请大家注意下，百思不得其解，找官方技术人员了解一下SDK是否对应。
错误码列表 https://open.hikvision.com/hardware/definitions/NET_DVR_GetLastError.html

macOS开发推荐

虚拟工具：https://www.parallels.cn/pd/general/ 可以直接安装Linux和windows，且可以独立到应用级别，非常适合海康威视开发，比云服务器或者docker好用

海康威视资源下载

官方资源：https://open.hikvision.com/download/5cda567cf47ae80dd41a54b3?type=10 网盘：https://pan.baidu.com/s/1xe3wXH7CYIswPgx59y4XWg 提取码:oqd5

pyhikvision最新对应SDK版本如下：

设备网络SDK V6.1.9.4_build20220412
播放库SDK V7.3.9.50_build20210106
密码重置助手 https://www.hikvision.com/cn/password-reset/#download-agreement

开发环境初始化

1. venv（推荐，PyCharm直接启动即可）

2. conda环境（需要安装conda，下载请跳转至https://anaconda.org/anaconda/conda）

packages.yml中prefix为conda env目录下子环境设置，需要结合自身系统环境修改

conda env create  -f .\packages.yml

快速启动

local_config.ini配置（主目录下config.ini修改为local_config.ini即可）

注意windows目录分隔符

[DEFAULT]
SDKPath: .dll或.so的根目录，会遍历加载，填根SDK目录即可
User: 摄像头访问用户名，需要在海康威视图形界面上自己配置
Password: 摄像头访问密码，需要在海康威视图形界面上自己配置
Port: 摄像头端口
IP: 摄像头ip

example启动方式

cd example
python xxx.py

SDK配置相关

Linux SDK加载107问题解决方案

将SDK动态库路径加入到LD_LIBRARY_PATH环境变量

# 修改系统预加载项,增加一行export
vim ~/.bashrc
export  LD_LIBRARY_PATH=$LD_LIBRARY_PATH:{官方动态库MakeAll所对应的Linux中的绝对路径}:{官方动态库MakeAll/HCNetSDKCom/在Linux中的绝对路径}
source ~/.bashrc

在/etc/ld.so/conf下增加sdk路径

# 查看配置信息
cat /etc/ld.so.conf
# 如果有以下Include，建议在ld.so.conf.d下新建文件设置，这样隔离比较干净
include ld.so.conf.d/*.conf
# 切换到指定目录
cd /etc/ld.so.conf.d

vim hikvsdk.conf
# 加入以下2个路径
{官方动态库MakeAll所对应的Linux中的绝对路径}
{官方动态库MakeAll/HCNetSDKCom/在Linux中的绝对路径}

# 保存完后执行以下命令重新加载系统.so配置
ldconfig

注意：

{官方动态库MakeAll所对应的Linux中的绝对路径} {官方动态库MakeAll/HCNetSDKCom/在Linux中的绝对路径} 相对应的系统路径需要加最后需要加"/",因为该库Python的加载逻辑中没有拼接"/" 如：

/opt/hkws/lib/
/opt/hkws/lib/HCNetSDKCom/

维护及联系：

加入讨论群，记得标注 "hksdk"，欢迎star支持

微信群(请加 WB343688972 好友或者扫码加好友, 按照指引进群)
QQ群（901635269）

Rennbon/pyhikvision