信息技术 - UPnP设备架构 - 第20-4部分:音频视频设备控制协议 - 第4级 - 数据结构模板

[中文适用范围]： 本文件定义了 AV 数据结构模板 (AVDT) XML 文档的布局。AVDT 文档描述了各种数据结构在 UPnP AV 规范中使用的格式要求和限制。 尽管这些数据结构在其适当的服务规范中非常精确地定义，但大多数情况下，每个数据结构定义允许一定程度的变化以适应不同设备之间的差异。 AVDT 文档的目的是使每个设备能够在运行时描述其对这些 AV 数据结构的具体变体。 AVDT 文档允许使用 AV 数据结构 (例如 UPnP 控制点) 的用户减少那些与设备特定功能不兼容的数据结构实例的数量。 AVDT 文档的最终目标是通过提供有关设备特定功能的更多信息来减少由控制点创建超出设备静态 (已知) 能力的数据结构实例而导致的错误条件。 AVDT 机制无法消除所有可预防的错误条件，但它有助于通过向客户端提供更多设备信息来减少这些错误。 AVDT 文档是一个机器可读且特定于实现的 AV 数据结构，该数据结构由 UPnP AV 规范之一定义。 对于给定设备，每个该数据结构的实例都应同时符合规范定义和设备的 AVDT 定义。 [外文原描述]： ISO/IEC 29341-20-4:2017 defines the layout of the AV Datastructure Template (AVDT) XML document. An AVDT document describes the format requirements and restrictions of various data structures used within the UPnP AV specifications. Although these data structures are defined very precisely in the appropriate service specification, in most cases, each data structure definition allows for a certain degree of variation in order to accommodate differences between individual devices. The purpose of an AVDT document is to enable each device to describe (at run-time) its particular variation of these AV data structures. AVDT documents allow users of AV data structures (e.g. UPnP control points) to reduce the number of instances of those data structures that comply with the service specification but are not compatible with the device's particular capabilities. The ultimate goal of an AVDT document is to reduce those error conditions that are caused by control points creating instances of a data structure that exceed the static (known) capabilities of the device. Unfortunately, the AVDT mechanism will never eliminate all preventable error conditions, but it will help to reduce them by giving the client more information about the device's particular capabilities. As described above, an AVDT document is a machine readable, implementation-specific variant of an AV data structure defined by one of the UPnP AV specifications. For a given device, each instance of that data structure shall conform to both the specification definition and the device's AVDT definition of that data structure. Ironically, an AVDT document is both a more-restrictive and more-permissive variant of the specification definition. AVDT documents are more restrictive because they limit certain aspects of the data structure (e.g. such as the allowed values for each field) that are otherwise permitted by the specification definition. However, due to limitations of the AVDT constructs, it is simply not possible to express some of the more intricate requirements defined by the specification (e.g. subtle interdependencies between data structure fields). Consequently, instances of a data structure that comply with a given AVDT description may not fully comply with all of the requirements defined in the specification. The types of data structures that can be described by an AVDT document represent a (non-hierarchitical) set of named property values. The set of allowed property names and their allowed values for a given data structure are defined by one of the UPnP AV specifications. Individual instances of these data structures are manifested via an XML document whose elements and attributes correspond to the set of named properties. In other words, within the XML document that corresponds to a given instance of a certain data structure, each XML element and attribute contains the value of a specific named property. An AVDT document is conceptually similar to an XML schema in that both entities identify the XML elements and attributes that appear in any given document instance. Additionally, both AVDT documents and XML schemas identify the allowed values that are permitted for each element and/or attribute which corresponds to a specific property. However, unlike an XML schema, an AVDT document can also identify certain dependencies between two or more properties. For example, the set of allowed values of one property may depend on the actual value of another property. This type of interrelationship is difficult to represent using an XML schema. Hence, the AVDTdocument structure is needed. In the various AV Architecture scenarios, sometimes there is a need to exchange device capabilities to ensure high level interoperability. In order to express the parameterized capability, an AV specification defines various templates for each purpose. A device uses the template and populates it with values to reflect its capabilities at run-time. The AV Datastructure Template (AVDT) is a common structure to define various templates, which are called "Datastructure". This is written in XML and each data structure uses a subset of the AVDT to meet the necessary requirement.