1 专栏导读
本专栏第一篇文章「专栏开篇」列出了专栏的完整目录,按目录顺序阅读,有助于你的理解,专栏前面文章讲过的知识点(或代码段),后面文章不会赘述。为了节省篇幅,突出重点,在文章中展示的示例代码仅仅是关键代码,你可以在「专栏开篇」中获取完整代码。
如有错误,欢迎你的留言纠正!让我们共同成长!你的「点赞」或「打赏」是对我最大的支持和鼓励!
2 编码流程
ONVIF标准中,有 GetSystemDateAndTime和SetSystemDateAndTime两个接口用于获取、设置IPC的系统时间。接口使用大致流程:
- 搜索出IPC,得到IPC的「设备服务地址」。
- 根据「设备服务地址」,调用GetSystemDateAndTime和SetSystemDateAndTime接口。
3 注意事项
使用GetSystemDateAndTime和SetSystemDateAndTime这两个接口本是简单的事情,但是有一个细节需要注意,以SetSystemDateAndTime为例,看以上截图(来源于https://www.onvif.org/onvif/ver10/device/wsdl/devicemgmt.wsdl),其中两个字段:
-
TimeZone - 时区
时区字符串要符合POSIX 1003.1格式,如GMT+00:00、GMT+08:00、GMT-03:30等。
-
UTCDateTime - UTC时间
该字段要填充UTC时间,不是本地时间,不要搞错了。
IPC摄像头视频中显示的OSD时间,是本地时间,不是UTC时间,而本地时间跟「时区」息息相关。如果你设置了时间,视频OSD显示的时间又不是你预期的,就要注意这里面的关系了。
简单介绍下有关UTC的基础知识:
UTC + 时区差 = 本地时间
时区差,东正西负,北京时区是东八区,领先UTC八个小时,时区差记为+0800,所以
UTC + (+0800) = 北京时间
UTC与格林尼治平均时(GMT, Greenwich Mean Time)一样,都与英国伦敦的本地时相同。为了简单起见,可以认为UTC与GMT含义是一样的。
4 示例代码
IPC获取、设置系统时间的示例代码如下:
#include <stdio.h>
#include <stdlib.h>
#include <assert.h>
#include "onvif_comm.h"
#include "onvif_dump.h"
#ifdef WIN32
#include <windows.h>
#endif
int ONVIF_GetSystemDateAndTime(const char *DeviceXAddr)
{
int result = 0;
struct soap *soap = NULL;
struct _tds__GetSystemDateAndTime GetTm_req;
struct _tds__GetSystemDateAndTimeResponse GetTm_resp;
SOAP_ASSERT(NULL != DeviceXAddr);
SOAP_ASSERT(NULL != (soap = ONVIF_soap_new(SOAP_SOCK_TIMEOUT)));
ONVIF_SetAuthInfo(soap, USERNAME, PASSWORD);
memset(&GetTm_req, 0x00, sizeof(GetTm_req));
memset(&GetTm_resp, 0x00, sizeof(GetTm_resp));
result = soap_call___tds__GetSystemDateAndTime(soap, DeviceXAddr, NULL, &GetTm_req, &GetTm_resp);
SOAP_CHECK_ERROR(result, soap, "GetSystemDateAndTime");
dump_tds__GetSystemDateAndTime(&GetTm_resp);
EXIT:
if (NULL != soap) {
ONVIF_soap_delete(soap);
}
return result;
}
static void ONVIF_GetHostTimeZone(char *TZ, int sizeTZ)
{
char timezone[20] = {0};
#ifdef WIN32
TIME_ZONE_INFORMATION TZinfo;
GetTimeZoneInformation(&TZinfo);
sprintf(timezone, "GMT%c%02d:%02d", (TZinfo.Bias <= 0) ? '+' : '-', labs(TZinfo.Bias) / 60, labs(TZinfo.Bias) % 60);
#else
FILE *fp = NULL;
char time_fmt[32] = {0};
fp = popen("date +%z", "r");
fread(time_fmt, sizeof(time_fmt), 1, fp);
pclose(fp);
if( ((time_fmt[0] == '+') || (time_fmt[0] == '-')) &&
isdigit(time_fmt[1]) && isdigit(time_fmt[2]) && isdigit(time_fmt[3]) && isdigit(time_fmt[4]) ) {
sprintf(timezone, "GMT%c%c%c:%c%c", time_fmt[0], time_fmt[1], time_fmt[2], time_fmt[3], time_fmt[4]);
} else {
strcpy(timezone, "GMT+08:00");
}
#endif
if (sizeTZ > strlen(timezone)) {
strcpy(TZ, timezone);
}
return;
}
int ONVIF_SetSystemDateAndTime(const char *DeviceXAddr)
{
int result = 0;
struct soap *soap = NULL;
struct _tds__SetSystemDateAndTime SetTm_req;
struct _tds__SetSystemDateAndTimeResponse SetTm_resp;
char TZ[20];
time_t t;
struct tm tm;
SOAP_ASSERT(NULL != DeviceXAddr);
SOAP_ASSERT(NULL != (soap = ONVIF_soap_new(SOAP_SOCK_TIMEOUT)));
ONVIF_GetHostTimeZone(TZ, DIM(TZ));
t = time(NULL);
#ifdef WIN32
gmtime_s(&tm, &t);
#else
gmtime_r(&t, &tm);
#endif
memset(&SetTm_req, 0x00, sizeof(SetTm_req));
memset(&SetTm_resp, 0x00, sizeof(SetTm_resp));
SetTm_req.DateTimeType = tt__SetDateTimeType__Manual;
SetTm_req.DaylightSavings = xsd__boolean__false_;
SetTm_req.TimeZone = (struct tt__TimeZone *)ONVIF_soap_malloc(soap, sizeof(struct tt__TimeZone));
SetTm_req.UTCDateTime = (struct tt__DateTime *)ONVIF_soap_malloc(soap, sizeof(struct tt__DateTime));
SetTm_req.UTCDateTime->Date = (struct tt__Date *)ONVIF_soap_malloc(soap, sizeof(struct tt__Date));
SetTm_req.UTCDateTime->Time = (struct tt__Time *)ONVIF_soap_malloc(soap, sizeof(struct tt__Time));
SetTm_req.TimeZone->TZ = TZ;
SetTm_req.UTCDateTime->Date->Year = tm.tm_year + 1900;
SetTm_req.UTCDateTime->Date->Month = tm.tm_mon + 1;
SetTm_req.UTCDateTime->Date->Day = tm.tm_mday;
SetTm_req.UTCDateTime->Time->Hour = tm.tm_hour;
SetTm_req.UTCDateTime->Time->Minute = tm.tm_min;
SetTm_req.UTCDateTime->Time->Second = tm.tm_sec;
ONVIF_SetAuthInfo(soap, USERNAME, PASSWORD);
result = soap_call___tds__SetSystemDateAndTime(soap, DeviceXAddr, NULL, &SetTm_req, &SetTm_resp);
SOAP_CHECK_ERROR(result, soap, "SetSystemDateAndTime");
EXIT:
if (NULL != soap) {
ONVIF_soap_delete(soap);
}
return result;
}
- 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