视频监控平台：通过网络SDK对TCL网络摄像机进行PTZ控制的源代码介绍及分享

一、视频监控平台介绍

（一）概述

（二）视频接入能力介绍

（三）功能介绍

二、TCL网络摄像机

（一）360度全景自动旋转：

（二）高清夜视和全彩夜视：

（三）自动巡航和定点追踪：

（四）存储方式：

（五）多种像素选择：

（六）网络连接：

（七）其他功能：

三、代码和解释

（一）代码和注释

（二）函数功能说明

1、函数的参数

2、主体部分和分支

（1）第一个分支：设置或调用预置位

（2）第二个分支：停止移动

（3）第三个分支：平移和缩放

（4）补充说明

（三）结束

四、效果展示

（一）正常浏览实时视频

（二）PTZ向上移动

（三）PTZ调节镜头

一、视频监控平台介绍

（一）概述

威迪斯特视频监控接入平台AS-V1000，也可以称为：视频监控综合资源管理平台，视频监控平台，视频监控汇聚平台（或视频监控汇集平台），视频监控管理平台，视频监控综合管理平台，是一套集成了用户设备权限管理、视音频监控、大容量存储、电子地图的系统平台软件。它结合了现代视频技术、网络通讯技术、计算机控制技术、流媒体传输技术的综合解决方案，为用户提供了强大的、灵活的组网和应用能力。

（二）视频接入能力介绍

系统平台能够实现接入不同品牌的视频监控平台、视频相关设备、外围设备等等；支持国际和国内的一些标准对接协议，包括sdk协议、GB/T28181协议、ehome协议等等。可以通过各种协议，接入IPC、DVR、DVS、NVR等设备，以及一些大型的视频监控平台，包括海康威视、浙江大华、苏州科达、杭州宇视等主流品牌的监控平台，对于有些特有品牌的平台，也能够通过SDK接口、私有协议等方式接入进入本系统平台（国外品牌包括：Panasonic和axis等）；反过来，本平台也提供开放接口，能够接入到其他标准或者非标准的平台。

前面有篇文章：《AS-V1000平台使用SDK的方式接入监控设备》，有兴趣可以查看。

（三）功能介绍

平台实现了丰富的功能，包含：实时多媒体数据转发和管理、移动流媒体转发管理、不间断录像、录像文件检索和回放、录像下载、设备状态管理、系统报警管理、视频转码、视频点播等等；整个平台具备稳定可靠、使用安全、兼容性强、接口开放、服务可堆叠、服务可多级级联、系统可平滑扩容等特点。

二、TCL网络摄像机

TCL网络摄像机是一款网络监控设备，它具备视频捕捉、编码、存储和网络传输等功能。用户可以通过网络远程访问这些摄像机，实现实时监控。TCL作为一家知名的家电及通讯设备制造商，其网络摄像机产品通常会具备一些特色功能，如高清视频、夜视功能、移动侦测、云存储等，以满足家庭、企业及商用安全监控的需求。

以下概要介绍一下TCL网络摄像机的一些主要特点和信息。

（一）360度全景自动旋转：

TCL的部分网络摄像机支持360度全景自动旋转，这使得它们能够无死角地监控周围环境。不论是室内还是室外，用户都可以通过摄像头全方位地观察。

（二）高清夜视和全彩夜视：

TCL网络摄像机提供了高清夜视和全彩夜视功能，确保在夜晚也能提供清晰而细腻的图像。这对于室外监控尤为重要，用户即使在黑暗中也能监控到重要情况。

（三）自动巡航和定点追踪：

一些TCL网络摄像机具备自动巡航和定点追踪功能。它们可以根据用户的设定，在预设的区域内进行自动巡航，确保所有角落都被监控到。同时，它们还能够通过智能识别技术，实现目标的准确定位和追踪。

（四）存储方式：

TCL网络摄像机支持云存储和扩展存储卡，用户可以根据实际需求选择合适的存储方式。云存储可以帮助用户远程访问摄像头的录像内容，而扩展存储卡则提供了更大的存储空间。

（五）多种像素选择：

TCL网络摄像机提供了多种像素选择，如300万、400万、500万、800万等，用户可以根据监控需求选择合适的像素。

（六）网络连接：

TCL网络摄像机支持无线Wi-Fi和有线网络连接，用户可以根据实际情况选择合适的连接方式。

