基于 UPnP 的设备说明 是一个 XML 文档，用于描述设备的属性以及其中嵌套设备的层次结构。 UPnP 设备体系结构中定义了基于 UPnP 的设备说明的架构（称为 UPnP 模板语言 (UTL) ）。 设备说明包含 指向服务说明的链接。 服务说明的架构和服务 UTL 也在“UPnP 设备体系结构”规范中定义。
设备的开发人员必须提供设备的设备和服务说明。
托管设备开发人员必须提供的设备说明的元素与“UPnP 设备体系结构”规范中定义的元素相同，但有以下例外情况：
- controlURL 和 eventSubURL 元素是必需的，并且必须为空。 发布和宣布设备时，设备主机将填充这些字段的值。
- UDN 元素必须包含设备说明文档唯一的标识符， (也就是说，它不需要) 全局唯一。 此标识符用于查找设备主机生成的 UDN。
- SCPDURL 元素不得包含服务说明的 URL。 相反，它们必须包含服务说明文件的名称。 服务说明文件必须位于 资源目录中。 必须在注册过程中向设备主机提供此目录的位置，例如使用安装程序。 此路径及其下的所有路径都是基于已注册路径的相对路径。
- icon 元素中的 url 元素不得包含设备图标的 URL。 相反，它们必须包含图标文件的名称。 如果存在，图标文件必须位于资源目录中。 此路径及其下的所有路径都是基于已注册路径的相对路径。
- URLBase 元素不得存在。
注意
设备主机生成的所有 URL 都是相对 URL。 URL 相对于在初始设备公告中发送的设备说明文档的位置。
重要
请勿向设备说明文档添加注释，因为当通用即插即用设备主机尝试分析文档时，这可能会导致注册失败。
字符串长度限制
以下字符串长度用于采用 UPnP 技术的设备主机 API：
- deviceType – 64 字节
- friendlyName - 64 字节
- manufacturer – 64 字节
- modelDescription - 128 字节
- modelName – 32 字节
- modelNumber - 32 字节
- serialNumber – 64 字节
- UPC - 12 字节
- serviceType – 64 字节
- serviceId – 64 字节