以前做过的项目都是通过 ffmpeg c++ 来捕获摄像机的 RSTP 视频流来处理视频帧,抽空看了一下海康的SDK说明,使用 python ctypes方式实现了对海康SDK DLL的调用, 可以对视频预览、抓图、抽帧、云台控制、布防等任务,SDK使用C++库,速度也很快。如果不要求对视频帧进行实时智能算法分析的话,python的速度也能满足要求,而且开发效率高。
下面简介一下开发流程与关键步骤。
1、海康SDK开发包简介
在海康威视官网注册后,可以下载开发最新的SDK,其中包含说明书。
海康 SDK 构成与其它C/C++的SDK是类似的,主要由 头文件,库文件( ,lib, .so) 以及静态链接库DLL组成, linux下库文件只有.so。
python项目导入SDK 相当简单,只需要将相关DLL文件拷贝至python项目文件夹,主要是下面几个文件
- HCNetSDK.dll
- HCCore.dll
- HCPreview.dll
- PlayCtrl.dll
- HCCoreDevCfg.dll
或者将dll文件放入1个特定文件夹,然后将此文件夹路径加入到系统环境变量path中。总之,只要程序运行时可以找到 DLL 就可以。
2、调用SDK的基本流程
说明书上写得很详细,以实现预览的过程为例,流程如下:
3、主要步骤介绍
1)如何导入SDK DLL
python如何调用 C/C++ DLL,请参考本人文章:Python 使用 ctypes 调用 C/C++ DLL 动态链接库
由于海康的接口较多,对每个接口函数及参数重新申明,这是个体力活。因此建议大家在学习完ctypes以后,参考本文,自己用python ctypes 语法来封装你所需要的海康SDK 接口。
用 ctypes 调用sdk函数的方式,基本思路是:
- 先用ctype来声明 SDK接口函数的形参与返回值,目的是python代码类型与 C++类型能匹配上
- 建议采用签名函数方式,分别申明函数参数argstypes,返回值类型 restype,好处是使用结构清晰。
也可以使用 Cython 来调用海康SDK,调用速度可以直接与C++编程相比了。然而,Cython学习的难度明显高于 ctypes,如果C++平时用得少,不建议用 Cython.
用ctypes 声明 SDK接口函数的形参与返回值
首先要做的就是用python ctypes 将 DLL中的接口函数的形参重新定义。如 SDK中注册设备的方法。两个形参是结构指针,python中没有直接对应的类型,因此需要通过ctypes 类型重新定义:
LONG NET_DVR_Login_V40(
LPNET_DVR_USER_LOGIN_INFO pLoginInfo,
LPNET_DVR_DEVICEINFO_V40 lpDeviceInfo
);
NET_DVR_Login_V40()参数用 python ctypes 申明
# NET_DVR_Login_V40()参数
class NET_DVR_USER_LOGIN_INFO(Structure):
_fields_ = [
("sDeviceAddress", c_char * 129), # 设备地址,IP 或者普通域名
("byUseTransport", c_byte), # 是否启用能力集透传:0- 不启用透传,默认;1- 启用透传
("wPort", c_uint16), # 设备端口号,例如:8000
("sUserName", c_char * 64), # 登录用户名,例如:admin
("sPassword", c_char * 64), # 登录密码,例如:12345
("cbLoginResult", fLoginResultCallBack), # 登录状态回调函数,bUseAsynLogin 为1时有效
("pUser", c_void_p), # 用户数据
("bUseAsynLogin", c_uint32), # 是否异步登录:0- 否,1- 是
("byProxyType", c_byte), # 0:不使用代理,1:使用标准代理,2:使用EHome代理
("byUseUTCTime", c_byte),
# 0-不进行转换,默认,1-接口上输入输出全部使用UTC时间,SDK完成UTC时间与设备时区的转换,2-接口上输入输出全部使用平台本地时间,SDK完成平台本地时间与设备时区的转换
("byLoginMode", c_byte), # 0-Private 1-ISAPI 2-自适应
("byHttps", c_byte), # 0-不适用tls,1-使用tls 2-自适应
("iProxyID", c_uint32), # 代理服务器序号,添加代理服务器信息时,相对应的服务器数组下表值
("byVerifyMode", c_byte), # 认证方式,0-不认证,1-双向认证,2-单向认证;认证仅在使用TLS的时候生效;
("byRes2", c_byte * 119)]
LPNET_DVR_USER_LOGIN_INFO = POINTER(NET_DVR_USER_LOGIN_INFO)
设备参数结构体 V40
# 设备参数结构体 V40
class NET_DVR_DEVICEINFO_V40(ctypes.Structure):
_fields_ = [
('struDeviceV30', NET_DVR_DEVICEINFO_V30), # 设备信息
('bySupportLock', c_byte), # 设备支持锁定功能,该字段由SDK根据设备返回值来赋值的。bySupportLock为1时,dwSurplusLockTime和byRetryLoginTime有效
('byRetryLoginTime', c_byte), # 剩余可尝试登陆的次数,用户名,密码错误时,此参数有效
('byPasswordLevel', c_byte), # admin密码安全等级
('byProxyType', c_byte), # 代理类型,0-不使用代理, 1-使用socks5代理, 2-使用EHome代理
('dwSurplusLockTime', c_uint32), # 剩余时间,单位秒,用户锁定时,此参数有效
('byCharEncodeType', c_byte), # 字符编码类型
('bySupportDev5', c_byte), # 支持v50版本的设备参数获取,设备名称和设备类型名称长度扩展为64字节
('bySupport', c_byte), # 能力集扩展,位与结果:0- 不支持,1- 支持
('byLoginMode', c_byte), # 登录模式:0- Private登录,1- ISAPI登录
('dwOEMCode', c_uint32), # OEM Code
('iResidualValidity', c_uint32), # 该用户密码剩余有效天数,单位:天,返回负值,表示密码已经超期使用,例如“-3表示密码已经超期使用3天”
('byResidualValidity', c_byte), # iResidualValidity字段是否有效,0-无效,1-有效
('bySingleStartDTalkChan', c_byte), # 独立音轨接入的设备,起始接入通道号,0-为保留字节,无实际含义,音轨通道号不能从0开始
('bySingleDTalkChanNums', c_byte), # 独立音轨接入的设备的通道总数,0-表示不支持
('byPassWordResetLevel', c_byte), # 0-无效,
# 1- 管理员创建一个非管理员用户为其设置密码,该非管理员用户正确登录设备后要提示“请修改初始登录密码”,未修改的情况下,用户每次登入都会进行提醒;
# 2- 当非管理员用户的密码被管理员修改,该非管理员用户再次正确登录设备后,需要提示“请重新设置登录密码”,未修改的情况下,用户每次登入都会进行提醒。
('bySupportStreamEncrypt', c_byte), # 能力集扩展,位与结果:0- 不支持,1- 支持
# bySupportStreamEncrypt & 0x1 表示是否支持RTP/TLS取流
# bySupportStreamEncrypt & 0x2 表示是否支持SRTP/UDP取流
# bySupportStreamEncrypt & 0x4 表示是否支持SRTP/MULTICAST取流
('byMarketType', c_byte), # 0-无效(未知类型),1-经销型,2-行业型
('byRes2', c_byte * 238) #保留,置为0
]
LPNET_DVR_DEVICEINFO_V40 = POINTER(NET_DVR_DEVICEINFO_V40)
调用sdk函数示例
下面用注册设备函数 NET_DVR_Login_V40 为例,展示初始化参数,赋值,调用dll函数步骤:def LoginDev(sdk):
# 登录注册设备
'''
device_info = NET_DVR_DEVICEINFO_V30()
lUserId = Objdll.NET_DVR_Login_V30(
DEV_IP, DEV_PORT, DEV_USER_NAME, DEV_PASSWORD, byref(device_info))
'''
# 用户注册设备
# c++传递进去的是byte型数据,需要转成byte型传进去,否则会乱码
# 登录参数,包括设备地址、登录用户、密码等
struLoginInfo = NET_DVR_USER_LOGIN_INFO()
struLoginInfo.bUseAsynLogin = 0 # 同步登录方式
struLoginInfo.sDeviceAddress = bytes("192.168.99.247", "ascii") # 设备IP地址
struLoginInfo.wPort = 8000 # 设备服务端口
struLoginInfo.sUserName = bytes("admin", "ascii") # 设备登录用户名
struLoginInfo.sPassword = bytes("123456", "ascii") # 设备登录密码
struLoginInfo.byLoginMode = 0
struDeviceInfoV40 = NET_DVR_DEVICEINFO_V40()
UserID = sdk.NET_DVR_Login_V40(
byref(struLoginInfo), byref(struDeviceInfoV40))
return (UserID, struDeviceInfoV40)
其它sdk函数调用过程也是类似的。
2) 开发框架说明
因为本文只是写1个demo程序,采用了 Python Tkinter 编写GUI界面,也可以使用PyQt 来写。
3) 几个技术点说明
设备注册后,必须要调用 NET_DVR_RealPlay_V40() 函数进行预览摄像头画面,后面的抓图、读帧以及云台控制均要求先执行这一步。
C++ SDK中该函数定义如下:
LONG NET_DVR_RealPlay_V40(
LONG lUserID,
LPNET_DVR_PREVIEWINFO lpPreviewInfo,
REALDATACALLBACK fRealDataCallBack_V30,
void *pUser);
可以有1个回调函数 REALDATACALLBACK
typedef void(CALLBACK *REALDATACALLBACK)(
LONG lRealHandle,
DWORD dwDataType,
BYTE *pBuffer,
DWORD dwBufSize,
void *pUser);
注意要计划好显示视频的窗口控件,获取该窗口的句柄,传给NET_DVR_RealPlay_V40
,或回调函数。
捕获视频码流以及解码显示均由该回调函数完成,捕获原始的YUV视频帧也在此进行。
如果要对视频进行分析,有两种方法
1)通过sdk的抓图接口函数抓图进行分析,如 NET_DVR_CapturePicture
2) 实时性要求高,可将预览码流中的原始YUV帧l转换为RGB后,再进行
处理。
- 代码如下
主模块 main.py 代码如下
# coding=utf-8
import os
import platform
import tkinter
from tkinter import *
from tkinter import ttk
from HCNetSDK import *
from PlayCtrl import *
from time import sleep
import ctypes
# 登录的设备信息
WINDOWS_FLAG = True
win = None # 预览窗口
funcRealDataCallBack_V30 = None # 实时预览回调函数,需要定义为全局的
PlayCtrl_Port = c_long(-1) # 播放句柄
Playctrldll = None # 播放库
FuncDecCB = None # 播放库解码回调函数,需要定义为全局的
# 获取当前系统环境
def GetPlatform():
sysstr = platform.system()
print('' + sysstr)
if sysstr != "Windows":
global WINDOWS_FLAG
WINDOWS_FLAG = False
# 设置SDK初始化依赖库路径
def SetSDKInitCfg():
# 设置HCNetSDKCom组件库和SSL库加载路径
# print(os.getcwd())
if WINDOWS_FLAG:
strPath = os.getcwd().encode('gbk')
sdk_ComPath = NET_DVR_LOCAL_SDK_PATH()
sdk_ComPath.sPath = strPath
Objdll.NET_DVR_SetSDKInitCfg(2, byref(sdk_ComPath))
Objdll.NET_DVR_SetSDKInitCfg(3, create_string_buffer(
strPath + b'\libcrypto-1_1-x64.dll'))
Objdll.NET_DVR_SetSDKInitCfg(
4, create_string_buffer(strPath + b'\libssl-1_1-x64.dll'))
else:
strPath = os.getcwd().encode('utf-8')
sdk_ComPath = NET_DVR_LOCAL_SDK_PATH()
sdk_ComPath.sPath = strPath
Objdll.NET_DVR_SetSDKInitCfg(2, byref(sdk_ComPath))
Objdll.NET_DVR_SetSDKInitCfg(
3, create_string_buffer(strPath + b'/libcrypto.so.1.1'))
Objdll.NET_DVR_SetSDKInitCfg(
4, create_string_buffer(strPath + b'/libssl.so.1.1'))
def LoginDev(sdk):
# 登录注册设备
'''
device_info = NET_DVR_DEVICEINFO_V30()
lUserId = Objdll.NET_DVR_Login_V30(
DEV_IP, DEV_PORT, DEV_USER_NAME, DEV_PASSWORD, byref(device_info))
'''
# 用户注册设备
# c++传递进去的是byte型数据,需要转成byte型传进去,否则会乱码
# 登录参数,包括设备地址、登录用户、密码等
struLoginInfo = NET_DVR_USER_LOGIN_INFO()
struLoginInfo.bUseAsynLogin = 0 # 同步登录方式
struLoginInfo.sDeviceAddress = bytes("192.168..200", "ascii") # 设备IP地址
struLoginInfo.wPort = 8000 # 设备服务端口
struLoginInfo.sUserName = bytes("admin", "ascii") # 设备登录用户名
struLoginInfo.sPassword = bytes("123456", "ascii") # 设备登录密码
struLoginInfo.byLoginMode = 0
struDeviceInfoV40 = NET_DVR_DEVICEINFO_V40()
UserID = sdk.NET_DVR_Login_V40(
byref(struLoginInfo), byref(struDeviceInfoV40))
return (UserID, struDeviceInfoV40)
def DecCBFun(nPort, pBuf, nSize, pFrameInfo, nUser, nReserved2):
# 解码回调函数
if pFrameInfo.contents.nType == 3:
# 解码返回视频YUV数据,将YUV数据转成jpg图片保存到本地
# 如果有耗时处理,需要将解码数据拷贝到回调函数外面的其他线程里面处理,避免阻塞回调导致解码丢帧
sFileName = ('pic/test_stamp[%d].jpg' %
pFrameInfo.contents.nStamp)
nWidth = pFrameInfo.contents.nWidth
nHeight = pFrameInfo.contents.nHeight
nType = pFrameInfo.contents.nType
dwFrameNum = pFrameInfo.contents.dwFrameNum
nStamp = pFrameInfo.contents.nStamp
print(nWidth, nHeight, nType, dwFrameNum, nStamp, sFileName)
lRet = Playctrldll.PlayM4_ConvertToJpegFile(
pBuf, nSize, nWidth, nHeight, nType, c_char_p(sFileName.encode()))
if lRet == 0:
print('PlayM4_ConvertToJpegFile fail, error code is:',
Playctrldll.PlayM4_GetLastError(nPort))
else:
print('PlayM4_ConvertToJpegFile success')
def RealDataCallBack_V30(lPlayHandle, dwDataType, pBuffer, dwBufSize, pUser):
# 码流回调函数
if dwDataType == NET_DVR_SYSHEAD:
# 设置流播放模式
Playctrldll.PlayM4_SetStreamOpenMode(PlayCtrl_Port, 0)
# 打开码流,送入40字节系统头数据
if Playctrldll.PlayM4_OpenStream(PlayCtrl_Port, pBuffer, dwBufSize, 1024*1024):
# 设置解码回调,可以返回解码后YUV视频数据
global FuncDecCB
FuncDecCB = DECCBFUNWIN(DecCBFun)
Playctrldll.PlayM4_SetDecCallBackExMend(
PlayCtrl_Port, FuncDecCB, None, 0, None)
# 开始解码播放
if Playctrldll.PlayM4_Play(PlayCtrl_Port, cv.winfo_id()):
print(u'播放库播放成功')
else:
print(u'播放库播放失败')
else:
print(u'播放库打开流失败')
elif dwDataType == NET_DVR_STREAMDATA:
Playctrldll.PlayM4_InputData(PlayCtrl_Port, pBuffer, dwBufSize)
else:
print(u'其他数据,长度:', dwBufSize)
def OpenPreview(Objdll, lUserId, callbackFun):
'''
打开预览
'''
preview_info = NET_DVR_PREVIEWINFO()
preview_info.hPlayWnd = 0
preview_info.lChannel = 1 # 通道号lk在
preview_info.dwStreamType = 0 # 主码流
preview_info.dwLinkMode = 0 # TCP
preview_info.bBlocked = 1 # 阻塞取流
preview_info.dwDisplayBufNum = 15 # 缓冲区大小,15*1024*1024
# 开始预览并且设置回调函数回调获取实时流数据
lRealPlayHandle = Objdll.NET_DVR_RealPlay_V40(
lUserId, byref(preview_info), callbackFun, None)
return lRealPlayHandle
def InputData(fileMp4, Playctrldll):
while True:
pFileData = fileMp4.read(4096)
if pFileData is None:
break
if not Playctrldll.PlayM4_InputData(PlayCtrl_Port, pFileData, len(pFileData)):
break
def click_capture():
print("clicked capture button")
# Objdll.NET_DVR_SetCapturePictureMode(1)
pFileName = ctypes.c_char_p()
pFileName.value = bytes("pic/image.jpg", "utf-8")
# 开始抓图。
res = Objdll.NET_DVR_CapturePicture(lRealPlayHandle, pFileName)
if res:
print("Successfullly capture picture, ", pFileName.value)
def click_left():
print("clicked button up")
# 因无测试条件,暂略
def click_right():
print("clicked button")
def click_up():
print("clicked button")
def click_down():
print("clicked button")
if __name__ == '__main__':
# 创建窗口
win = tkinter.Tk()
# 固定窗口大小
win.resizable(0, 0)
win.overrideredirect(True)
sw = win.winfo_screenwidth()
# 得到屏幕宽度
sh = win.winfo_screenheight()
# 得到屏幕高度
# 窗口宽高
ww = 800
wh = 650
x = (sw - ww) / 2
y = (sh - wh) / 2
win.geometry("%dx%d+%d+%d" % (ww, wh, x, y))
# 创建一个Canvas,设置其背景色为白色
cv = Canvas(
win,
width=760,
height=460,
bg="white",
)
cv.place(x=20, y=10)
# 创建退出按键
btn_left = Button(win, text=" 左 ",
command=click_left).place(x=100, y=530)
btn_right = Button(win, text=" 右 ",
command=click_right).place(x=180, y=530)
btn_top = Button(win, text=" 上 ", command=click_up).place(x=145, y=495)
btn_down = Button(win, text=" 下 ",
command=click_down).place(x=145, y=565)
btn_capture = Button(win, text=" 放大 ",
command=click_capture).place(x=280, y=500)
btn_capture = Button(win, text=" 缩小 ",
command=click_capture).place(x=280, y=530)
btn_capture = Button(win, text=" 截图 ",
command=click_capture).place(x=280, y=560)
lbl_ip = Label(win, text="IP地址", fg="#111").place(x=480, y=490)
ent_ip = Entry(win).place(x=550, y=490)
lbl_port = Label(win, text="端口", fg="#111").place(x=480, y=515)
ent_port = Entry(win).place(x=550, y=515)
lbl_name = Label(win, text="登录名", fg="#111").place(x=480, y=540)
ent_name = Entry(win).place(x=550, y=540)
lbl_password = Label(win, text="密码", fg="#111").place(x=480, y=565)
password = StringVar()
password_entry = ttk.Entry(
win,
textvariable=password,
show='*'
)
password_entry.place(x=550, y=565)
separator = ttk.Separator(win, orient='horizontal')
separator.place(x=10, y=600, width=790)
btn_q = Button(win, text=' 退出 ', command=win.quit)
btn_q.place(x=660, y=610)
# 加载库,先加载依赖库
dname = 'D:\workplace\dependency\hik_lib\HCNetSDK.dll'
# Objdll = ctypes.CDLL('lib/HCNetSDK.dll') # 加载网络库
Objdll = ctypes.cdll.LoadLibrary(dname)
# Playctrldll = ctypes.CDLL('lib/PlayCtrl.dll') # 加载播放库
dname = 'D:\workplace\dependency\hik_lib\PlayCtrl.dll'
Playctrldll = ctypes.cdll.LoadLibrary(dname)
print("load dll successfully")
# SetSDKInitCfg() # 设置组件库和SSL库加载路径
# 初始化DLL
Objdll.NET_DVR_Init()
print("init device successfully ")
# 启用SDK写日志
Objdll.NET_DVR_SetLogToFile(
3, bytes('./SdkLog_Python/', encoding="utf-8"), False)
print("config log to SdkLog_Python ")
# 获取一个播放句柄
if not Playctrldll.PlayM4_GetPort(byref(PlayCtrl_Port)):
print(u'获取播放库句柄失败')
# 登录设备
(lUserId, device_info) = LoginDev(Objdll)
if lUserId < 0:
err = Objdll.NET_DVR_GetLastError()
print('Login device fail, error code is: %d' %
Objdll.NET_DVR_GetLastError())
# 释放资源
Objdll.NET_DVR_Cleanup()
exit()
print("login device ")
# 定义码流回调函数
funcRealDataCallBack_V30 = REALDATACALLBACK(RealDataCallBack_V30)
# 开启预览
lRealPlayHandle = OpenPreview(Objdll, lUserId, funcRealDataCallBack_V30)
if lRealPlayHandle < 0:
print('Open preview fail, error code is: %d' %
Objdll.NET_DVR_GetLastError())
# 登出设备
Objdll.NET_DVR_Logout(lUserId)
# 释放资源
Objdll.NET_DVR_Cleanup()
exit()
# show Windows
win.mainloop()
# 关闭预览
Objdll.NET_DVR_StopRealPlay(lRealPlayHandle)
# 停止解码,释放播放库资源
if PlayCtrl_Port.value > -1:
Playctrldll.PlayM4_Stop(PlayCtrl_Port)
Playctrldll.PlayM4_CloseStream(PlayCtrl_Port)
Playctrldll.PlayM4_FreePort(PlayCtrl_Port)
PlayCtrl_Port = c_long(-1)
# 登出设备
Objdll.NET_DVR_Logout(lUserId)
# 释放资源
Objdll.NET_DVR_Cleanup()
PlayCtrl.py源码
# coding=utf-8
from ctypes import *
import sys
# 回调函数类型定义
if 'linux' in sys.platform:
fun_ctype = CFUNCTYPE
else:
fun_ctype = WINFUNCTYPE
# 定义预览参数结构体
class FRAME_INFO(Structure):
pass
LPFRAME_INFO = POINTER(FRAME_INFO)
FRAME_INFO._fields_ = [
('nWidth', c_uint32),
('nHeight', c_uint32),
('nStamp', c_uint32),
('nType', c_uint32),
('nFrameRate', c_uint32),
('dwFrameNum', c_uint32)
]
# 显示回调函数
DISPLAYCBFUN = fun_ctype(None, c_long, c_char_p, c_long, c_long, c_long, c_long, c_long, c_long)
# 解码回调函数
DECCBFUNWIN = fun_ctype(None, c_long, POINTER(c_char), c_long, POINTER(FRAME_INFO), c_void_p, c_void_p)
HCNetSDK.py源码
# coding=utf-8
import ctypes
import sys
from ctypes import *
# 回调函数类型定义
if 'linux' in sys.platform:
fun_ctype = CFUNCTYPE
else:
fun_ctype = WINFUNCTYPE
# 云台控制命令
LIGHT_PWRON = 2 #接通灯光电源
WIPER_PWRON = 3 #接通雨刷开关
FAN_PWRON = 4 #接通风扇开关
HEATER_PWRON = 5 #接通加热器开关
AUX_PWRON1 = 6 #接通辅助设备开关
AUX_PWRON2 = 7 #接通辅助设备开关
ZOOM_IN = 11 #焦距变大(倍率变大)
ZOOM_OUT = 12 #焦距变小(倍率变小)
FOCUS_NEAR = 13 #焦点前调
FOCUS_FAR = 14 #焦点后调
IRIS_OPEN = 15 #光圈扩大
IRIS_CLOSE = 16 #光圈缩小
TILT_UP = 21 #云台上仰
TILT_DOWN = 22 #云台下俯
PAN_LEFT = 23 #云台左转
PAN_RIGHT = 24 #云台右转
UP_LEFT = 25 #云台上仰和左转
UP_RIGHT = 26 #云台上仰和右转
DOWN_LEFT = 27 #云台下俯和左转
DOWN_RIGHT = 28 #云台下俯和右转
PAN_AUTO = 29 #云台左右自动扫描
TILT_DOWN_ZOOM_IN = 58 #云台下俯和焦距变大(倍率变大)
TILT_DOWN_ZOOM_OUT = 59 #云台下俯和焦距变小(倍率变小)
PAN_LEFT_ZOOM_IN = 60 #云台左转和焦距变大(倍率变大)
PAN_LEFT_ZOOM_OUT = 61 #云台左转和焦距变小(倍率变小)
PAN_RIGHT_ZOOM_IN = 62 #云台右转和焦距变大(倍率变大)
PAN_RIGHT_ZOOM_OUT = 63 #云台右转和焦距变小(倍率变小)
UP_LEFT_ZOOM_IN = 64 #云台上仰和左转和焦距变大(倍率变大)
UP_LEFT_ZOOM_OUT = 65 #云台上仰和左转和焦距变小(倍率变小)
UP_RIGHT_ZOOM_IN = 66 #云台上仰和右转和焦距变大(倍率变大)
UP_RIGHT_ZOOM_OUT = 67 #云台上仰和右转和焦距变小(倍率变小)
DOWN_LEFT_ZOOM_IN = 68 #云台下俯和左转和焦距变大(倍率变大)
DOWN_LEFT_ZOOM_OUT = 69 #云台下俯和左转和焦距变小(倍率变小)
DOWN_RIGHT_ZOOM_IN = 70 #云台下俯和右转和焦距变大(倍率变大)
DOWN_RIGHT_ZOOM_OUT = 71 #云台下俯和右转和焦距变小(倍率变小)
TILT_UP_ZOOM_IN = 72 #云台上仰和焦距变大(倍率变大)
TILT_UP_ZOOM_OUT = 73 #云台上仰和焦距变小(倍率变小)
# 码流回调数据类型
NET_DVR_SYSHEAD = 1
NET_DVR_STREAMDATA = 2
NET_DVR_AUDIOSTREAMDATA = 3
NET_DVR_PRIVATE_DATA = 112
# 设备参数结构体 V30
class NET_DVR_DEVICEINFO_V30(ctypes.Structure):
_fields_ = [
("sSerialNumber", c_byte * 48), # 序列号
("byAlarmInPortNum", c_byte), # 模拟报警输入个数
("byAlarmOutPortNum", c_byte), # 模拟报警输出个数
("byDiskNum", c_byte), # 硬盘个数
("byDVRType", c_byte), # 设备类型
("byChanNum", c_byte), # 设备模拟通道个数,数字(IP)通道最大个数为byIPChanNum + byHighDChanNum*256
("byStartChan", c_byte), # 模拟通道的起始通道号,从1开始。数字通道的起始通道号见下面参数byStartDChan
("byAudioChanNum", c_byte), # 设备语音对讲通道数
("byIPChanNum", c_byte), # 设备最大数字通道个数,低8位,高8位见byHighDChanNum
("byZeroChanNum", c_byte), # 零通道编码个数
("byMainProto", c_byte), # 主码流传输协议类型:0- private,1- rtsp,2- 同时支持私有协议和rtsp协议取流(默认采用私有协议取流)
("bySubProto", c_byte), # 子码流传输协议类型:0- private,1- rtsp,2- 同时支持私有协议和rtsp协议取流(默认采用私有协议取流)
("bySupport", c_byte), # 能力,位与结果为0表示不支持,1表示支持
# bySupport & 0x1,表示是否支持智能搜索
# bySupport & 0x2,表示是否支持备份
# bySupport & 0x4,表示是否支持压缩参数能力获取
# bySupport & 0x8, 表示是否支持双网卡
# bySupport & 0x10, 表示支持远程SADP
# bySupport & 0x20, 表示支持Raid卡功能
# bySupport & 0x40, 表示支持IPSAN目录查找
# bySupport & 0x80, 表示支持rtp over rtsp
("bySupport1", c_byte), # 能力集扩充,位与结果为0表示不支持,1表示支持
# bySupport1 & 0x1, 表示是否支持snmp v30
# bySupport1 & 0x2, 表示是否支持区分回放和下载
# bySupport1 & 0x4, 表示是否支持布防优先级
# bySupport1 & 0x8, 表示智能设备是否支持布防时间段扩展
# bySupport1 & 0x10,表示是否支持多磁盘数(超过33个)
# bySupport1 & 0x20,表示是否支持rtsp over http
# bySupport1 & 0x80,表示是否支持车牌新报警信息,且还表示是否支持NET_DVR_IPPARACFG_V40配置
("bySupport2", c_byte), # 能力集扩充,位与结果为0表示不支持,1表示支持
# bySupport2 & 0x1, 表示解码器是否支持通过URL取流解码
# bySupport2 & 0x2, 表示是否支持FTPV40
# bySupport2 & 0x4, 表示是否支持ANR(断网录像)
# bySupport2 & 0x20, 表示是否支持单独获取设备状态子项
# bySupport2 & 0x40, 表示是否是码流加密设备
("wDevType", c_uint16), # 设备型号,详见下文列表
("bySupport3", c_byte), # 能力集扩展,位与结果:0- 不支持,1- 支持
# bySupport3 & 0x1, 表示是否支持多码流
# bySupport3 & 0x4, 表示是否支持按组配置,具体包含通道图像参数、报警输入参数、IP报警输入/输出接入参数、用户参数、设备工作状态、JPEG抓图、定时和时间抓图、硬盘盘组管理等
# bySupport3 & 0x20, 表示是否支持通过DDNS域名解析取流
("byMultiStreamProto", c_byte), # 是否支持多码流,按位表示,位与结果:0-不支持,1-支持
# byMultiStreamProto & 0x1, 表示是否支持码流3
# byMultiStreamProto & 0x2, 表示是否支持码流4
# byMultiStreamProto & 0x40,表示是否支持主码流
# byMultiStreamProto & 0x80,表示是否支持子码流
("byStartDChan", c_byte), # 起始数字通道号,0表示无数字通道,比如DVR或IPC
("byStartDTalkChan", c_byte), # 起始数字对讲通道号,区别于模拟对讲通道号,0表示无数字对讲通道
("byHighDChanNum", c_byte), # 数字通道个数,高8位
("bySupport4", c_byte), # 能力集扩展,按位表示,位与结果:0- 不支持,1- 支持
# bySupport4 & 0x01, 表示是否所有码流类型同时支持RTSP和私有协议
# bySupport4 & 0x10, 表示是否支持域名方式挂载网络硬盘
("byLanguageType", c_byte), # 支持语种能力,按位表示,位与结果:0- 不支持,1- 支持
# byLanguageType ==0,表示老设备,不支持该字段
# byLanguageType & 0x1,表示是否支持中文
# byLanguageType & 0x2,表示是否支持英文
("byVoiceInChanNum", c_byte), # 音频输入通道数
("byStartVoiceInChanNo", c_byte), # 音频输入起始通道号,0表示无效
("bySupport5", c_byte ), # 按位表示,0-不支持,1-支持,bit0-支持多码流
("bySupport6", c_byte), # 按位表示,0-不支持,1-支持
# bySupport6 & 0x1 表示设备是否支持压缩
# bySupport6 & 0x2 表示是否支持流ID方式配置流来源扩展命令,DVR_SET_STREAM_SRC_INFO_V40
# bySupport6 & 0x4 表示是否支持事件搜索V40接口
# bySupport6 & 0x8 表示是否支持扩展智能侦测配置命令
# bySupport6 & 0x40 表示图片查询结果V40扩展
("byMirrorChanNum", c_byte), # 镜像通道个数,录播主机中用于表示导播通道
("wStartMirrorChanNo", c_uint16), # 起始镜像通道号
("bySupport7", c_byte), # 能力,按位表示,0-不支持,1-支持
# bySupport7 & 0x1 表示设备是否支持NET_VCA_RULECFG_V42扩展
# bySupport7 & 0x2 表示设备是否支持IPC HVT 模式扩展
# bySupport7 & 0x04 表示设备是否支持返回锁定时间
# bySupport7 & 0x08 表示设置云台PTZ位置时,是否支持带通道号
# bySupport7 & 0x10 表示设备是否支持双系统升级备份
# bySupport7 & 0x20 表示设备是否支持OSD字符叠加V50
# bySupport7 & 0x40 表示设备是否支持主从跟踪(从摄像机)
# bySupport7 & 0x80 表示设备是否支持报文加密
("byRes2", c_byte)] # 保留,置为0
LPNET_DVR_DEVICEINFO_V30 = POINTER(NET_DVR_DEVICEINFO_V30)
# 设备参数结构体 V40
class NET_DVR_DEVICEINFO_V40(ctypes.Structure):
_fields_ = [
('struDeviceV30', NET_DVR_DEVICEINFO_V30), # 设备信息
('bySupportLock', c_byte), # 设备支持锁定功能,该字段由SDK根据设备返回值来赋值的。bySupportLock为1时,dwSurplusLockTime和byRetryLoginTime有效
('byRetryLoginTime', c_byte), # 剩余可尝试登陆的次数,用户名,密码错误时,此参数有效
('byPasswordLevel', c_byte), # admin密码安全等级
('byProxyType', c_byte), # 代理类型,0-不使用代理, 1-使用socks5代理, 2-使用EHome代理
('dwSurplusLockTime', c_uint32), # 剩余时间,单位秒,用户锁定时,此参数有效
('byCharEncodeType', c_byte), # 字符编码类型
('bySupportDev5', c_byte), # 支持v50版本的设备参数获取,设备名称和设备类型名称长度扩展为64字节
('bySupport', c_byte), # 能力集扩展,位与结果:0- 不支持,1- 支持
('byLoginMode', c_byte), # 登录模式:0- Private登录,1- ISAPI登录
('dwOEMCode', c_uint32), # OEM Code
('iResidualValidity', c_uint32), # 该用户密码剩余有效天数,单位:天,返回负值,表示密码已经超期使用,例如“-3表示密码已经超期使用3天”
('byResidualValidity', c_byte), # iResidualValidity字段是否有效,0-无效,1-有效
('bySingleStartDTalkChan', c_byte), # 独立音轨接入的设备,起始接入通道号,0-为保留字节,无实际含义,音轨通道号不能从0开始
('bySingleDTalkChanNums', c_byte), # 独立音轨接入的设备的通道总数,0-表示不支持
('byPassWordResetLevel', c_byte), # 0-无效,
# 1- 管理员创建一个非管理员用户为其设置密码,该非管理员用户正确登录设备后要提示“请修改初始登录密码”,未修改的情况下,用户每次登入都会进行提醒;
# 2- 当非管理员用户的密码被管理员修改,该非管理员用户再次正确登录设备后,需要提示“请重新设置登录密码”,未修改的情况下,用户每次登入都会进行提醒。
('bySupportStreamEncrypt', c_byte), # 能力集扩展,位与结果:0- 不支持,1- 支持
# bySupportStreamEncrypt & 0x1 表示是否支持RTP/TLS取流
# bySupportStreamEncrypt & 0x2 表示是否支持SRTP/UDP取流
# bySupportStreamEncrypt & 0x4 表示是否支持SRTP/MULTICAST取流
('byMarketType', c_byte), # 0-无效(未知类型),1-经销型,2-行业型
('byRes2', c_byte * 238) #保留,置为0
]
LPNET_DVR_DEVICEINFO_V40 = POINTER(NET_DVR_DEVICEINFO_V40)
# 异步登录回调函数
fLoginResultCallBack = CFUNCTYPE(None, c_uint32, c_uint32, LPNET_DVR_DEVICEINFO_V30, c_void_p)
# NET_DVR_Login_V40()参数
class NET_DVR_USER_LOGIN_INFO(Structure):
_fields_ = [
("sDeviceAddress", c_char * 129), # 设备地址,IP 或者普通域名
("byUseTransport", c_byte), # 是否启用能力集透传:0- 不启用透传,默认;1- 启用透传
("wPort", c_uint16), # 设备端口号,例如:8000
("sUserName", c_char * 64), # 登录用户名,例如:admin
("sPassword", c_char * 64), # 登录密码,例如:12345
("cbLoginResult", fLoginResultCallBack), # 登录状态回调函数,bUseAsynLogin 为1时有效
("pUser", c_void_p), # 用户数据
("bUseAsynLogin", c_uint32), # 是否异步登录:0- 否,1- 是
("byProxyType", c_byte), # 0:不使用代理,1:使用标准代理,2:使用EHome代理
("byUseUTCTime", c_byte),
# 0-不进行转换,默认,1-接口上输入输出全部使用UTC时间,SDK完成UTC时间与设备时区的转换,2-接口上输入输出全部使用平台本地时间,SDK完成平台本地时间与设备时区的转换
("byLoginMode", c_byte), # 0-Private 1-ISAPI 2-自适应
("byHttps", c_byte), # 0-不适用tls,1-使用tls 2-自适应
("iProxyID", c_uint32), # 代理服务器序号,添加代理服务器信息时,相对应的服务器数组下表值
("byVerifyMode", c_byte), # 认证方式,0-不认证,1-双向认证,2-单向认证;认证仅在使用TLS的时候生效;
("byRes2", c_byte * 119)]
LPNET_DVR_USER_LOGIN_INFO = POINTER(NET_DVR_USER_LOGIN_INFO)
# 组件库加载路径信息
class NET_DVR_LOCAL_SDK_PATH(Structure):
pass
LPNET_DVR_LOCAL_SDK_PATH = POINTER(NET_DVR_LOCAL_SDK_PATH)
NET_DVR_LOCAL_SDK_PATH._fields_ = [
('sPath', c_char * 256), # 组件库地址
('byRes', c_byte * 128),
]
# 定义预览参数结构体
class NET_DVR_PREVIEWINFO(Structure):
pass
LPNET_DVR_PREVIEWINFO = POINTER(NET_DVR_PREVIEWINFO)
NET_DVR_PREVIEWINFO._fields_ = [
('lChannel', c_uint32), # 通道号
('dwStreamType', c_uint32), # 码流类型,0-主码流,1-子码流,2-码流3,3-码流4, 4-码流5,5-码流6,7-码流7,8-码流8,9-码流9,10-码流10
('dwLinkMode', c_uint32), # 0:TCP方式,1:UDP方式,2:多播方式,3 - RTP方式,4-RTP/RTSP,5-RSTP/HTTP ,6- HRUDP(可靠传输) ,7-RTSP/HTTPS
('hPlayWnd', c_uint32), # 播放窗口的句柄,为NULL表示不播放图象
('bBlocked', c_uint32), # 0-非阻塞取流, 1-阻塞取流, 如果阻塞SDK内部connect失败将会有5s的超时才能够返回,不适合于轮询取流操作
('bPassbackRecord', c_uint32), # 0-不启用录像回传,1启用录像回传
('byPreviewMode', c_ubyte), # 预览模式,0-正常预览,1-延迟预览
('byStreamID', c_ubyte * 32), # 流ID,lChannel为0xffffffff时启用此参数
('byProtoType', c_ubyte), # 应用层取流协议,0-私有协议,1-RTSP协议,
# 2-SRTP码流加密(对应此结构体中dwLinkMode 字段,支持如下方式, 为1,表示udp传输方式,信令走TLS加密,码流走SRTP加密,为2,表示多播传输方式,信令走TLS加密,码流走SRTP加密)
('byRes1', c_ubyte),
('byVideoCodingType', c_ubyte), # 码流数据编解码类型 0-通用编码数据 1-热成像探测器产生的原始数据
('dwDisplayBufNum', c_uint32), # 播放库播放缓冲区最大缓冲帧数,范围1-50,置0时默认为1
('byNPQMode', c_ubyte), # NPQ是直连模式,还是过流媒体:0-直连 1-过流媒体
('byRecvMetaData', c_ubyte), # 是否接收metadata数据
# 设备是否支持该功能通过GET /ISAPI/System/capabilities 中DeviceCap.SysCap.isSupportMetadata是否存在且为true
('byDataType', c_ubyte), # 数据类型,0-码流数据,1-音频数据
('byRes', c_ubyte * 213),
]
#定义JPEG图像信息结构体
class NET_DVR_JPEGPARA(Structure):
pass
LPNET_DVR_JPEGPARA = POINTER(NET_DVR_JPEGPARA)
NET_DVR_JPEGPARA._fields_ = [
('wPicSize', c_ushort),
('wPicQuality', c_ushort),
]
# 叠加字符
class NET_DVR_SHOWSTRINGINFO(Structure):
pass
LPNET_DVR_SHOWSTRINGINFO = POINTER(NET_DVR_SHOWSTRINGINFO)
NET_DVR_SHOWSTRINGINFO._fields_ = [
('wShowString', c_ushort),
('wStringSize', c_ushort),
('wShowStringTopLeftX', c_ushort),
('wShowStringTopLeftY', c_ushort),
('sString', c_ubyte * 44),
]
# 叠加字符
class NET_DVR_SHOWSTRING_V30(Structure):
pass
LPNET_DVR_SHOWSTRING_V30 = POINTER(NET_DVR_SHOWSTRING_V30)
NET_DVR_SHOWSTRING_V30._fields_ = [
('dwSize', c_uint32),
('struStringInfo', NET_DVR_SHOWSTRINGINFO * 8),
]
# 透传接口输出参数结构体
class NET_DVR_XML_CONFIG_OUTPUT(Structure):
pass
LPNET_DVR_XML_CONFIG_OUTPUT = POINTER(NET_DVR_XML_CONFIG_OUTPUT)
NET_DVR_XML_CONFIG_OUTPUT._fields_ = [
('dwSize', c_uint32),
('lpOutBuffer', c_void_p),
('dwOutBufferSize', c_uint32),
('dwReturnedXMLSize', c_uint32),
('lpStatusBuffer', c_void_p),
('dwStatusSize', c_uint32),
('byRes', c_ubyte * 32)
]
# 透传接口输入参数结构体
class NET_DVR_XML_CONFIG_INPUT(Structure):
pass
LPNET_DVR_XML_CONFIG_INPUT = POINTER(NET_DVR_XML_CONFIG_INPUT)
NET_DVR_XML_CONFIG_INPUT._fields_ = [
('dwSize', c_uint32),
('lpRequestUrl', c_void_p),
('dwRequestUrlLen', c_uint32),
('lpInBuffer', c_void_p),
('dwInBufferSize', c_uint32),
('dwRecvTimeOut', c_uint32),
('byForceEncrpt', c_ubyte),
('byNumOfMultiPart', c_ubyte),
('byRes', c_ubyte * 30)
]
# 报警设备信息结构体
class NET_DVR_ALARMER(Structure):
_fields_ = [
("byUserIDValid", c_byte), # UserID是否有效 0-无效,1-有效
("bySerialValid", c_byte), # 序列号是否有效 0-无效,1-有效
("byVersionValid", c_byte), # 版本号是否有效 0-无效,1-有效
("byDeviceNameValid", c_byte), # 设备名字是否有效 0-无效,1-有效
("byMacAddrValid", c_byte), # MAC地址是否有效 0-无效,1-有效
("byLinkPortValid", c_byte), # login端口是否有效 0-无效,1-有效
("byDeviceIPValid", c_byte), # 设备IP是否有效 0-无效,1-有效
("bySocketIPValid", c_byte), # socket ip是否有效 0-无效,1-有效
("lUserID", c_uint32), # NET_DVR_Login()返回值, 布防时有效
("sSerialNumber", c_byte * 48), # 序列号
("dwDeviceVersion", c_uint32), # 版本信息 高16位表示主版本,低16位表示次版本
("sDeviceName", c_byte * 32), # 设备名字
("byMacAddr", c_byte * 6), # MAC地址
("wLinkPort", c_uint16), # link port
("sDeviceIP", c_byte * 128), # IP地址
("sSocketIP", c_byte * 128), # 报警主动上传时的socket IP地址
("byIpProtocol", c_byte), # Ip协议 0-IPV4, 1-IPV6
("byRes2", c_byte * 11)]
LPNET_DVR_ALARMER = POINTER(NET_DVR_ALARMER)
# 报警布防参数结构体
class NET_DVR_SETUPALARM_PARAM(Structure):
_fields_ = [
("dwSize", c_uint32), # 结构体大小
("byLevel", c_byte), # 布防优先级:0- 一等级(高),1- 二等级(中),2- 三等级(低)
("byAlarmInfoType", c_byte),
# 上传报警信息类型(抓拍机支持),0-老报警信息(NET_DVR_PLATE_RESULT),1-新报警信息(NET_ITS_PLATE_RESULT)2012-9-28
("byRetAlarmTypeV40", c_byte),
# 0- 返回NET_DVR_ALARMINFO_V30或NET_DVR_ALARMINFO,
# 1- 设备支持NET_DVR_ALARMINFO_V40则返回NET_DVR_ALARMINFO_V40,不支持则返回NET_DVR_ALARMINFO_V30或NET_DVR_ALARMINFO
("byRetDevInfoVersion", c_byte), # CVR上传报警信息回调结构体版本号 0-COMM_ALARM_DEVICE, 1-COMM_ALARM_DEVICE_V40
("byRetVQDAlarmType", c_byte), # VQD报警上传类型,0-上传报报警NET_DVR_VQD_DIAGNOSE_INFO,1-上传报警NET_DVR_VQD_ALARM
("byFaceAlarmDetection", c_byte),
("bySupport", c_byte),
("byBrokenNetHttp", c_byte),
("wTaskNo", c_uint16),
# 任务处理号 和 (上传数据NET_DVR_VEHICLE_RECOG_RESULT中的字段dwTaskNo对应 同时 下发任务结构 NET_DVR_VEHICLE_RECOG_COND中的字段dwTaskNo对应)
("byDeployType", c_byte), # 布防类型:0-客户端布防,1-实时布防
("byRes1", c_byte * 3),
("byAlarmTypeURL", c_byte),
# bit0-表示人脸抓拍报警上传
# 0-表示二进制传输,1-表示URL传输(设备支持的情况下,设备支持能力根据具体报警能力集判断,同时设备需要支持URL的相关服务,当前是”云存储“)
("byCustomCtrl", c_byte)] # Bit0- 表示支持副驾驶人脸子图上传: 0-不上传,1-上传
LPNET_DVR_SETUPALARM_PARAM = POINTER(NET_DVR_SETUPALARM_PARAM)
# 上传的报警信息结构体。
class NET_DVR_ALARMINFO_V30(Structure):
_fields_ = [
("dwAlarmType", c_uint32), # 报警类型
("dwAlarmInputNumber", c_uint32), # 报警输入端口,当报警类型为0、23时有效
("byAlarmOutputNumber", c_byte * 96),
# 触发的报警输出端口,值为1表示该报警端口输出,如byAlarmOutputNumber[0]=1表示触发第1个报警输出口输出,byAlarmOutputNumber[1]=1表示触发第2个报警输出口,依次类推
("byAlarmRelateChannel", c_byte * 64), # 触发的录像通道,值为1表示该通道录像,如byAlarmRelateChannel[0]=1表示触发第1个通道录像
("byChannel", c_byte * 64), # 发生报警的通道。当报警类型为2、3、6、9、10、11、13、15、16时有效,如byChannel[0]=1表示第1个通道报警
("byDiskNumber", c_byte * 33)] # 发生报警的硬盘。当报警类型为1,4,5时有效,byDiskNumber[0]=1表示1号硬盘异常
LPNET_DVR_ALARMINFO_V30 = POINTER(NET_DVR_ALARMINFO_V30)
# 报警布防参数结构体
class NET_DVR_SETUPALARM_PARAM(Structure):
_fields_ = [
("dwSize", c_uint32), # 结构体大小
("byLevel", c_byte), # 布防优先级:0- 一等级(高),1- 二等级(中),2- 三等级(低)
("byAlarmInfoType", c_byte),
# 上传报警信息类型(抓拍机支持),0-老报警信息(NET_DVR_PLATE_RESULT),1-新报警信息(NET_ITS_PLATE_RESULT)2012-9-28
("byRetAlarmTypeV40", c_byte),
# 0- 返回NET_DVR_ALARMINFO_V30或NET_DVR_ALARMINFO,
# 1- 设备支持NET_DVR_ALARMINFO_V40则返回NET_DVR_ALARMINFO_V40,不支持则返回NET_DVR_ALARMINFO_V30或NET_DVR_ALARMINFO
("byRetDevInfoVersion", c_byte), # CVR上传报警信息回调结构体版本号 0-COMM_ALARM_DEVICE, 1-COMM_ALARM_DEVICE_V40
("byRetVQDAlarmType", c_byte), # VQD报警上传类型,0-上传报报警NET_DVR_VQD_DIAGNOSE_INFO,1-上传报警NET_DVR_VQD_ALARM
("byFaceAlarmDetection", c_byte),
("bySupport", c_byte),
("byBrokenNetHttp", c_byte),
("wTaskNo", c_uint16),
# 任务处理号 和 (上传数据NET_DVR_VEHICLE_RECOG_RESULT中的字段dwTaskNo对应 同时 下发任务结构 NET_DVR_VEHICLE_RECOG_COND中的字段dwTaskNo对应)
("byDeployType", c_byte), # 布防类型:0-客户端布防,1-实时布防
("byRes1", c_byte * 3),
("byAlarmTypeURL", c_byte),
# bit0-表示人脸抓拍报警上传
# 0- 表示二进制传输,1- 表示URL传输(设备支持的情况下,设备支持能力根据具体报警能力集判断,同时设备需要支持URL的相关服务,当前是”云存储“)
("byCustomCtrl", c_byte)] # Bit0- 表示支持副驾驶人脸子图上传: 0-不上传,1-上传,(注:只在公司内部8600/8200等平台开放)
LPNET_DVR_SETUPALARM_PARAM = POINTER(NET_DVR_SETUPALARM_PARAM)
# 时间参数结构体
class NET_DVR_TIME(Structure):
_fields_ = [
("dwYear", c_uint32), # 年
("dwMonth", c_uint32), # 月
("dwDay", c_uint32), # 日
("dwHour", c_uint32), # 时
("dwMinute", c_uint32), # 分
("dwSecond", c_uint32)] # 秒
LPNET_DVR_TIME = POINTER(NET_DVR_TIME)
# IP地址结构体
class NET_DVR_IPADDR(Structure):
_fields_ = [
("sIpV4", c_byte * 16), # 设备IPv4地址
("sIpV6", c_byte * 128)] # 设备IPv6地址
LPNET_DVR_IPADDR = POINTER(NET_DVR_IPADDR)
# 门禁主机事件信息
class NET_DVR_ACS_EVENT_INFO(Structure):
_fields_ = [
("dwSize", c_uint32), # 结构体大小
("byCardNo", c_byte * 32), # 卡号
("byCardType", c_byte), # 卡类型:1- 普通卡,2- 残障人士卡,3- 黑名单卡,4- 巡更卡,5- 胁迫卡,6- 超级卡,7- 来宾卡,8- 解除卡,为0表示无效
("byAllowListNo", c_byte), # 白名单单号,取值范围:1~8,0表示无效
("byReportChannel", c_byte), # 报告上传通道:1- 布防上传,2- 中心组1上传,3- 中心组2上传,0表示无效
("byCardReaderKind", c_byte), # 读卡器类型:0- 无效,1- IC读卡器,2- 身份证读卡器,3- 二维码读卡器,4- 指纹头
("dwCardReaderNo", c_uint32), # 读卡器编号,为0表示无效
("dwDoorNo", c_uint32), # 门编号(或者梯控的楼层编号),为0表示无效(当接的设备为人员通道设备时,门1为进方向,门2为出方向)
("dwVerifyNo", c_uint32), # 多重卡认证序号,为0表示无效
("dwAlarmInNo", c_uint32), # 报警输入号,为0表示无效
("dwAlarmOutNo", c_uint32), # 报警输出号,为0表示无效
("dwCaseSensorNo", c_uint32), # 事件触发器编号
("dwRs485No", c_uint32), # RS485通道号,为0表示无效
("dwMultiCardGroupNo", c_uint32), # 群组编号
("wAccessChannel", c_uint16), # 人员通道号
("byDeviceNo", c_byte), # 设备编号,为0表示无效
("byDistractControlNo", c_byte), # 分控器编号,为0表示无效
("dwEmployeeNo", c_uint32), # 工号,为0无效
("wLocalControllerID", c_uint16), # 就地控制器编号,0-门禁主机,1-255代表就地控制器
("byInternetAccess", c_byte), # 网口ID:(1-上行网口1,2-上行网口2,3-下行网口1)
("byType", c_byte),
# 防区类型,0:即时防区,1-24小时防区,2-延时防区,3-内部防区,4-钥匙防区,5-火警防区,6-周界防区,7-24小时无声防区,
# 8-24小时辅助防区,9-24小时震动防区,10-门禁紧急开门防区,11-门禁紧急关门防区,0xff-无
("byMACAddr", c_byte * 6), # 物理地址,为0无效
("bySwipeCardType", c_byte), # 刷卡类型,0-无效,1-二维码
("byMask", c_byte), # 是否带口罩:0-保留,1-未知,2-不戴口罩,3-戴口罩
("dwSerialNo", c_uint32), # 事件流水号,为0无效
("byChannelControllerID", c_byte), # 通道控制器ID,为0无效,1-主通道控制器,2-从通道控制器
("byChannelControllerLampID", c_byte), # 通道控制器灯板ID,为0无效(有效范围1-255)
("byChannelControllerIRAdaptorID", c_byte), # 通道控制器红外转接板ID,为0无效(有效范围1-255)
("byChannelControllerIREmitterID", c_byte), # 通道控制器红外对射ID,为0无效(有效范围1-255)
("byHelmet", c_byte), # 可选,是否戴安全帽:0-保留,1-未知,2-不戴安全, 3-戴安全帽
("byRes", c_byte * 3)] # 保留,置为0
LPNET_DVR_ACS_EVENT_INFO = POINTER(NET_DVR_ACS_EVENT_INFO)
# 门禁主机报警信息结构体
class NET_DVR_ACS_ALARM_INFO(Structure):
_fields_ = [
("dwSize", c_uint32), # 结构体大小
("dwMajor", c_uint32), # 报警主类型,具体定义见“Remarks”说明
("dwMinor", c_uint32), # 报警次类型,次类型含义根据主类型不同而不同,具体定义见“Remarks”说明
("struTime", NET_DVR_TIME), # 报警时间
("sNetUser", c_byte * 16), # 网络操作的用户名
("struRemoteHostAddr", NET_DVR_IPADDR), # 远程主机地址
("struAcsEventInfo", NET_DVR_ACS_EVENT_INFO), # 报警信息详细参数
("dwPicDataLen", c_uint32), # 图片数据大小,不为0是表示后面带数据
("pPicData", c_void_p), # 图片数据缓冲区
("wInductiveEventType", c_uint16), # 归纳事件类型,0-无效,客户端判断该值为非0值后,报警类型通过归纳事件类型区分,否则通过原有报警主次类型(dwMajor、dwMinor)区分
("byPicTransType", c_byte), # 图片数据传输方式: 0-二进制;1-url
("byRes1", c_byte), # 保留,置为0
("dwIOTChannelNo", c_uint32), # IOT通道号
("pAcsEventInfoExtend", c_void_p), # byAcsEventInfoExtend为1时,表示指向一个NET_DVR_ACS_EVENT_INFO_EXTEND结构体
("byAcsEventInfoExtend", c_byte), # pAcsEventInfoExtend是否有效:0-无效,1-有效
("byTimeType", c_byte), # 时间类型:0-设备本地时间,1-UTC时间(struTime的时间)
("byRes2", c_byte), # 保留,置为0
("byAcsEventInfoExtendV20", c_byte), # pAcsEventInfoExtendV20是否有效:0-无效,1-有效
("pAcsEventInfoExtendV20", c_void_p), # byAcsEventInfoExtendV20为1时,表示指向一个NET_DVR_ACS_EVENT_INFO_EXTEND_V20结构体
("byRes", c_byte * 4)] # 保留,置为0
LPNET_DVR_ACS_ALARM_INFO = POINTER(NET_DVR_ACS_ALARM_INFO)
# 点坐标参数结构体
class NET_VCA_POINT(Structure):
_fields_ = [
("fX", c_float),
("fY", c_float)
]
# 身份证刷卡信息扩展参数
class NET_DVR_ID_CARD_INFO_EXTEND(Structure):
_fields_ = [
("byRemoteCheck", c_ubyte),
("byThermometryUnit", c_ubyte),
("byIsAbnomalTemperature", c_ubyte),
("byRes2", c_ubyte),
("fCurrTemperature", c_float),
("struRegionCoordinates", NET_VCA_POINT),
("dwQRCodeInfoLen",c_uint32),
("dwVisibleLightDataLen",c_uint32),
("dwThermalDataLen",c_uint32),
("pQRCodeInfo", POINTER(c_byte)),
("pVisibleLightData", POINTER(c_byte)),
("pThermalData", POINTER(c_byte)),
("byRes", c_ubyte * 1024)
]
# 日期信息结构体
class NET_DVR_DATE(Structure):
_fields_ = [
('wYear', c_ushort),
('byMonth', c_ubyte),
('byDay', c_ubyte)
]
# 身份证信息结构体
class NET_DVR_ID_CARD_INFO(Structure):
_fields_ = [
("dwSize",c_uint),
("byName", c_ubyte * 128),
("struBirth",NET_DVR_DATE),
("byAddr", c_ubyte * 280),
("byIDNum", c_ubyte * 32),
("byIssuingAuthority", c_ubyte * 128),
("struStartDate",NET_DVR_DATE),
("struEndDate",NET_DVR_DATE),
("byTermOfValidity", c_ubyte),
("bySex", c_ubyte),
("byNation", c_ubyte),
("byRes", c_ubyte * 101)
]
# 时间参数结构体
class NET_DVR_TIME(Structure):
_fields_ = [
("dwYear", c_uint32),
("dwMonth", c_uint32),
("dwDay", c_uint32),
("dwHour", c_uint32),
("dwMinute", c_uint32),
("dwSecond", c_uint32)
]
# 时间参数结构体
class NET_DVR_TIME_V30(Structure):
_fields_ = [
('wYear', c_ushort),
('byMonth', c_ubyte),
('byDay', c_ubyte),
('byHour', c_ubyte),
('byMinute', c_ubyte),
('bySecond', c_ubyte),
('byISO8601', c_ubyte),
('wMilliSec', c_ushort),
('cTimeDifferenceH', c_ubyte),
('cTimeDifferenceM', c_ubyte),
]
# IP地址结构体
class NET_DVR_IPADDR(Structure):
_fields_ = [
("sIpV4", c_ubyte * 16),
("byIPv6", c_ubyte * 128)]
# 身份证刷卡信息上传结构体
class NET_DVR_ID_CARD_INFO_ALARM(Structure):
_fields_ = [
("dwSize",c_uint32), # 结构长度
("struIDCardCfg", NET_DVR_ID_CARD_INFO), # 身份证信息
("dwMajor", c_uint32), # 报警主类型,参考宏定义
("dwMinor", c_uint32), # 报警次类型,参考宏定义
("struSwipeTime", NET_DVR_TIME_V30), # 刷卡时间
("byNetUser", c_ubyte * 16), # 网络操作的用户名
("struRemoteHostAddr", NET_DVR_IPADDR), # 远程主机地址
("dwCardReaderNo", c_uint32), # 读卡器编号,为0无效
("dwDoorNo", c_uint32), # 门编号,为0无效
("dwPicDataLen", c_uint32), # 图片数据大小,不为0是表示后面带数据
("pPicData", c_void_p), # 身份证图片数据缓冲区,dwPicDataLen不为0时缓冲区里面存放身份证头像的图片数据
("byCardType", c_ubyte), # 卡类型,1-普通卡,2-残疾人卡,3-黑名单卡,4-巡更卡,5-胁迫卡,6-超级卡,7-来宾卡,8-解除卡,为0无效
("byDeviceNo", c_ubyte), # 设备编号,为0时无效(有效范围1-255)
("byMask", c_ubyte), # 是否带口罩:0-保留,1-未知,2-不戴口罩,3-戴口罩
("byRes2", c_ubyte), # 保留,置为0
("dwFingerPrintDataLen", c_uint32), # 指纹数据大小,不为0是表示后面带数据
("pFingerPrintData", c_void_p), # 指纹数据缓冲区,dwFingerPrintDataLen不为0时缓冲区里面存放指纹数据
("dwCapturePicDataLen", c_uint32), # 抓拍图片数据大小,不为0是表示后面带数据
("pCapturePicData", c_void_p), # 抓拍图片数据缓冲区,dwCapturePicDataLen不为0时缓冲区里面存放设备上摄像机抓拍上传的图片数据
("dwCertificatePicDataLen", c_uint32), # 证件抓拍图片数据大小,不为0是表示后面带数据
("pCertificatePicData", c_void_p), # 证件抓拍图片数据缓冲区,dwCertificatePicDataLen不为0时缓冲区里面存放设备上摄像机抓拍上传的证件抓拍图片数据
("byCardReaderKind", c_ubyte), # 读卡器属于哪一类:0-无效,1-IC读卡器,2-身份证读卡器,3-二维码读卡器,4-指纹头
("byRes3", c_ubyte * 2), # 保留,置为0
("byIDCardInfoExtend", c_ubyte), # pIDCardInfoExtend是否有效:0-无效,1-有效
("pIDCardInfoExtend", POINTER(NET_DVR_ID_CARD_INFO_EXTEND)), # 身份证刷卡扩展事件信息
("byRes", c_ubyte * 172) # 身份证刷卡扩展事件信息
]
LPNET_DVR_ID_CARD_INFO_ALARM = POINTER(NET_DVR_ID_CARD_INFO_ALARM)
class NET_DVR_ALARM_ISAPI_PICDATA(Structure):
_fields_ = [
("dwPicLen", c_uint32), # 图片数据长度
("byPicType", c_ubyte), # 图片格式: 1- jpg
("byRes", c_ubyte * 3), #
("szFilename", c_ubyte * 256), # 图片名称
("pPicData", c_void_p), # 图片数据
]
LPNET_DVR_ALARM_ISAPI_PICDATA = POINTER(NET_DVR_ALARM_ISAPI_PICDATA)
class NET_DVR_ALARM_ISAPI_INFO(Structure):
_fields_ = [
("pAlarmData", c_void_p), # 报警数据
("dwAlarmDataLen", c_uint32), # 报警数据长度
("byDataType", c_ubyte), # 0-invalid,1-xml,2-json
("byPicturesNumber", c_ubyte), # 图片数量
("byRes[2]", c_ubyte * 2), # 保留字节
("pPicPackData", c_void_p), # 图片变长部分
("byRes1[32]", c_ubyte * 32), # 保留字节
]
LPNET_DVR_ALARM_ISAPI_INFO = POINTER(NET_DVR_ALARM_ISAPI_INFO)
class NET_DVR_LOCAL_GENERAL_CFG(Structure):
_fields_ = [
("byExceptionCbDirectly", c_ubyte), # 0-通过线程池异常回调,1-直接异常回调给上层
("byNotSplitRecordFile", c_ubyte), # 回放和预览中保存到本地录像文件不切片 0-默认切片,1-不切片
("byResumeUpgradeEnable", c_ubyte), # 断网续传升级使能,0-关闭(默认),1-开启
("byAlarmJsonPictureSeparate", c_ubyte), # 控制JSON透传报警数据和图片是否分离,0-不分离,1-分离(分离后走COMM_ISAPI_ALARM回调返回)
("byRes", c_ubyte * 4), # 保留
("i64FileSize", c_uint64), # 单位:Byte
("dwResumeUpgradeTimeout", c_uint32), # 断网续传重连超时时间,单位毫秒
("byAlarmReconnectMode", c_ubyte), # 0-独立线程重连(默认) 1-线程池重连
("byStdXmlBufferSize", c_ubyte), # 设置ISAPI透传接收缓冲区大小,1-1M 其他-默认
("byMultiplexing", c_ubyte), # 0-普通链接(非TLS链接)关闭多路复用,1-普通链接(非TLS链接)开启多路复用
("byFastUpgrade", c_ubyte), # 0-正常升级,1-快速升级
("byRes1", c_ubyte * 232), # 预留
]
LPNET_DVR_LOCAL_GENERAL_CFG = POINTER(NET_DVR_LOCAL_GENERAL_CFG)
# 报警信息回调函数
MSGCallBack_V31 = fun_ctype(c_bool, c_uint32, LPNET_DVR_ALARMER, c_void_p, c_ulong, c_void_p)
MSGCallBack = fun_ctype(None, c_uint32, LPNET_DVR_ALARMER, c_void_p, c_ulong, c_void_p)
# 码流回调函数
REALDATACALLBACK = fun_ctype(None, c_long, c_ulong, POINTER(c_ubyte), c_ulong, c_void_p)
说明
其它SDK功能函数, 可以参照上述思路,用ctype重新定义形参、返回值类型,然后重新申明 C++函数。需要注意 C++中的数组、指针、引用类型与ctypes 的转换。