（七）其他功能：

除了上述主要功能外，TCL网络摄像机还可能具备语音对讲、手机远程查看、移动检测、声光报警等功能，以满足不同用户的需求。

三、代码和解释

这里共享一段C++代码，代码定义了一个名为CNetSdkForTclIPC::ZXPtzControl的类函数，该类用于通过TCL网络摄像机的SDK来控制TCL网络摄像机的云台和镜头。

（一）代码和注释

以下是为代码和注释：

int CNetSdkForTclIPC::ZXPtzControl(long LoginID, int channelid, int opt, int param1, TExtPtzInfo *pExtPtzInfo)
{// 定义一些变量，用于存储函数执行的结果和参数TC_S32 retcode = 0; // 用于存储返回码TC_U32 rspparam = 0; // 用于存储返回参数// 定义一些变量，用于存储PTZ命令和相关参数CM_PTZ_E ptz_cmd = PTZ_CTRL_NONE; // PTZ命令枚举，初始值为无命令bool bstop = false; // 停止标志位，初始值为falseint iparam1 = param1; // 参数1的副本，用于后续计算// 根据opt的值，判断是否执行PTZ位置设置等操作if (opt == PTZ_OPT_POS_SET || opt == PTZ_OPT_POS_CALL || opt == PTZ_OPT_POS_CLEAR || opt == PTZ_OPT_ASS || opt == PTZ_OPT_WASH){// 根据不同的opt值，设置相应的PTZ命令if (opt == PTZ_OPT_ASS)ptz_cmd = PTZ_CTRL_LIGHT;else if (opt == PTZ_OPT_WASH)ptz_cmd = PTZ_CTRL_WIPER;else if (opt == PTZ_OPT_POS_SET)ptz_cmd = PTZ_CTRL_SAVE_PRESET;else if (opt == PTZ_OPT_POS_CLEAR)ptz_cmd = PTZ_CTRL_CALL_PRESET; // 注意：这里没有执行清除操作elseptz_cmd = PTZ_CTRL_CALL_PRESET;// 构造PTZ请求结构体CM_PTZ PtzReq;PtzReq.channel = channelid - 1; // 通道ID减1，可能是由于内部处理需要PtzReq.ptz_cmd = (TC_U32)ptz_cmd; // 将PTZ命令转换为适合传输的数据类型PtzReq.param1 = iparam1; // 设置参数1PtzReq.param2 = 0; // 设置参数2为速度，这里默认为0PtzReq.stop = bstop == true ? 1 : 0; // 设置停止标志位// 发送PTZ控制命令HandleCmd(CM_CMD_PTZ_CTRL, (char*)&PtzReq, sizeof(PtzReq), retcode, rspparam);return 0; // 成功执行PTZ控制命令}// 根据opt的值，判断是否执行停止移动等操作if (opt == PTZ_OPT_UP_STOP || opt == PTZ_OPT_DOWN_STOP || opt == PTZ_OPT_LEFT_STOP || opt == PTZ_OPT_RIGHT_STOP ||opt == PTZ_OPT_UL_STOP || opt == PTZ_OPT_DL_STOP || opt == PTZ_OPT_UR_STOP || opt == PTZ_OPT_DR_STOP ||opt == PTZ_OPT_ZOOMIN_STOP || opt == PTZ_OPT_ZOOMOUT_STOP || opt == PTZ_OPT_FOCUSNEAR_STOP || opt == PTZ_OPT_FOCUSFAR_STOP ||opt == PTZ_OPT_IRISOPEN_STOP || opt == PTZ_OPT_IRISCLOSE_STOP){// 设置停止标志位为truebstop = true;}// 根据opt的值，判断是否执行平移和缩放等操作if (opt == PTZ_OPT_UP || opt == PTZ_OPT_UP_STOP){ptz_cmd = PTZ_CTRL_UP;}else if (opt == PTZ_OPT_DOWN || opt == PTZ_OPT_DOWN_STOP){ptz_cmd = PTZ_CTRL_DOWN;}else if (opt == PTZ_OPT_LEFT || opt == PTZ_OPT_LEFT_STOP){ptz_cmd = PTZ_CTRL_LEFT;}else if (opt == PTZ_OPT_RIGHT || opt == PTZ_OPT_RIGHT_STOP){ptz_cmd = PTZ_CTRL_RIGHT;}else if (opt == PTZ_OPT_UL || opt == PTZ_OPT_UL_STOP){ptz_cmd = PTZ_CTRL_LEFT_UP;}else if (opt == PTZ_OPT_DL || opt == PTZ_OPT_DL_STOP){ptz_cmd = PTZ_CTRL_LEFT_DOWN;}else if (opt == PTZ_OPT_UR || opt == PTZ_OPT_UR_STOP){ptz_cmd = PTZ_CTRL_RIGHT_UP;}else if (opt == PTZ_OPT_DR || opt == PTZ_OPT_DR_STOP){ptz_cmd = PTZ_CTRL_RIGHT_DOWN;}else if (opt == PTZ_OPT_ZOOMIN || opt == PTZ_OPT_ZOOMIN_STOP){ptz_cmd = PTZ_CTRL_ZOOM_TELE;}else if (opt == PTZ_OPT_ZOOMOUT || opt == PTZ_OPT_ZOOMOUT_STOP){ptz_cmd = PTZ_CTRL_ZOOM_WIDE;}else if (opt == PTZ_OPT_FOCUSNEAR || opt == PTZ_OPT_FOCUSNEAR_STOP){ptz_cmd = PTZ_CTRL_FOCUS_NEAR;}else if (opt == PTZ_OPT_FOCUSFAR || opt == PTZ_OPT_FOCUSFAR_STOP){ptz_cmd = PTZ_CTRL_FOCUS_FAR;}else if (opt == PTZ_OPT_IRISOPEN || opt == PTZ_OPT_IRISOPEN_STOP){ptz_cmd = PTZ_CTRL_IRIS_OPEN;}else if (opt == PTZ_OPT_IRISCLOSE || opt == PTZ_OPT_IRISCLOSE_STOP){ptz_cmd = PTZ_CTRL_IRIS_CLOSE;}// 如果ptz_cmd不为PTZ_CTRL_NONE，则执行PTZ移动操作if (ptz_cmd != PTZ_CTRL_NONE){// 对于缩放、聚焦近、聚焦远和光圈打开、关闭的操作，需要对参数1进行转换if (opt == PTZ_OPT_ZOOMIN || opt == PTZ_OPT_ZOOMOUT ||opt == PTZ_OPT_FOCUSNEAR || opt == PTZ_OPT_FOCUSFAR ||opt == PTZ_OPT_IRISOPEN || opt == PTZ_OPT_IRISCLOSE){iparam1 = (unsigned int)((iparam1 * 1.0 / 15.0) * 7.0);}else{iparam1 = (unsigned int)((iparam1 * 1.0 / 255.0) * 7.0);}// 构造PTZ请求结构体CM_PTZ PtzReq;PtzReq.channel = channelid - 1;PtzReq.ptz_cmd = (TC_U32)ptz_cmd;PtzReq.param1 = 0;PtzReq.param2 = iparam1; // 设置参数2为速度PtzReq.stop = bstop == true ? 1 : 0;// 发送PTZ请求到控制服务器if (ptz_cmd == PTZ_CTRL_UP || ptz_cmd == PTZ_CTRL_DOWN ||ptz_cmd == PTZ_CTRL_LEFT || ptz_cmd == PTZ_CTRL_RIGHT ||ptz_cmd == PTZ_CTRL_LEFT_UP || ptz_cmd == PTZ_CTRL_LEFT_DOWN ||ptz_cmd == PTZ_CTRL_RIGHT_UP || ptz_cmd == PTZ_CTRL_RIGHT_DOWN){PtzReq.param2 = iparam1; // 设置参数2为速度}else{PtzReq.param2 = 0;}// 发送PTZ控制命令ret = send_ptz_cmd(&PtzReq);if (ret != 0){printf("发送PTZ控制命令失败， 错误码： %d\n", ret);return -1;}}return 0;
}

（二）函数功能说明

这段代码是视频监控系统的一部分，用于实现对摄像头PTZ功能的编程控制。具体的讲，这段C++代码定义了一个名为CNetSdkForTclIPC的类的成员函数ZXPtzControl，该函数用于控制远程设备的PTZ（Pan-Tilt-Zoom，即变焦）功能。PTZ是视频监控摄像头常见的功能，允许用户远程控制摄像头的方向和焦距。