GB28181学习（十一）——控制（PTZ、镜头、光圈等控制） In 巴西队世界杯名单 @2025-05-08 14:50:10
要求
源设备向目标设备发送控制命令，控制命令类型包括：
摄像机云台控制远程启动录像控制报警布防/撤防报警复位强制关键帧拉框放大/缩小看守位控制PTZ精准控制存储卡格式化目标跟踪软件升级设备配置 设备配置的内容包括：
基本参数视频参数范围SVAC编码SVAC解码视频参数属性录像计划报警录像视频画面遮挡画面翻转报警上报开关前端OSD图像抓拍配置 控制采用MESSAGE方法实现；源设备向目标设备发送控制命令后，目标设备不需要发送应答命令的控制命令包括：
摄像机云台控制远程启动强制关键帧拉框放大/缩小PTZ精准控制存储卡格式化目标跟踪 源设备向目标设备发送控制命令后，目标设备需要发送应答命令的控制命令包括：
录像控制报警布防/撤防报警复位看守位控制软件升级设备配置 源设备包括：
SIP客户端网关联网系统 目标设备包括：
SIP设备网关联网系统
流程
无应答设备控制流程
有应答设备控制流程
协议接口
请求命令
MESSAGE消息头Content-type头域为Content-type:Application/MANSCDP+xml；设备控制命令消息体采用XML封装；设备控制命令应包括：
命令类型（CmdType）；命令序列号（SN）;设备编码（DeviceID）；子命令； 设备收到MESSAGE消息后，应立即返回应答，应答命令中无消息体；
应答命令
MESSAGE消息头Content-type头域为Content-type:Application/MANSCDP+xml；设备控制命令消息体采用XML封装；设备控制命令应包括：
命令类型（CmdType）；命令序列号（SN）;设备编码（DeviceID）；执行结果（Result）； 设备收到MESSAGE消息后，应立即返回应答，应答命令中无消息体；
控制定义
指令格式
PTZ控制、镜头变大/缩小s
定义
示例
FI指令
定义
示例
代码
命令宏定义：
enum PTZControlType
{
PTZ_CTRL_HALT = 0, // 停止
PTZ_CTRL_RIGHT, // 右转
PTZ_CTRL_RIGHTUP, // 右上
PTZ_CTRL_UP, // 上转
PTZ_CTRL_LEFTUP, // 左上
PTZ_CTRL_LEFT, // 左转
PTZ_CTRL_LEFTDOWN, // 左下
PTZ_CTRL_DOWN, // 下转
PTZ_CTRL_RIGHTDOWN, // 右下
PTZ_CTRL_ZOOM, // 镜头放大/缩小
PTZ_CTRL_IRIS, // 光圈放大/缩小
PTZ_CTRL_FOCUS, // 镜头聚焦/放焦
};
PTZ转换流程：
std::string CMySipContext::ParsePTZCmd(CMyGBDevice* device, const std::string& gbid, PTZControlType ptzType, int paramValue)
{
unsigned char ptzCmdStr[8] = { 0xA5, 0x0F, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00 };
PTZControlType type = ptzType;
if (0 == paramValue)
type = PTZ_CTRL_HALT;
switch (type)
{
case PTZ_CTRL_HALT:
break;
case PTZ_CTRL_RIGHT: // 右
ptzCmdStr[3] = 0x01;
ptzCmdStr[4] = paramValue & 0xFF;
break;
case PTZ_CTRL_RIGHTUP: // 右上
ptzCmdStr[3] = 0x09;
ptzCmdStr[4] = paramValue & 0xFF;
ptzCmdStr[5] = paramValue & 0xFF;
break;
case PTZ_CTRL_UP: // 上
ptzCmdStr[3] = 0x08;
ptzCmdStr[5] = paramValue & 0xFF;
break;
case PTZ_CTRL_LEFTUP: // 左上
ptzCmdStr[3] = 0x0A;
ptzCmdStr[4] = paramValue & 0xFF;
ptzCmdStr[5] = paramValue & 0xFF;
break;
case PTZ_CTRL_LEFT: // 左
ptzCmdStr[3] = 0x02;
ptzCmdStr[4] = paramValue & 0xFF;
break;
case PTZ_CTRL_LEFTDOWN: // 左下
ptzCmdStr[3] = 0x06;
ptzCmdStr[4] = paramValue & 0xFF;
ptzCmdStr[5] = paramValue & 0xFF;
break;
case PTZ_CTRL_DOWN: // 下
ptzCmdStr[3] = 0x04;
ptzCmdStr[5] = paramValue & 0xFF;
break;
case PTZ_CTRL_RIGHTDOWN: // 右下
ptzCmdStr[3] = 0x05;
ptzCmdStr[4] = paramValue & 0xFF;
ptzCmdStr[5] = paramValue & 0xFF;
break;
case PTZ_CTRL_ZOOM:
if (paramValue > 0)
{
ptzCmdStr[3] = 0x10;
ptzCmdStr[6] = (paramValue & 0x0F) << 4;
}
else if (paramValue < 0)
{
ptzCmdStr[3] = 0x20;
ptzCmdStr[6] = ((-paramValue) & 0x0F) << 4;
}
break;
case PTZ_CTRL_IRIS:
if (paramValue > 0)
{
ptzCmdStr[3] = 0x44;
ptzCmdStr[5] = paramValue & 0xFF;
}
else if (paramValue < 0)
{
ptzCmdStr[3] = 0x48;
ptzCmdStr[5] = (-paramValue) & 0xFF;
}
break;
case PTZ_CTRL_FOCUS:
if (paramValue > 0)
{
ptzCmdStr[3] = 0x41;
ptzCmdStr[4] = paramValue & 0xFF;
}
else if (paramValue < 0)
{
ptzCmdStr[3] = 0x42;
ptzCmdStr[4] = (-paramValue) & 0xFF;
}
break;
default:
break;
}
std::string cmdstr;
char tmp[8] = { 0, };
for (int i = 0; i < 7; i++)
{
ptzCmdStr[7] += ptzCmdStr[i];
sprintf(tmp, "%02X", ptzCmdStr[i]);
cmdstr += tmp;
}
sprintf(tmp, "%02X", ptzCmdStr[7]);
cmdstr += tmp;
char szPTZInfo[200] = { 0 };
pj_ansi_snprintf(szPTZInfo, 200,
"\n"
"
"
"
"
"
"\n", gbid.c_str(), cmdstr.c_str()
);
return szPTZInfo;
}
抓包
PTZ控制
上（值:250 请求）
下（值:250 请求）
左（值:250 请求）
右（值:250 请求）
左上（值:250 请求）
左下（值:250 请求）
右上（值:250 请求）
右下（值:250 请求）
停止（值:250 请求）
镜头放大/缩小
放大（值:250 请求）
缩小（值:-250 请求）
光圈放大/缩小
光圈放大（值:250 请求）
光圈缩小（值:-250 请求）
镜头聚焦/放焦
镜头聚焦（值:250 请求）
镜头放焦（值:-250 请求）
界面展示