Physical Address
304 North Cardinal St.
Dorchester Center, MA 02124
ISO/IEC 29341-20-4 — UPnP MediaServer v2 设备模板
UPnP AV 架构 — 家庭网络的全面媒体内容提供
MediaServer v2 设备模板简介
ISO/IEC 29341-20-4 标准定义了 UPnP AV MediaServer v2 设备模板，这是一个为向 UPnP 网络提供媒体内容的设备而制定的全面规范。MediaServer 设备模板将多个 UPnP 服务——通常包括 ContentDirectory v2（29341-18-13）、ConnectionManager v2（29341-18-6）和可选的 AVTransport v2（29341-18-12）——组合成一个连贯的设备类型，能够向家庭网络上的 MediaRenderer 提供音频、视频和图像内容。
MediaServer 是 UPnP 生态系统中的”内容库”。它可以是 NAS 驱动器、媒体服务器应用程序（如 Plex 或 Jellyfin）、符合 DLNA 标准的电视录制设备，或任何其他存储多媒体内容并向网络播放设备提供服务的设备。
v2 MediaServer 模板通过多项重大架构改进扩展了 v1 规范：支持单个设备上的多个内容目录、跨服务器的改进内容同步、增强的搜索能力（支持联合查询）、内容书签和恢复功能，以及来自多个来源（包括嵌入标签和外部数据库）的元数据丰富。
必需和可选服务
MediaServer v2 设备模板强制包含几个核心服务，并允许通过可选服务增强功能。强制性服务包括 ContentDirectory（用于内容浏览和搜索）、ConnectionManager（用于服务器和渲染器之间的协议和内容格式协商）以及设备描述本身（提供设备的友好名称、制造商、型号信息和图标 URL）。
| 服务 | 必需/可选 | 用途 |
|---|---|---|
| ContentDirectory v2 | 必需 | 浏览、搜索和枚举媒体内容层次结构 |
| ConnectionManager v2 | 必需 | 协商协议、传输格式和内容类型 |
| AVTransport v2 | 可选 | 服务器管理的播放控制和特技播放 |
| ScheduledRecording v2 | 可选 | 安排和管理 PVR 录制 |
| ContentSync v2 | 可选 | 跨多个服务器同步内容数据库 |
为获得最佳性能，请在 ConnectionManager v2 中实现 PrepareForConnection 动作。该动作为待处理连接预分配资源并返回 ConnectionID。调用控制点在启动实际 AVTransport 会话时使用此 ID。这可以防止多个控制点同时启动播放时可能发生的资源争用问题。
连接管理与协议协商
MediaServer 的一个关键功能是管理内容源和渲染设备之间的连接。ConnectionManager 服务通过 GetProtocolInfo 动作支持协议和格式协商，该动作返回源（MediaServer）和接收端（MediaRenderer）支持的传输协议（HTTP GET、RTSP、RTP、MMS）和内容格式（MIME 类型）列表。v2 规范通过基于能力的过滤增强了这一点，使用 GetCurrentConnectionInfo 动作提供有关活动连接的实时信息，包括带宽利用率和 QoS 参数。
MediaServer v2 还通过 GetMediaServerCapabilities 动作支持转码能力。支持转码的服务器可以在请求的 MediaRenderer 不支持原始格式时，动态地将内容从一种格式转换为另一种格式。例如，服务器可能将 DTS-HD Master Audio 音轨转码为 Dolby Digital Plus，以适应仅支持后者的渲染器。这通过 TranscodingCapabilities 状态变量进行广告，该变量列出了支持的输入到输出格式映射。
Browse 动作的性能是 MediaServer 用户感知最重要的指标。超过 2 秒的 Browse 响应会使整个系统感觉迟钝。实施积极的目录列表缓存，在经常查询的属性（dc:title、upnp:class、dc:creator）上使用数据库索引，并考虑预先计算”最近添加”和”最多播放”虚拟容器。
工程模式与实现策略
在实现 MediaServer v2 时，最关键的工程决策是内容数据库架构。服务器必须维护所有可用内容的索引数据库，包括元数据、封面艺术引用和资源 URI。数据库必须支持高效的分层浏览（用于 Browse 动作）和全文搜索（用于 Search 动作）。基于文件系统的实现适用于小型收藏（少于 1,000 个项目），但强烈建议大型收藏使用基于数据库的实现（SQLite、嵌入式数据库）。为了优化浏览性能，建议对经常查询的属性（dc:title、upnp:class、dc:creator）建立数据库索引，并预先计算”最近添加”和”最多播放”等虚拟容器。
对于拥有大量内容库的服务器（超过 10,000 个项目），v2 规范推荐实现延迟加载元数据。服务器不应在启动时扫描所有文件（这可能需要数分钟），而应执行快速初始扫描以发现新增和移除的文件，然后在项目首次被浏览或搜索时按需加载元数据。这大大减少了启动时间和内存使用。
v2 中引入的 ContentSync 服务解决了同一家庭网络中多个 MediaServer 的挑战。它定义了”同步组”概念，服务器可以订阅彼此的内容变更并维护统一的内容数据库。同步使用基于 SystemUpdateID 值的版本向量方法，每个服务器维护自己的更新计数器并与同步组中的对等服务器交换更改日志。这使得控制点可以看到所有服务器中的内容，而无需逐个查询每个服务器。
在实现转码时，始终尊重许可限制。许多音频和视频编解码器的转码操作需要专利许可。标准明确指出，实施者在商业产品中部署转码功能前必须确保适当的许可证。未获得适当许可就部署转码功能可能导致严重的法律风险。
常见问题
问：MediaServer 和 MediaRenderer 有什么区别？
答：MediaServer 提供内容（”源”），而 MediaRenderer 播放或显示内容（”接收端”）。单个设备可以实现两个角色——例如，智能电视可能同时是 MediaServer（流媒体到音箱）和 MediaRenderer（从 NAS 播放）。
答：MediaServer 提供内容（”源”），而 MediaRenderer 播放或显示内容（”接收端”）。单个设备可以实现两个角色——例如，智能电视可能同时是 MediaServer（流媒体到音箱）和 MediaRenderer（从 NAS 播放）。
问：MediaServer v2 能否与 v1 控制点和渲染器一起工作？
答：可以。v2 规范向后兼容。v1 控制点可以浏览 v2 服务器的内容，v1 渲染器可以播放 v2 服务器的内容。但仅 v2 的功能（ContentSync、增强搜索、转码）需要支持 v2 的组件。
答：可以。v2 规范向后兼容。v1 控制点可以浏览 v2 服务器的内容，v1 渲染器可以播放 v2 服务器的内容。但仅 v2 的功能（ContentSync、增强搜索、转码）需要支持 v2 的组件。
问：MediaServer 如何处理直播内容（IPTV 流）？
答：直播内容表示为 ContentDirectory 树中的项目，通常使用 “object.item.videoItem.broadcast” 类。资源 URI 指向直播流 URL。渲染器原生处理流媒体协议。
答：直播内容表示为 ContentDirectory 树中的项目，通常使用 “object.item.videoItem.broadcast” 类。资源 URI 指向直播流 URL。渲染器原生处理流媒体协议。
