Physical Address
304 North Cardinal St.
Dorchester Center, MA 02124
ISO/IEC 29341-18-12 — UPnP AVTransport v2 服务
UPnP AV 架构 — 家庭网络媒体设备的标准化播放控制
UPnP AVTransport v2 服务简介
ISO/IEC 29341-18-12 标准定义了 UPnP AVTransport v2 服务，这是 UPnP AV 架构的核心组件，负责家庭网络中音视频内容的播放控制管理。作为 ISO/IEC 29341 系列标准（原 UPnP 设备架构）的一部分，该服务规范提供了一个标准化接口，用于控制媒体渲染设备上的传输功能，如播放、暂停、停止、跳转和跳过等操作。
AVTransport v2 服务可以理解为 UPnP 媒体设备的”遥控器 API”。它将物理传输机制（DVD 播放器、流媒体缓冲区、磁带机）抽象为一组统一的动作，任何控制点都可以通过 IP 网络调用这些动作。
AVTransport 服务的 v2 版本在 v1 的基础上增加了对多传输实例的支持、增强的跳转模式、分组协调以及更丰富的状态报告功能。这使得它适用于现代多房间音频系统、家庭影院配置和同步媒体播放场景。该服务通常由媒体渲染器（如智能音箱、智能电视）托管，但也可以由提供流媒体内容特技播放控制的媒体服务器实现。
服务状态机定义了完整的播放生命周期，包括 STOPPED、PLAYING、PAUSED_PLAYBACK、PAUSED_RECORDING、RECORDING 和 TRANSITIONING 六个状态。每个状态转换由特定动作触发，并非所有转换都从每个状态有效——标准明确规定了允许的状态转换图。
关键动作与工程设计模式
AVTransport v2 服务定义了超过 20 个动作，包括 SetAVTransportURI（设置播放 URI）、Play（播放）、Pause（暂停）、Stop（停止）、Seek（跳转）、Next（下一曲）、Previous（上一曲）、GetPositionInfo（获取位置信息）、GetTransportInfo（获取传输信息）和 SetPlayMode（设置播放模式）等。SetAVTransportURI 动作尤为重要，它建立要播放的媒体资源，接受 URI 字符串和描述内容的可选元数据 XML 片段（DIDL-Lite 格式）。v2 规范通过 NextAVTransportURI 参数增加了对多个 URI 的支持，实现了无缝播放和播放列表排队。
| 传输状态 | 可执行动作 | 描述 |
|---|---|---|
| STOPPED | Play, Next, Previous, Seek | 未渲染媒体；准备开始播放 |
| PLAYING | Pause, Stop, Next, Previous, Seek, Record | 正在向用户渲染媒体 |
| PAUSED_PLAYBACK | Play, Stop, Next, Previous, Seek | 播放暂停在当前位置 |
| TRANSITIONING | 无 | 设备正在缓冲或准备新曲目 |
从工程角度来看，标准建议当设置了 NextAVTransportURI 时，实现应预缓冲下一曲目，以最小化连续曲目之间的间隔。这种模式通常称为”预读缓冲”，对于专业音频应用至关重要。Seek 动作支持多种跳转模式：ABS_TIME（绝对时间）、REL_TIME（相对偏移）、TRACK_NR（曲目编号），以及 v2 中新增的 FRAME（逐帧精确跳转）。
为了实现可靠的多房间同步，请始终使用来自单个主控制点的 GetPositionInfo 动作，而不是从多个点轮询。v2 规范对相对时间跟踪的支持使得在多个区域之间实现同步播放变得简单直接。
实际实现考量
在实现 AVTransport v2 服务时，有几个关键的工程考量。首先，LastChange 事件变量必须谨慎管理——它使用 XML 事件负载聚合自上次事件通知以来的所有状态变更。控制点通过 UPnP 事件机制（GENA）订阅此变量。与 v1 的逐变量事件方法相比，聚合 XML 减少了网络流量。对于实现者而言，合理设置事件通知的更新周期对于平衡实时性和网络负载非常重要。
其次，错误处理必须健壮。AVTransport 服务可以返回多种错误代码，包括 AVTransportURI Not Supported（702）、Play Mode Not Supported（703）和 Seek Mode Not Supported（704）。控制点 UI 必须优雅地处理每一个错误。第三，服务应实现 GetDeviceCapabilities 动作，以广告支持的播放媒体类型（音频、视频、图像）和录制媒体类型等特性。
第四，开发者需要理解 CurrentTransportActions 状态变量的重要性。该变量实时返回当前状态下可用的动作列表，控制点可以根据此信息动态启用或禁用 UI 控件。例如，当设备处于 TRANSITIONING 状态时，播放和暂停按钮应被禁用，直到过渡完成。这种动态 UI 更新机制对于提供流畅的用户体验至关重要，也是 v2 规范相对于 v1 的重要改进之一。
切勿在生产环境中忽视 AVTransport 服务的错误返回值。未处理的错误代码（如 702 URI 不支持）可能导致控制点 UI 状态与设备实际状态不一致，造成用户混淆和播放失败。所有 AVTransport 调用必须检查返回值和错误代码，并相应地更新用户界面状态。
请注意，某些媒体渲染器仅支持单个传输实例。控制点在新的 InstanceID 上启动播放前应查询 GetTransportInfo，以验证设备是否具有可用资源。多实例支持在高端 AV 接收器中很常见，但在廉价智能音箱中不太常见。开发者在设计多房间音频系统时应特别注意这一点，合理分配传输实例资源。
在实际部署中，开发者还应考虑 AVTransport 服务的并发控制问题。当多个控制点同时操作同一传输实例时，服务应实现合理的冲突解决策略。标准的做法是使用”最后写入胜出”策略，同时通过事件机制通知所有订阅的控制点状态变更。此外，AVTransportURI 和 NextAVTransportURI 的组合使用需要特别注意 URI 的有效性和可访问性验证，避免因为无效 URI 导致播放中断。
常见问题
问：AVTransport 和 ConnectionManager 服务有什么区别？
答：AVTransport 处理播放控制（播放、暂停、跳转），而 ConnectionManager 管理媒体源和接收器之间的逻辑连接（协议和内容格式协商）。两个服务通常在同一设备上实现。
答：AVTransport 处理播放控制（播放、暂停、跳转），而 ConnectionManager 管理媒体源和接收器之间的逻辑连接（协议和内容格式协商）。两个服务通常在同一设备上实现。
问：AVTransport v2 能否控制实时流媒体源？
答：可以，但可用的跳转和特技播放操作取决于流媒体协议。对于实时流，TransportState 可能保持在 PLAYING 状态，跳转能力有限。在启用跳转控制之前，务必检查 CurrentTransportActions。
答：可以，但可用的跳转和特技播放操作取决于流媒体协议。对于实时流，TransportState 可能保持在 PLAYING 状态，跳转能力有限。在启用跳转控制之前，务必检查 CurrentTransportActions。
问：AVTransport v2 中的无缝播放如何工作？
答：NextAVTransportURI 和 NextAVTransportURIMetaData 参数允许在当前曲目仍在播放时预加载下一曲目。设备应在当前曲目结束时实现无缝过渡或交叉淡入淡出。
答：NextAVTransportURI 和 NextAVTransportURIMetaData 参数允许在当前曲目仍在播放时预加载下一曲目。设备应在当前曲目结束时实现无缝过渡或交叉淡入淡出。
