目录
一、视频监控平台介绍
（一）概述
威迪斯特视频监控接入平台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; // 停止标志位，初始值为false
int 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; // 注意：这里没有执行清除操作
else
ptz_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; // 设置参数1
PtzReq.param2 = 0; // 设置参数2为速度，这里默认为0
PtzReq.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)
{
// 设置停止标志位为true
bstop = 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是视频监控摄像头常见的功能，允许用户远程控制摄像头的方向和焦距。
1、函数的参数
函数ZXPtzControl的参数如下：
- LoginID：一个长整型参数，可能代表登录会话ID。
- channelid：一个整型参数，代表要控制的通道ID。
- opt：一个整型参数，代表控制命令的类型。
- param1：一个整型参数，代表控制命令的附加参数。
- pExtPtzInfo：一个指向TExtPtzInfo结构的指针，可能用于传递额外的PTZ信息。
2、主体部分和分支
函数的主体部分分为多个分支，根据opt参数的值来确定具体的PTZ控制命令。
首先，代码定义了几个变量，包括TC_S32类型的retcode和rspparam，以及TC_U32类型的rspparam。这些变量用于存储函数执行后的返回码和参数。
接下来，根据opt的值，函数进行了多个分支判断：
（1）第一个分支：设置或调用预置位
处理PTZ_OPT_POS_SET、PTZ_OPT_POS_CALL、PTZ_OPT_POS_CLEAR、
PTZ_OPT_ASS和PTZ_OPT_WASH这几个命令。这些命令与设置或调用预设的PTZ位置相关。
（2）第二个分支：停止移动
处理停止移动的命令，如PTZ_OPT_UP_STOP、PTZ_OPT_DOWN_STOP等。在这个分支中，bstop变量被设置为true。
（3）第三个分支：平移和缩放
处理平移和缩放的命令，如PTZ_OPT_UP、PTZ_OPT_DOWN、PTZ_OPT_LEFT等。在这个分支中，根据命令类型设置ptz_cmd变量，然后构建一个CM_PTZ结构，包含通道ID、PTZ命令、参数和停止标志，并调用HandleCmd函数发送PTZ控制命令。
（4）补充说明
在处理平移和缩放命令的分支中，如果命令是PTZ_OPT_ZOOMIN、
PTZ_OPT_ZOOMOUT、PTZ_OPT_FOCUSNEAR、PTZ_OPT_FOCUSFAR、PTZ_OPT_IRISOPEN或PTZ_OPT_IRISCLOSE，参数param1会根据一定的比例进行转换，然后设置到CM_PTZ结构的param2字段，这个字段可能代表速度或者开度等。
（三）结束
最后，函数返回0，表示控制命令已成功处理。
四、效果展示
（一）正常浏览实时视频
可以通过视频监控平台的web客户端，查看TCL的视频图像，如下图示：
（二）PTZ向上移动
对视频图像的云台，往上移动一点，效果如下：
（三）PTZ调节镜头
然后，调节PTZ的 “镜头变倍+”，如下图示：
调整后效果如下：
文章正下方可以看到我的联系方式：鼠标“点击” 下面的 “威迪斯特-就是video system 微信名片”字样，就会出现我的二维码，欢迎沟通探讨。
