Physical Address
304 North Cardinal St.
Dorchester Center, MA 02124
ISO/IEC 29341-18-3 — UPnP AV 设备配置 v2
UPnP AV 架构 — 音频、视频和系统参数的精细配置
AV 设备配置 v2 服务简介
ISO/IEC 29341-18-3 标准定义了 UPnP AV 设备配置 v2 服务，这是一个用于在细粒度层面配置 UPnP 音视频设备的专门服务。设备管理服务（29341-18-2）侧重于通用设备管理，而配置服务深入到影响 AV 功能的特定设置：音频输出参数（音量曲线、均衡器设置、环绕声配置）、视频输出参数（分辨率、宽高比、HDMI 握手）、输入源路由和网络流媒体偏好。
AV 设备配置服务是 AV 设备的”微调仪表板”。它为控制点提供了调整声场参数、视频处理选项和输入/输出路由的能力——这些设置通常可以在接收器的屏幕设置菜单中找到。
v2 规范通过支持配置模板（可以保存和调用的命名预设）、批量配置（原子性设置多个参数）、参数验证（范围检查、依赖验证）和配置锁定（防止多个控制点同时更改时产生冲突）扩展了基本配置模型。这些增强使其既适用于简单的家庭娱乐设置，也适用于具有集中管理的复杂商业 AV 安装，为用户提供灵活多样的配置管理方式。
配置参数模型
该服务将设备配置建模为配置参数的分层集合，每个参数具有名称、数据类型、当前值、默认值、允许值（范围或枚举）和访问权限（只读、读写、一次性写入）。参数按类别（AUDIO、VIDEO、NETWORK、INPUT、OUTPUT、SYSTEM）组织，使得控制点可以为用户呈现结构化的配置 UI。v2 规范引入了依赖参数，更改一个参数会自动触发相关参数的验证——例如，更改扬声器配置（5.1 到 7.1）会验证相应的音频输出分配仍然有效。
| 参数类别 | 示例参数 | 数据类型 |
|---|---|---|
| 音频 | 音量曲线, 均衡器模式, 扬声器配置, 唇音同步延迟 | string, int, enum |
| 视频 | 输出分辨率, 宽高比, HDR 模式, 色深 | enum, int |
| 网络 | 流媒体缓冲区大小, QoS 模板, 多播 TTL | int, enum |
| 输入 | 输入源标签, 输入 HDCP 模式, 音频回传通道 | string, enum |
| 输出 | 区域音量, 区域平衡, 区域启用 | int, boolean |
在实现配置参数树时，将参数组织为带有类别前缀的扁平结构（如 “AUDIO.VolumeCurve”、”VIDEO.Resolution”），而不是深度嵌套的层次结构。这简化了控制点实现并降低了参数查找操作的复杂性。
配置模板与锁定机制
v2 中最强大的功能之一是配置模板系统。配置模板是一个命名的、已保存的参数值集合，可以按需应用。例如，家庭影院系统可能有”电影之夜”、”音乐欣赏”和”游戏模式”模板，每个模板具有不同的音频处理设置、视频模式和输入路由。CreateProfile、ApplyProfile、DeleteProfile 和 GetProfileList 动作为这些模板提供完整的生命周期管理。
配置锁定机制解决了多控制点环境中的常见问题：两个用户同时尝试更改设置。v2 规范引入了基于 ConfigurationLock 状态变量的分布式锁模型。控制点在更改前获取锁，更改后释放锁。锁定包括 LockTimeout 机制，以防止无响应的控制点导致死锁。ConfigurationLockOwner 变量标识当前持有锁的控制点。
始终使用合理的默认超时时间（例如 30 秒）实现 LockTimeout 机制。如果控制点在持有锁时崩溃，其他控制点应在超时后能够强制获取锁。没有这个机制，一个崩溃的控制点可能使设备永久无法配置。
工程设计模式与实践考量
从工程角度来看，AV 设备配置 v2 服务中的参数验证系统尤其值得关注。GetParameterInfo 动作为每个参数返回详细的约束信息，包括允许值、范围边界、步长和相互依赖关系。这使得控制点可以呈现适当的 UI 控件（滑块、下拉框、复选框），而无需硬编码每种参数类型的知识。控制点只需查询设备的参数信息即可动态生成完整的配置 UI。此外，ConfigurationChanged 事件变量会在任何配置参数变更时发出信号，无论是本地用户、远程控制点还是自动流程触发的变更，事件负载包含已变更参数的路径列表，使控制点能够执行定向 UI 更新。
当设备恢复出厂设置时（通过 ResetConfiguration 动作），应删除所有用户模板，而不仅仅是活动设置。在出厂重置后保留孤立模板可能导致安全问题，使新用户无意中继承包含网络凭据或访问规则的先前配置模板。
对于商业 AV 部署，v2 规范对批量配置的支持非常宝贵。使用带有 ConfigurationProfileURI 参数的 SetConfigurationBulk 动作，管理控制台可以通过指向远程模板文件来配置设备。这使得在数字标牌、酒店和企业 AV 环境中能够集中管理大型设备群。这种集中管理方式大大降低了部署和维护成本，确保所有设备保持一致的配置状态。
常见问题
问：当两个控制点试图同时更改同一参数时会发生什么？
答：配置锁定机制防止冲突。控制点必须在更改前获取 ConfigurationLock。锁定具有超时机制，以防止无响应的控制点导致死锁。
答：配置锁定机制防止冲突。控制点必须在更改前获取 ConfigurationLock。锁定具有超时机制，以防止无响应的控制点导致死锁。
问：配置模板能否跨设备导出和导入？
答：可以。模板可以通过 GetProfile 导出为 XML，并使用 CreateProfile 动作导入到相同型号的其他设备。跨型号兼容性由制造商定义。
答：可以。模板可以通过 GetProfile 导出为 XML，并使用 CreateProfile 动作导入到相同型号的其他设备。跨型号兼容性由制造商定义。
问：依赖参数如何工作？
答：当参数更改影响其他参数时，服务会自动验证所有相关参数。SetConfigurationBulk 响应中包含自动调整的参数列表及其新值。
答：当参数更改影响其他参数时，服务会自动验证所有相关参数。SetConfigurationBulk 响应中包含自动调整的参数列表及其新值。
