ONVIF-Core event [6][Topic Structure]

9.6 Topic Structure
该标准扩展了[WS-Topics]规范中定义的Topic框架。

第9.6.1节介绍了ONVIF主题命名空间。第9.6.2节将9.4.3节中定义的消息描述语言合并到TopicSet结构中，此外，第9.7节定义了一个允许客户端获取此信息的接口。设备支持的主题表达方言(Dialects)在第9.6.3节中定义。

具体事件定义在服务规范(service specifications)的“事件”部分中指定。

9.6.1 ONVIF Topic Namespace
[WS-Topics]规范区分了属于某个主题名称空间的主题树(Topic Tree)的定义和某个Web服务支持的主题集(Topic Set)。这种区别允许供应商在仅使用一部分已定义主题的情况下引用公共主题名称空间。

如果现有主题名称空间的主题树仅覆盖设备可用主题的子集，则可以通过定义新的主题名称空间来增长主题树。如[WS-Topics]规范中所述，通过将新主题附加到现有主题名称空间来定义新的主题名称空间。

引用ONVIF主题名称空间中的主题的所有通知均应使用第0节中所述的消息格式。

9.6.2 Topic Type Information
设备应在设备支持的主题集中表示主题的所有元素下面添加MessageDescription元素，该元素类型为9.4.3节中定义的MessageDescriptionType.设备应在第9.4.3节中定义的MessageDescriptionType类型的MessageDescription元素的下方，在表示该设备支持的主题集中的主题的所有元素之下。此外，设备应根据通知规范，通过将wstop：topic属性包含值“ true”来标识表示主题集中主题的所有元素。

下面的示例演示如何使用消息描述来扩充TopicSet的Topics：
<wstop:TopicSet
xmlns=””>
tns1:RuleEngine


tt:MessageDescription
tt:Source
<tt:SimpleItemDescription Name=“VideoSourceConfigurationToken”
Type=“tt:ReferenceToken”/>
<tt:SimpleItemDescription Name=“VideoAnalyticsConfigurationToken”
Type=“tt:ReferenceToken”/>
<tt:SimpleItemDescription Name=“Rule” Type=“xs:string”/>
</tt:Source>
tt:Data
<tt:SimpleItemDescription Name=“ObjectId” Type=“xs:integer”/>
</tt:Data>
</tt:MessageDescription>
</ Crossed>



<tt:MessageDescription IsProperty=“true”>
tt:Source
<tt:SimpleItemDescription Name=“VideoSourceConfigurationToken”
Type=“tt:ReferenceToken”/>
<tt:SimpleItemDescription 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>


</tns1:RuleEngine>
</wstop:TopicSet>

注意示例中包括xmlns =“”以确保在范围(scope)内没有TopicSet元素的任何后代(descendents)的默认名称空间，有关更多信息，请参见[WS-Topics]规范。

9.6.3 Topic Filter
略