Skip to content

Latest commit

 

History

History
61 lines (50 loc) · 3.09 KB

09.05.04.md

File metadata and controls

61 lines (50 loc) · 3.09 KB

9.5.4 消息描述语言（Message Description Language）

上一节中介绍了消息有效载荷的结构。该结构包含三组：Source、Key和Data。每个组包含一套Simple和ElementItems。对于每个topic，设备可以描述哪些项将使用消息描述语言产生这个topic的部分通知。下面的描述语言描述了消息项的强制性（请注意，这里包含的结构描述仅供参考。[ONVIF Schema]包含标准结构描述定义）：

<xs:complexType name="MessageDescription">
	<xs:sequence>
		<xs:element name="Source" type="tt:ItemListDescription" minOccurs="0"/>
		<xs:element name="Key" type="tt:ItemListDescription" minOccurs="0"/>
		<xs:element name="Data" type="tt:ItemListDescription" minOccurs="0"/>
		...
	</xs:sequence>
	<xs:attribute name="IsProperty" type="xs:boolean"/>
</xs:complexType>

<xs:complexType name="ItemListDescription">
	<xs:sequence>
		<xs:element name="SimpleItemDescription" minOccurs="0" maxOccurs="unbounded">
			<xs:complexType>
				<xs:attribute name="Name" type="xs:string" use="required"/>
				<xs:attribute name="Type" type="xs:QName" use="required"/>
			</xs:complexType>
		</xs:element>
		<xs:element name="ElementItemDescription" minOccurs="0" maxOccurs="unbounded">
			<xs:complexType>
				<xs:attribute name="Name" type="xs:string" use="required"/>
				<xs:attribute name="Type" type="xs:QName" use="required"/>
			</xs:complexType>
		</xs:element>
	</xs:sequence>
</xs:complexType>

一个项（Item）的名称属性应该独立于它的所属组（Source，Key，Data），在所有的项（Items）中是唯一的。当所描述的消息涉及到属性时，IsProperty属性应当设置为true。然而，如果该消息没有涉及到属性，那么Key组应不存在。一个SimpleItemDescriptor的Type属性应当使用XML结构描述（内置简单类型）、ONVIF标准结构描述或者vendor结构描述中定义的简单类型。同样，一个ElementItemDescriptor的Type属性应匹配一个XML结构描述声明的全局元素。

消息描述语言兵不强制每个Source、Key和Data在项中的顺序。另外，被一个可选的ONVIF事件定义记录的项不需要出现在消息中。这也适用于相关MessageDescription中所描述的可选项。

所有结构描述文件用来描述消息负载的位置都中列在了9.8节的GetEventPropertiesResponse消息中。

9.5.4.1 消息描述示例（Message Description Example）

下面的代码是一个对应9.5.3节中属性示例的消息描述示例：

<tt:MessageDescription IsProperty="true">
	<tt:Source>
		<tt:SimpleItemDescription Name="VideoSourceConfigurationToken" Type="tt:ReferenceToken"/>
		<tt:SimpleItemDescriptionD Name="VideoAnalyticsConfigurationToken" Type="tt:ReferenceToken"/>
		<tt:SimpleItemDescription Name="Rule" Type="xs:string"/>
	</tt:Source>
	<tt:Key>
		<tt:SimpleItemDescription Name="ObjectId" Type="xs:integer"/>
	</tt:Key>
	<tt:Data>
		<tt:SimpleItemDescription Name="IsInside" Type="xs:boolean"/>
	</tt:Data>
</tt:MessageDescription>

上一章|继续阅读