1 专栏导读
本专栏第一篇文章「专栏开篇」列出了专栏的完整目录,按目录顺序阅读,有助于你的理解,专栏前面文章讲过的知识点(或代码段),后面文章不会赘述。为了节省篇幅,突出重点,在文章中展示的示例代码仅仅是关键代码,你可以在「专栏开篇」中获取完整代码。
如有错误,欢迎你的留言纠正!让我们共同成长!你的「点赞」或「打赏」是对我最大的支持和鼓励!
2 原理简介
IPC有关多媒体的参数,都是由媒体配置文件(media profile)来管理。想通过ONVIF协议修改IPC诸如分辨率这样的媒体参数,就得先弄懂媒体配置文件。
媒体配置文件(media profile)是用于管理音视频流相关的一系列配置的集合,一个配置文件由一系列相关联的配置类实体构成。配置类包括:
- Video source configuration(视频源配置)
- Audio source configuration(音频源配置)
- Video encoder configuration(视频编码器配置)
- Audio encoder configuration(视频编码器配置)
- PTZ configuration(PTZ配置)
- Video analytics configuration(视频分析配置)
- Metadata configuration(元数据配置)
- Audio output configuration(音频输出配置)
- Audio decoder configuration(音频解码器配置)
对应的结构体为:
struct tt__Profile {
char *Name;
struct tt__VideoSourceConfiguration *VideoSourceConfiguration;
struct tt__AudioSourceConfiguration *AudioSourceConfiguration;
struct tt__VideoEncoderConfiguration *VideoEncoderConfiguration;
struct tt__AudioEncoderConfiguration *AudioEncoderConfiguration;
struct tt__VideoAnalyticsConfiguration *VideoAnalyticsConfiguration;
struct tt__PTZConfiguration *PTZConfiguration;
struct tt__MetadataConfiguration *MetadataConfiguration;
struct tt__ProfileExtension *Extension;
char *token;
enum xsd__boolean *fixed;
};
一个tt__Profile结构体就是一个媒体配置文件,一个配置文件由全部的或部分的配置类实体组成,“部分”的意思是,对于不支持的功能(如PTZ),允许其配置信息为空(PTZConfiguration为NULL)。
这里有一个概念一定要理清楚,配置类和实体的区别:
- 就某个配置类而言,一个设备可以有多个实体。如「视频编码器配置」类,一个IPC设备至少包含两个「视频编码器配置」实体,分别关联主码流和辅码流,这两个「视频编码器配置」实体参数有所区别,如分辨率不同,码率不同等等。
- 一个媒体配置文件由一不同配置类的实体组成,同一配置类的不同实体,只能有一个实体跟媒体配置文件关联。
- 一个设备可以有多个媒体配置文件,如主码流、辅码流就是两个不同的媒体配置文件。
为了唯一标识某个配置实体,每个配置实体都有对应的唯一标识符token,很多的ONVIF媒体接口也是通过这些token来访问(修改)这些配置的。比如,视频源配置token、音频源配置token、视频编码器配置token,甚至连媒体配置文件本身都有token。如下图红色矩形框所示(GetProfiles接口):
3 函数接口
对于某个具体的配置类,ONVIF都提供了一套完整的函数接口,类似如下:
- AddXXXConfiguration:新增XXX配置
- RemoveXXXConfiguration:删除指定的XXX配置
- GetXXXConfigurations:获取所有的XXX配置
- GetXXXConfiguration:获取指定的XXX配置
- GetXXXConfigurationOptions:获取XXX配置选项集
- GetCompatibleXXXConfigurations:获取所有兼容的XXX配置
- SetXXXConfiguration:修改指定的XXX配置
将XXX替换成VideoEncoder,就得到了「视频编码器配置」类相关的ONVIF接口,其他配置类也如此:
- AddVideoEncoderConfiguration:新增视频编码器配置
- RemoveVideoEncoderConfiguration:删除指定的视频编码器配置
- GetVideoEncoderConfigurations:获取所有的视频编码器配置
- GetVideoEncoderConfiguration:获取指定的视频编码器配置
- GetVideoEncoderConfigurationOptions:获取视频编码器配置选项集
- GetCompatibleVideoEncoderConfigurations:获取所有兼容的视频编码器配置
- SetVideoEncoderConfiguration:修改指定的视频编码器配置
「媒体配置文件」与「视频编码器配置」的关系:
| ONVIF对应的函数接口 | 备注 |
---|
一个设备可以有多个「媒体配置文件」 | GetProfile GetProfiles | 比如主码流、辅码流,是两个相互独立的媒体配置文件。每个媒体配置文件的token不同。 |
一个设备可以有多个「视频编码器配置」实体 | GetVideoEncoderConfiguration GetVideoEncoderConfigurations | |
一个「媒体配置文件」只能关联一个「视频编码器配置」实体 | AddVideoEncoderConfiguration | |
每个「视频编码器配置」实体独享属于自己的一套参数选项集 | GetVideoEncoderConfigurationOptions | 比如IPC的主码流,视频分辨率只能设置为预先设定好的几个分辨率(选项集)中的一种,不能随意配置。可选择的分辨率是IPC出厂时就与设定好的,没法通过ONVIF接口增/删/改。 “独享”的意思,就是视频编码器配置1的分辨率,只能在视频编码器配置1中使用,不能在视频编码器配置2中使用。比如主码流的1080P分辨率,不能配置到辅码流中。 |
4 编码流程
IPC客户端通过ONVIF修改分辨率的步骤如下:
- 先通过GetProfiles获取所有媒体配置文件,可得知主/辅码流的视频编码器配置token;
- 由视频编码器配置token通过SetVideoEncoderConfiguration修改视频编码器配置(如修改分辨率、帧率、码率等);
- 修改的参数必须在GetVideoEncoderConfigurationOptions中的选项集范围内(即IPC出厂时预设定好的那几个选项集),如分辨率只能设置为那几种中的一种,不能随意设置。否则SetVideoEncoderConfiguration会返回失败。
- 每个视频编码器配置的分辨率可选集,只能自个使用,不能用于其他视频编码器配置中。比如主码流的1080P分辨率,不能配置到辅码流中,SetVideoEncoderConfiguration会调用失败。
5 示例代码
#include <stdio.h>
#include <stdlib.h>
#include <assert.h>
#include "onvif_comm.h"
#include "onvif_dump.h"
int ONVIF_GetVideoEncoderConfigurationOptions(const char *MediaXAddr, char *ConfigurationToken)
{
int result = 0;
struct soap *soap = NULL;
struct _trt__GetVideoEncoderConfigurationOptions req;
struct _trt__GetVideoEncoderConfigurationOptionsResponse rep;
SOAP_ASSERT(NULL != MediaXAddr);
SOAP_ASSERT(NULL != (soap = ONVIF_soap_new(SOAP_SOCK_TIMEOUT)));
memset(&req, 0x00, sizeof(req));
memset(&rep, 0x00, sizeof(rep));
req.ConfigurationToken = ConfigurationToken;
ONVIF_SetAuthInfo(soap, USERNAME, PASSWORD);
result = soap_call___trt__GetVideoEncoderConfigurationOptions(soap, MediaXAddr, NULL, &req, &rep);
SOAP_CHECK_ERROR(result, soap, "GetVideoEncoderConfigurationOptions");
dump_trt__GetVideoEncoderConfigurationOptionsResponse(&rep);
EXIT:
if (NULL != soap) {
ONVIF_soap_delete(soap);
}
return result;
}
int ONVIF_GetVideoEncoderConfiguration(const char *MediaXAddr, char *ConfigurationToken)
{
int result = 0;
struct soap *soap = NULL;
struct _trt__GetVideoEncoderConfiguration req;
struct _trt__GetVideoEncoderConfigurationResponse rep;
SOAP_ASSERT(NULL != MediaXAddr);
SOAP_ASSERT(NULL != (soap = ONVIF_soap_new(SOAP_SOCK_TIMEOUT)));
ONVIF_SetAuthInfo(soap, USERNAME, PASSWORD);
memset(&req, 0x00, sizeof(req));
memset(&rep, 0x00, sizeof(rep));
req.ConfigurationToken = ConfigurationToken;
result = soap_call___trt__GetVideoEncoderConfiguration(soap, MediaXAddr, NULL, &req, &rep);
SOAP_CHECK_ERROR(result, soap, "GetVideoEncoderConfiguration");
dump_trt__GetVideoEncoderConfigurationResponse(&rep);
EXIT:
if (NULL != soap) {
ONVIF_soap_delete(soap);
}
return result;
}
int ONVIF_SetVideoEncoderConfiguration(const char *MediaXAddr, struct tagVideoEncoderConfiguration *venc)
{
int result = 0;
struct soap *soap = NULL;
struct _trt__GetVideoEncoderConfiguration gVECfg_req;
struct _trt__GetVideoEncoderConfigurationResponse gVECfg_rep;
struct _trt__SetVideoEncoderConfiguration sVECfg_req;
struct _trt__SetVideoEncoderConfigurationResponse sVECfg_rep;
SOAP_ASSERT(NULL != MediaXAddr);
SOAP_ASSERT(NULL != venc);
SOAP_ASSERT(NULL != (soap = ONVIF_soap_new(SOAP_SOCK_TIMEOUT)));
memset(&gVECfg_req, 0x00, sizeof(gVECfg_req));
memset(&gVECfg_rep, 0x00, sizeof(gVECfg_rep));
gVECfg_req.ConfigurationToken = venc->token;
ONVIF_SetAuthInfo(soap, USERNAME, PASSWORD);
result = soap_call___trt__GetVideoEncoderConfiguration(soap, MediaXAddr, NULL, &gVECfg_req, &gVECfg_rep);
SOAP_CHECK_ERROR(result, soap, "GetVideoEncoderConfiguration");
if (NULL == gVECfg_rep.Configuration) {
SOAP_DBGERR("video encoder configuration is NULL.\n");
goto EXIT;
}
memset(&sVECfg_req, 0x00, sizeof(sVECfg_req));
memset(&sVECfg_rep, 0x00, sizeof(sVECfg_rep));
sVECfg_req.ForcePersistence = xsd__boolean__true_;
sVECfg_req.Configuration = gVECfg_rep.Configuration;
if (NULL != sVECfg_req.Configuration->Resolution) {
sVECfg_req.Configuration->Resolution->Width = venc->Width;
sVECfg_req.Configuration->Resolution->Height = venc->Height;
}
ONVIF_SetAuthInfo(soap, USERNAME, PASSWORD);
result = soap_call___trt__SetVideoEncoderConfiguration(soap, MediaXAddr, NULL, &sVECfg_req, &sVECfg_rep);
SOAP_CHECK_ERROR(result, soap, "SetVideoEncoderConfiguration");
EXIT:
if (SOAP_OK == result) {
SOAP_DBGLOG("\nSetVideoEncoderConfiguration success!!!\n");
}
if (NULL != soap) {
ONVIF_soap_delete(soap);
}
return result;
}
void cb_discovery(char *DeviceXAddr)
{
int stmno = 0;
int profile_cnt = 0;
struct tagProfile *profiles = NULL;
struct tagCapabilities capa;
ONVIF_GetCapabilities(DeviceXAddr, &capa);
profile_cnt = ONVIF_GetProfiles(capa.MediaXAddr, &profiles);
if (profile_cnt > stmno) {
struct tagVideoEncoderConfiguration venc;
char *vencToken = profiles[stmno].venc.token;
ONVIF_GetVideoEncoderConfigurationOptions(capa.MediaXAddr, vencToken);
ONVIF_GetVideoEncoderConfiguration(capa.MediaXAddr, vencToken);
venc = profiles[stmno].venc;
venc.Height = 960;
venc.Width = 1280;
ONVIF_SetVideoEncoderConfiguration(capa.MediaXAddr, &venc);
ONVIF_GetVideoEncoderConfiguration(capa.MediaXAddr, vencToken);
}
if (NULL != profiles) {
free(profiles);
profiles = NULL;
}
}
int main(int argc, char **argv)
{
ONVIF_DetectDevice(cb_discovery);
return 0;
}
- 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
- 112
- 113
- 114
- 115
- 116
- 117
- 118
- 119
- 120
- 121
- 122
- 123
- 124
- 125
- 126
- 127
- 128
- 129
- 130
- 131
- 132
- 133
- 134
- 135
- 136
- 137
- 138
- 139
- 140
- 141
- 142
- 143
- 144
- 145
- 146
- 147
- 148
- 149
- 150
- 151
- 152
- 153
- 154
- 155
- 156
- 157
- 158
- 159
- 160
- 161
- 162
- 163
- 164
- 165
- 166
- 167
- 168
- 169
- 170
- 171
- 172
- 173
- 174
- 175
- 176
- 177
- 178
- 179
- 180
- 181
- 182
- 183
- 184
- 185
- 186
- 187
- 188
- 189
- 190