ONVIF应用程序员指南

需积分: 50 161 浏览量更新于2024-07-23 收藏 939KB PDF 举报

"ONVIF应用程序员指南，版本1.0，由Open Network Video Interface Forum Inc.于2011年发布，是ONVIF程序员的重要参考资料。此文档允许复制、分发、发布或展示，但需保留版权通知、许可和免责声明。文档本身不提供修改许可，并明确指出‘按原样’提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途适用性、非侵权或所有权。同时，文档内容的实施不应侵犯任何专利、版权、商标或其他权利。如果因使用或分布此文档引发任何直接、间接、特殊、附带、惩罚性或后果性的损害，公司及其成员和他们的关联公司概不负责。" ONVIF（开放网络视频接口论坛）是一个国际标准组织，专注于制定网络视频监控设备的互操作性规范。ONVIF应用程序员指南是为开发人员提供的一份详细指南，帮助他们理解和实现ONVIF标准在自己的产品中的应用。在指南中，开发人员可以找到以下关键知识点： 1. **ONVIF标准介绍**：ONVIF定义了网络视频设备和服务之间的通信协议，包括设备发现、媒体服务、访问控制、事件管理等多个方面。这使得不同厂商的产品能够无缝集成，提高了整个行业的互操作性和兼容性。 2. **设备发现**：ONVIF提供了设备发现机制，使网络上的客户端能自动找到并识别支持ONVIF的设备。这通常基于UPnP（通用即插即用）协议的扩展。 3. **媒体服务**：这部分涵盖了视频流、音频流的传输和配置，包括不同的编码格式（如H.264、JPEG等）、分辨率、帧率等参数的设置。 4. **访问控制**：ONVIF定义了权限和认证模型，确保只有授权用户可以访问设备或其功能，通常结合HTTP基本认证、TLS/SSL安全传输等方式。 5. **事件管理**：ONVIF支持事件和报警服务，允许设备发送触发的事件信息，如移动检测、入侵报警等，便于实时监控和响应。 6. **设备配置**：指南会详细解释如何通过ONVIF接口对设备进行配置，包括设置网络参数、调整录像计划、配置PTZ（云台、焦距、变焦）控制等。 7. **客户端开发**：对于编写应用程序的程序员，指南会提供API调用示例和最佳实践，帮助他们构建与ONVIF设备交互的客户端软件。 8. **兼容性测试**：ONVIF可能还包含设备兼容性测试的指导，确保产品符合标准要求。 9. **安全考虑**：指南会讨论网络安全问题，如数据加密、防止未授权访问等，以确保设备在网络中的安全运行。 10. **版本更新**：ONVIF标准随着时间不断演进，程序员需要关注版本更新，以便及时适应新的功能和要求。通过深入学习和应用ONVIF应用程序员指南，开发者可以创建出符合行业标准的网络视频产品，增强产品的市场竞争力，并确保与各种其他ONVIF设备的无缝协作。

ONVIF

– 16 – ONVIF APG - Ver. 1.0

5 Initial Setup and Administration

5.1

First Actions After Discovery

After ONVIF devices are discovered using WS-Discovery, you would typically access a device

using the supplied XAddrs to test where it is reachable. Use device.GetSystemDateAndTime

to accomplish this because it should not require authentication. You can also consider calling

device.GetDeviceInformation and device.GetCapabilities.

5.1.1 Prerequisites

 Devices must already be discovered.

 At least one valid XAddrs for the device service entry point.

5.1.2 Targeted Services and Technologies

 [ONVIF/Device] and [devicemgmt.wsdl]

5.1.3 ONVIF::ProcessMatch

When processing the list of discovered devices, first do a

device.GetDeviceSystemDateAndTime() call:

 To determine if the device is reachable with the supplied XAddr

 To obtain the device time

 To determine the time offset, which will be used later when authenticating (see Section

6.1, Authentication, for more information)

