ONVIF源URL语法

ONVIF流的字符串格式如下(可选组件用方括号括起来):

onvif [s]: / /[用户名(密码):@]ip_address[:港口]/ server_URL [? param1 = val1 [¶m2 = val2]…[¶mN = valN]]

onvifu: / /[用户名(密码):@]uuid (? param1 = val1 [¶m2 = val2]…[¶mN = valN]]

下表描述了ONVIF流的字符串参数:

Ip_address或uuid (必选)服务器的IP地址或唯一标识符。一般情况下,ONVIF服务器使用DHCP自动获取IP地址。服务器通常提供用于检测服务器IP地址的实用程序。这可以是通常的IPv4格式(xx.xx.xx.xx),也可以是标准inet_addr函数接受的有效主机地址。例如,localhost相当于127.0.0.1。这通常是发送(服务器)计算机的IP地址。

也可以通过UUID访问设备。这是一个特殊的URL,唯一标识设备的ONVIF API端点。这种方法的优点是不受IP地址限制,可以在DHCP IP地址变化后连接到设备。

服务器的IP地址必须为单播。即使在请求到ONVIF服务器的多播连接时,也要使用到服务器的单播连接。在多播连接中,服务器将打开单独的多播连接来广播数据。但是当连接到服务器时,请连接到单播地址。

用户名 (可选)对于使用身份验证的服务器,必须将用户名作为连接字符串的一部分传递。
密码 (可选)对于使用身份验证的服务器,密码必须作为连接字符串的一部分传递。
server_URL 服务器的web服务端点。标准的服务器URL是“/onvif/device_service”,但不是所有设备都遵循这个标准。请参考服务器的手册获取。
paramN = valN (可选)用于修改过滤器或服务器行为的额外参数。参数可以是过滤器参数(例如G726Reversed=1),也可以是服务器参数(例如ONVIFProfile=MyProfile)。

过滤器使用的参数如下所示。下面没有列出的任何参数都被认为是服务器相关的,并传递给服务器:

参数 可能的值
ONVIFProfile (可选)该参数是一个字符串,用于设置要使用的ONVIF配置文件。默认情况下使用第一个可用概要文件。
G726Reversed (可选)G726数据是否反向编码。缺省值为0。设置为1以启用。
EnableSecurityUI (可选)对于需要用户名和密码的ONVIF服务器,该参数表示是否显示或隐藏用户名/密码界面。

0 -隐藏用户名/密码界面。这是默认值。

1 -显示用户名/密码界面。

如果设置为0,RTSP源将无法从使用安全性的RTSP服务器传输,除非在URL中输入了正确的用户名/密码。如果RTSP服务器需要用户名/密码,而URL不包含正确的用户名/密码,过滤器将无法加载或播放带有LTMM_E_RTSP_UNAUTHORIZED (0x80050037)错误码的流。

要以编程方式设置此值,请调用ILMONVIFSrc: EnableSecurityUI财产。

此协议前缀支持标准的非安全连接、使用SSL的安全连接和WS-discovery端点连接。

语法:

onvif: / /用户名:password@address:港口/ server_URL-到ONVIF设备的未加密连接(典型)

onvifs: / /用户名:password@address:港口/ server_URL—到ONVIF设备的加密连接

onvifu: / /用户名:password@uuid-用于浏览(广播搜索)设备的特殊URL,使用唯一标识符获取其端点

注意:在ONVIF URL中传递的任何额外参数都将提供给ONVIF API端点。如果底层源是RTSP流,这些额外的参数将不会传递到RTSP服务器。

注意:使用ONVIF属性页中的Browse按钮可以发现大多数设备。但是,有些设备可以配置为不可发现。也有可能设备在不同的网络上,因此无法被发现。在任何一种情况下,您都将被迫输入带有IP地址的完整URL。

注意:如果过滤器无法连接以检索所请求的流,则将返回WS_E_ENDPOINT_ACCESS_DENIED错误代码。如果身份验证失败(需要用户名和密码),也会返回此错误。

有效字符串的例子:

onvif: / / admin: admin@192.168.1.142 / onvif / device_service—使用用户名和密码“admin”连接到运行在192.168.1.142上的ONVIF设备。

onvifs: / / admin: admin@192.168.1.142 / onvif / device_service吗?ONVIFProfile = Profile2-使用用户名和密码“admin”安全地连接到运行在192.168.1.142上的ONVIF设备。发送的流应该符合名为“Profile2”的配置文件。

onvifu: / / admin: admin@4519e6f6 - 692 - c - 431 f - ecfc b0c55400b099吗?ONVIFProfile = MyProfile-使用自定义配置文件的唯一标识符连接到ONVIF设备。

注意:设备的UUID可以通过ONVIF Source Filter属性中的搜索机制获得。看到LEAD ONVIF源用户界面主题以获取更多信息。

LEADTOOLS过滤C API帮助
188金宝搏的网址客服|支持|联系我们|知识产权公告
©1991 - 2021领德科技有限公司版权所有。