Physical Address
304 North Cardinal St.
Dorchester Center, MA 02124
ISO/IEC 29341-17-11：UPnP AV ConnectionManager 服务
UPnP 音频/视频 — 第17-11部分：ConnectionManager 服务规范
1. ConnectionManager 服务架构与角色
ISO/IEC 29341-17-11 定义了 ConnectionManager 服务，这是 UPnP AV 架构中的一个基础组件，负责管理媒体源（Source）和接收器（Sink）之间连接的建立、监管和拆除。在典型的 UPnP AV 部署中，ConnectionManager 充当编排层的角色——它本身不传输媒体数据，而是协商媒体传输的参数，确保发送设备（如 MediaServer）和接收设备（如 MediaRenderer）在传输协议、数据格式和连接语义上达成一致，然后媒体字节才会通过网络传输。
ConnectionManager 服务同时托管在 MediaServer 和 MediaRenderer 设备上。在服务器端，它通告服务器可以提供的协议和内容格式。在渲染器端，它通告渲染器可以接受的协议和格式。控制点查询两端，选择兼容的组合，然后调用 PrepareForConnection 动作来建立媒体管道。这种以协商为中心的设计确保来自不同制造商的 UPnP AV 设备无需事先了解对方的能力即可实现互操作。
实现 ConnectionManager 时，请特别注意 protocolInfo 字段的格式。它使用四部分冒号分隔的元组：protocol:network:contentFormat:additionalInfo。一个错误的分隔符或缺失的字段会导致极难远程诊断的互操作性故障。
2. 协议协商与连接生命周期
协议协商过程从 GetProtocolInfo 动作开始。该动作返回两个列表：Source（设备可以发送的协议和格式）和 Sink（设备可以接收的协议和格式）。对于 MediaServer，Source 列表被填充，Sink 可能为空（或仅包含环回协议）。对于 MediaRenderer，Sink 列表被填充，Source 可能为空。protocolInfo 字符串遵循严格的格式——protocol:network:contentFormat:additionalInfo——其中 protocol 标识传输机制（如 http-get、rtsp、internal），network 指定网络类型（如 *、239.255.255.250:1900），contentFormat 标识 MIME 类型或 UPnP 类，additionalInfo 携带可选参数如打包模式或时钟频率。
一旦识别出兼容的协议，控制点调用 PrepareForConnection 来建立连接。该动作返回一个在整个连接生命周期内标识该连接的 ConnectionID，以及可选的 AVTransportID 和 RenderingControlID（如果连接与特定的传输和渲染实例关联）。连接可以是三种方向类型之一：Input（设备接收内容）、Output（设备发送内容）或 Direction（双向）。使用完毕后，控制点调用 ConnectionComplete 来拆除连接并释放相关资源。
| 动作 | 描述 | 关键参数 | 错误条件 |
|---|---|---|---|
| GetProtocolInfo | 检索支持的协议和格式 | 出参: Source, Sink（逗号分隔的 protocolInfo 列表） | 无——服务可用时始终成功 |
| PrepareForConnection | 建立媒体连接 | 入参: RemoteProtocolInfo, PeerConnectionManager, PeerConnectionID, Direction; 出参: ConnectionID, AVTransportID, RenderingControlID | 702（无此连接）资源耗尽时返回 |
| ConnectionComplete | 终止活动连接 | 入参: ConnectionID | 702（无此连接）ID 无效时返回 |
| GetCurrentConnectionInfo | 检索连接详情 | 入参: ConnectionID; 出参: ConnectionInfo 结构 | 702（无此连接）ID 未知时返回 |
| GetCurrentConnectionIDs | 列出所有活动连接 ID | 出参: ConnectionIDs（逗号分隔列表） | 无 |
PrepareForConnection 动作是少数可能对其他服务产生副作用的 UPnP 动作之一。准备连接时，ConnectionManager 可能创建关联的 AVTransport 和 RenderingControl 实例。工程师必须确保 ConnectionComplete 正确清理所有关联资源，包括传输和渲染实例，以防止资源泄漏。
3. ConnectionManager 的工程设计见解
实现健壮的 ConnectionManager 需要一丝不苟地关注资源管理。每个活动连接会消耗用于状态跟踪的内存，并可能保留硬件资源，如解码器管道、DMA 通道或网络套接字缓冲区。标准未指定最大并发连接数——这是实现定义的——但设计良好的设备应强制执行可配置的连接限制，并在达到限制时返回清晰的错误代码拒绝新的连接请求。
ConnectionID 是一个不透明标识符，必须在连接的整个生命周期内保持有效。工程师应将 ConnectionID 实现为单调递增的无符号整数或 UUID，在设备运行期间绝不重用已终止连接的 ID。重用 ID 可能导致控制点中微妙的错误，因为控制点可能缓存了连接状态且未能检测到先前连接的 ID 现在指向了一个完全不同的媒体流。
线程安全是另一个关键关注点。ConnectionManager 必须处理并发的 PrepareForConnection 和 ConnectionComplete 调用而不产生竞态条件。一种常见的实现模式使用由读写锁保护的连接表：查询动作（GetCurrentConnectionIDs、GetCurrentConnectionInfo）获取共享读锁，而修改动作（PrepareForConnection、ConnectionComplete）获取排他写锁。这种模式在允许并发查询的同时保持了一致性。
错误处理需要特别关注。当 PrepareForConnection 由于协议不兼容而失败时，动作应返回错误代码 702（无此连接）并附带描述性错误消息——而不是通用的 SOAP 错误。控制点使用特定的错误代码来确定是回退到替代协议还是通知用户不兼容问题。
实现连接健康监控系统，定期验证与每个连接关联的底层传输通道是否仍然功能正常。当连接的传输故障时（例如 TCP 套接字关闭），自动调用 ConnectionComplete 清理并通过 ConnectionStatus 事件变量通知已订阅的控制点。
切勿在 protocolInfo 字符串中嵌入用户可识别信息。protocolInfo 在 SSDP 发现和 SOAP 查询期间交换，可能将设备能力暴露给任何网络观察者。使用通用格式标识符（如 “video/mpeg” 而非 “video/mpeg;title=Confidential_Meeting_Recording”）以避免泄露敏感元数据。
4. 常见问题
问：单个设备能否同时支持到不同对等设备的多个并发连接？
答：可以。ConnectionManager 维护一个由 ConnectionID 索引的连接表，支持多个并发连接。每个连接是独立的，可以指向不同的对等设备，使用不同的协议参数。唯一的限制因素是设备的可用资源——内存、网络带宽和硬件解码器/编码器容量。
答：可以。ConnectionManager 维护一个由 ConnectionID 索引的连接表，支持多个并发连接。每个连接是独立的，可以指向不同的对等设备，使用不同的协议参数。唯一的限制因素是设备的可用资源——内存、网络带宽和硬件解码器/编码器容量。
问：如果控制点在流正在活跃传输时调用 ConnectionComplete，会发生什么？
答：ConnectionManager 应立即终止连接，无论流传输是否活跃。这可能导致对等设备检测到传输错误。设计良好的控制点应在终止连接前停止关联的 AVTransport（发送 Stop），但 ConnectionManager 必须优雅地处理突然终止的情况。
答：ConnectionManager 应立即终止连接，无论流传输是否活跃。这可能导致对等设备检测到传输错误。设计良好的控制点应在终止连接前停止关联的 AVTransport（发送 Stop），但 ConnectionManager 必须优雅地处理突然终止的情况。
问：ConnectionManager 如何处理对端设备意外消失的情况？
答：标准建议在 protocolInfo 传输层实现保活机制。当检测到传输超时时，ConnectionManager 应自动清理关联的连接并更新 CurrentConnectionIDs 状态变量，触发事件通知给已订阅的控制点。
答：标准建议在 protocolInfo 传输层实现保活机制。当检测到传输超时时，ConnectionManager 应自动清理关联的连接并更新 CurrentConnectionIDs 状态变量，触发事件通知给已订阅的控制点。
问：MediaServer 和 MediaRenderer 都必须实现 ConnectionManager 吗？
答：是的，ConnectionManager 是 MediaServer 和 MediaRenderer 设备类型的强制服务。没有它，控制点无法建立媒体连接，AV 架构基本的源-接收器交互模型将无法运作。
答：是的，ConnectionManager 是 MediaServer 和 MediaRenderer 设备类型的强制服务。没有它，控制点无法建立媒体连接，AV 架构基本的源-接收器交互模型将无法运作。