he following subfunction describes how a ProbeMatch message should be processed. It takes

the following parameter:

 aProbeMatch - A ProbeMatch message received as reaction to a Probe request.

// Try to connect to the device and store the XAddr that works.

// Use GetSystemDateAndTime for checking and to get the time offset.

// Find out information and capabilities etc.

ProcessMatch(aProbeMatch)

{

// For authentication to work, it is important to have

// the same time in device and client so the Created time

// is not off with too much. E.g. 5 seconds.

// device.GetSystemDateAndTime should not require authentication,

// we use that function to check the XAddrs in the ProbeMatch response.

// onvifdev is a placeholder that we populate with valid XAddr,

// authentication info and capabilities etc.

onvifdev = App.createNewDeviceInstance();

device = null;

systemDateAndTime = ONVIF::CheckXaddrsAndGetTime(device, onvifdev, aProbeMatch);

if (!aSystemDateAndTime) {

// No valid response – probably communication or authentication failure!

// Return and try next XAddr

return;

}

// Generate a time offset based on device time

// Either UTCDateTime or LocalDateTime or both should be present.

devicetime = ParseSystemDateAndTime(aSystemDateAndTime);

ONVIF

– 17 – ONVIF APG - Ver. 1.0

// Store time offset in the device place holder for later use

// when creating service objects and handling authentication.

onvifdev.timeoffset = devicetime - time(NULL) - 1;

// Assign desired username and password to be used

// (framework dependant). See chapter 6.1 for details.

App.SetAuthenticationInformation(onvifdev);

ONVIF::UpdateCapabilities(device ,onvifdev);

}

5.1.4 ONVIF::UpdateCapabilities

After you have established a valid way to communicate with the device, use actions such as

GetDeviceInformation, GetCapabilities, and possibly GetSystemLog to obtain state and

capabilities for the device. You also must obtain the URIs for the various services that the device

supports.

Parameters are:

 device – An instance that represents the device service.

 onvifdev – Data object for collecting and combining device-specific information that is

required for various services. For example, storing service URLs that are required for

media, PTZ, or other services.

UpdateCapabilities(device, onvifdev)

{

aDeviceInformation = device.GetDeviceInformation();

// Store/Process interesting stuff from DeviceInformation

onvifdev.model = aDeviceInformation.Model;

onvifdev.serial = aDeviceInformation.SerialNumber;

// Get the capabilities and

// store all or interesting portions of the capabilities.

onvifdev.capabilities = device.GetCapabilities(Category = "All");

// Store the XAddr of the different services - these will be used

// later on when accessing Events and Media service.

onvifdev.devicexaddr = onvifdev.capabilities.Device.XAddr;

onvifdev.eventsxaddr = onvifdev.capabilities.Events.XAddr;

onvifdev.mediaxaddr = onvifdev.capabilities.Media.XAddr;

// Other and future ONVIF devices may have additional services

// If Capabilities/System/SystemLogging is true,

// the log could be interesting.

if (aProbeMatch.capabilities.System.SystemLogging) {

log = device.GetSystemLog(LogType = "System");

App.CheckLog(onvifdev, log);

}

NOTICE:

Service addresses are not fixed. They vary according to the vendor and device,

and might require different handling. Therefore, this information must be

updated dynamically.

剩余200页未读，继续阅读

streate

粉丝: 36
资源: 16

ONVIF应用程序员指南

onvif-java-lib-master.rar

happytime-onvif-server端测试软件

onvif-pdf_ONVIF_

onvif-study-data.rar_ONVIF_onvif IPC_onvif gsoap_onvif-study-dat

ONVIF_WG-APG-Application_Programmers_Guide-1.zip_ONVIF_onvif app

ONVIF Application Programmer's Guide

onvif开发程序员手册

ONVIF程序员开发向导

ONVIF客户端软件2014 NVC

ONVIF应用程序员指南

最新资源