Physical Address
304 North Cardinal St.
Dorchester Center, MA 02124
ISO/IEC IEC 29341-3-12:2011 — UPnP内容目录服务
在UPnP AV网络中组织、浏览和搜索媒体内容
内容目录服务：家庭媒体的数字图书馆
ISO/IEC 29341-3-12:2011规定了ContentDirectory:3服务，这一组件将UPnP媒体服务器从简单的文件服务器转变为智能媒体库。CDS将媒体项目（曲目、视频、图像、播放列表）组织到层次化的容器结构中，用标准化的元数据丰富它们，并向UPnP控制点公开强大的浏览和搜索能力。它是UPnP AV架构中最复杂、功能最丰富的服务。
CDS的容器隐喻有意模仿文件系统——不是因为文件是实现目标，而是因为层次化组织是内容导航最通用的范式。这一设计选择使得非技术用户通过简单的遥控器导航就能使用UPnP AV。
CDS的核心是管理一个对象树，其中每个对象要么是container（容器，一个分组节点），要么是item（项目，代表实际媒体内容的叶子节点）。容器和项目都携带以DIDL-Lite XML模式表达的元数据，该模式映射了Dublin Core元素（标题、创建者、日期）、UPnP AV特定属性（类、流派、专辑、艺术家）和资源描述符（比特率、分辨率、采样率、协议信息）。
浏览与搜索机制
Browse()动作
Browse()动作是内容导航的主要机制。它接受以下参数：ObjectID（要浏览的容器）、BrowseFlag（BrowseDirectChildren或BrowseMetadata）、Filter（所需元数据字段的逗号分隔列表）、StartingIndex和RequestedCount（用于分页）、以及SortCriteria。响应包括结果XML（DIDL-Lite片段）、NumberReturned、TotalMatches和用于缓存失效的UpdateID。
| Browse参数 | 值 | 描述 |
|---|---|---|
| ObjectID | “0”（根容器）、容器UUID | 要浏览的容器标识符 |
| BrowseFlag | BrowseDirectChildren, BrowseMetadata | 子项枚举与容器元数据 |
| Filter | dc:title, res, upnp:class, * | 请求的元数据字段（支持通配符） |
| StartingIndex | 0, 1, 2, … | 分页结果的零基偏移 |
| RequestedCount | 0（全部）、正整数 | 返回条目的最大数量 |
| SortCriteria | +dc:title, -upnp:date | 排序顺序（+升序、-降序） |
Search()动作
Browse()导航静态容器层次结构，而Search()在整个内容树上执行动态查询。搜索条件使用简单的搜索表达式语言，包含以下运算符：=（等于）、!=（不等于）、<、>、<=、>=、contains（包含）、doesNotContain（不包含）、derivedfrom（派生自）和exists（存在）。多个条件可以使用and和or组合。SearchClass参数将搜索限制在特定的内容类层次结构中。
性能优化：对于大型媒体库（超过10,000个项目），使用全文本索引在
dc:title、upnp:artist和upnp:album字段上实现数据库驱动的搜索。在简单的文件系统遍历上执行Search()动作可能需要数秒；而建立在索引的SQLite后端上的搜索在毫秒级返回结果。CDS实现的工程设计要点
实现高性能CDS需要仔细的架构决策。容器层次结构应使用支持高效子树查询的数据库模式。嵌套集模型（使用左/右索引）优于邻接表模型，因为它支持单查询子树检索——这对使用BrowseDirectChildren的Browse()动作至关重要。对于使用闪存存储的嵌入式设备，常用容器（如根容器、”所有音乐”、”所有视频”）的内存缓存可以减少数据库访问延迟。
状态变更通知是另一个关键方面。ContainerUpdateIDs和SystemUpdateID状态变量为已订阅的控制点提供变更跟踪。当内容发生变化时（添加了新曲目、编辑了元数据），CDS递增SystemUpdateID并发出包含已变更容器ID的事件。控制点利用此信息仅刷新其UI中受影响的部分，而不是重新浏览整个树。
状态变量设计说明：
ContainerUpdateIDs格式是”containerID,updateCount”对的逗号分隔列表。如果多个容器同时变更，所有受影响的ID必须包含在单个事件中。控制点应合并快速连续的事件（200毫秒内），以避免UI抖动。元数据可扩展性通过createClass和addClass机制处理。供应商可以通过派生自标准UPnP类来定义自定义内容类（例如object.item.audioTrack.digitalBook）。自定义元数据属性可以使用供应商特定的XML命名空间引入，并用唯一标识符前缀以避免命名冲突。
XML解析漏洞：DIDL-Lite响应是一个XML文档，可能引用外部实体。始终在XML解析器中禁用DTD处理和实体解析，以防止XXE（XML外部实体）攻击。这对于无法轻松应用安全补丁的嵌入式设备尤其关键。
常见问题
Q: DIDL-Lite响应的最大大小是多少？
UPnP设备架构将SOAP响应限制为1 MB。对于包含许多项目的容器，必须使用分页（
UPnP设备架构将SOAP响应限制为1 MB。对于包含许多项目的容器，必须使用分页（
StartingIndex和RequestedCount）。建议的页面大小为50-100个项目，以获得响应式UI性能。Q: CDS可以暴露不对应物理存储的虚拟容器吗？
可以。虚拟容器是创建动态分组的强大功能，例如”最近添加”、”最高评分”、”流派”或”年代”。这些容器在浏览时执行数据库查询，而不是映射到文件系统目录。
可以。虚拟容器是创建动态分组的强大功能，例如”最近添加”、”最高评分”、”流派”或”年代”。这些容器在浏览时执行数据库查询，而不是映射到文件系统目录。
Q: CDS如何处理媒体项目的更新，例如元数据编辑？
当元数据更改时，CDS递增
当元数据更改时，CDS递增
SystemUpdateID并为每个受影响的容器更新ContainerUpdateIDs。已订阅的控制点收到GENA事件并可以刷新其缓存。Q: “derivedfrom”搜索条件用于什么？
derivedfrom条件匹配从指定类派生的项目。例如，使用upnp:class derivedfrom "object.item.audioItem"搜索将返回所有音频项目，包括audioTrack、audioBook和audioBroadcast等子类。
