GB28181学习（十一）——控制（PTZ、镜头、光圈等控制）

要求

• 源设备向目标设备发送控制命令，控制命令类型包括：
  • 摄像机云台控制
  • 远程启动
  • 录像控制
  • 报警布防/撤防
  • 报警复位
  • 强制关键帧
  • 拉框放大/缩小
  • 看守位控制
  • 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,             // 镜头聚焦/放焦
};
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

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"
		"DeviceControl\n"
		"130\n"
		"%s\n"
		"%s\n"
		"\n", gbid.c_str(), cmdstr.c_str()
	);

	return szPTZInfo;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

抓包

PTZ控制

• 上（值:250 请求）

<Control>
    <CmdType>DeviceControlCmdType>
    <SN>130SN>
    <DeviceID>xxxDeviceID>
    <PTZCmd>A50F010800FA00B7PTZCmd>
Control>
1
2
3
4
5
6
7

• 下（值:250 请求）

<Control>
    <CmdType>DeviceControlCmdType>
    <SN>130SN>
    <DeviceID>xxxDeviceID>
    <PTZCmd>A50F010400FA00B3PTZCmd>
Control>
1
2
3
4
5
6
7

• 左（值:250 请求）

<Control>
    <CmdType>DeviceControlCmdType>
    <SN>130SN>
    <DeviceID>xxxDeviceID>
    <PTZCmd>A50F0102FA0000B1PTZCmd>
Control>
1
2
3
4
5
6
7

• 右（值:250 请求）

<Control>
    <CmdType>DeviceControlCmdType>
    <SN>130SN>
    <DeviceID>xxxDeviceID>
    <PTZCmd>A50F0101FA0000B0PTZCmd>
Control>
1
2
3
4
5
6
7

• 左上（值:250 请求）

<Control>
    <CmdType>DeviceControlCmdType>
    <SN>130SN>
    <DeviceID>xxxDeviceID>
    <PTZCmd>A50F010AFAFA00B3PTZCmd>
Control>
1
2
3
4
5
6
7

• 左下（值:250 请求）

<Control>
    <CmdType>DeviceControlCmdType>
    <SN>130SN>
    <DeviceID>xxxDeviceID>
    <PTZCmd>A50F0106FAFA00AFPTZCmd>
Control>
1
2
3
4
5
6
7

• 右上（值:250 请求）

<Control>
    <CmdType>DeviceControlCmdType>
    <SN>130SN>
    <DeviceID>xxxDeviceID>
    <PTZCmd>A50F0109FAFA00B2PTZCmd>
Control>
1
2
3
4
5
6
7

• 右下（值:250 请求）

<Control>
    <CmdType>DeviceControlCmdType>
    <SN>130SN>
    <DeviceID>xxxDeviceID>
    <PTZCmd>A50F0105FAFA00AEPTZCmd>
Control>
1
2
3
4
5
6
7

• 停止（值:250 请求）

<Control>
    <CmdType>DeviceControlCmdType>
    <SN>130SN>
    <DeviceID>xxxDeviceID>
    <PTZCmd>A50F0100000000B5PTZCmd>
Control>
1
2
3
4
5
6
7

镜头放大/缩小

• 放大（值:250 请求）

<Control>
    <CmdType>DeviceControlCmdType>
    <SN>130SN>
    <DeviceID>xxxDeviceID>
    <PTZCmd>A50F01100000A065PTZCmd>
Control>
1
2
3
4
5
6
7

• 缩小（值:-250 请求）

<Control>
    <CmdType>DeviceControlCmdType>
    <SN>130SN>
    <DeviceID>xxxDeviceID>
    <PTZCmd>A50F01200000A075PTZCmd>
Control>
1
2
3
4
5
6
7

光圈放大/缩小

• 光圈放大（值:250 请求）

<Control>
    <CmdType>DeviceControlCmdType>
    <SN>130SN>
    <DeviceID>xxxDeviceID>
    <PTZCmd>A50F014400FA00F3PTZCmd>
Control>
1
2
3
4
5
6
7

• 光圈缩小（值:-250 请求）

<Control>
    <CmdType>DeviceControlCmdType>
    <SN>130SN>
    <DeviceID>xxxDeviceID>
    <PTZCmd>A50F014800FA00F7PTZCmd>
Control>
1
2
3
4
5
6
7

镜头聚焦/放焦

• 镜头聚焦（值:250 请求）

<Control>
    <CmdType>DeviceControlCmdType>v
    <SN>130SN>
    <DeviceID>xxxDeviceID>
    <PTZCmd>A50F0141FA0000F0PTZCmd>
Control>
1
2
3
4
5
6
7

• 镜头放焦（值:-250 请求）

<Control>
    <CmdType>DeviceControlCmdType>
    <SN>130SN>
    <DeviceID>xxxDeviceID>
    <PTZCmd>A50F0142FA0000F1PTZCmd>
Control>
1
2
3
4
5
6
7

界面展示