Dolby Atmos FlexConnect SDK v1.1 文档总结

这篇写什么？

这是 Dolby Atmos FlexConnect for Home Devices SDK v1.1（发布于 2025-02-28）的阅读笔记。

它不是普通「使用说明书」，而是厂商用来 设计、开发、测试并获得 Dolby 认证 的完整技术资料包（System Development Kit / Add-on Kit）。

一句话：

电视（主控）+ 无线音箱任意摆放
→ Flexible Rendering + Acoustic Mapping
→ STEP 测完 → Dolby 终审 → 打上 Atmos 认证

相关文章：

• FlexConnect 方案概述
• 从硬件 RF 到校准的六层链路

一、这套文档是干什么的？

让 电视 + 无线音箱 组成一套系统：客厅里音箱随便放，也能协同播放沉浸式 Dolby Atmos。

核心技术叫 FlexConnect（灵活连接），两大能力：

典型场景：一台电视（主控）+ 多个无线音箱（可含低音炮）→ 自动校准 → 协同播 Atmos。

二、支持哪两类产品？

本 SDK 是 附加包（Add-on Kit），面向两条产品线：

1. MS12 产品（如 Android 电视）

• 基于 Dolby MS12 多流解码器
• 兼容 Android 11 / 12 / 14
• 最多支持 16 路渲染输出（v1.1 从约 10 路扩展）
• 声音在电视内置喇叭与无线音箱之间分配

2. Home Audio 产品（家庭音响）

• 基于 Dolby Atmos FlexConnect for Home Audio
• 面向音响主机 + 无线卫星音箱等方案

使用前提（必须先过基础认证）

三、SDK 包含什么？

Documentation/     → 技术文档（HTML + PDF）
Test_Materials/    → 测试用例、测试信号、测试模板
Tools/             → 开发与测试工具

文档入口：

Documentation/Start_Here.html → Kit_Wrapper/index.html

四、核心技术原理（开发指南重点）

4.1 设备组（Device Group）

• 必须有一台电视：Controller Device（主控）
• 搭配：一个或多个 Dolby Atmos 无线音箱；或 两个以上合规无线音箱 + 可选低音炮
• 可混合 Atmos 音箱与普通合规音箱

4.2 灵活渲染（Flexible Rendering）

• 按音箱类型、能力、位置动态分配音频
• 由 .sconf（流配置） 与 .dconf（设备配置） 驱动
• Frequency Sharing（频率共享）：把低频能量从能力弱的设备导向能力强的设备，提升整体音量与低频
• 音量控制需把增益传给 flap_gains，实现随音量变化的负载平衡

4.3 产品校准（Calibration）

• 首次设置或新增音箱时自动触发
• 流程：各音箱播校准信号 → 电视麦阵列录音 → 声学映射算位置 → 生成配置
• 校准中断：回退到 默认音箱位置图（Flex 模式）
• Android 电视需集成 Dolby Calibration API（示例：Tools/DolbyCalibration/）

工程侧「Bridge / modelName / setDevices」见：六层链路。

4.4 声学映射（Acoustic Mapping）

• 用电视麦克风阵列测各无线音箱相对位置
• 生成二维音箱地图（电视、音箱、听音者相对关系）
• 对 麦克风信号与播放参考之间的时间精度 要求很高
• 麦克风硬件有专门规格（如 Mic-44、Mic-45）

4.5 无线连接（两大硬指标）

4.6 信号处理

• MS12 / Home Audio 处理后的信号，不能再做破坏 Atmos 体验的额外处理
• 可集成 DAP（对话增强、音量平衡、环绕等）
• 出厂前需做 Tuning（调音）

4.7 用户界面（UI）

• Atmos 标识显示规则（v1.1：Flex 模式下禁止显示 Atmos 标识——校准跳过或未完成时）
• 校准引导界面
• 新音箱接入时的发现与校准提示（如 Fun-319、Fun-320）

五、认证要求体系（Requirements）

文档用编号条目规定必须满足的条件：

v1.1 增删较多，例如新增 / 调整 UI-Ind-194210、Fun-313320、Lat-13、Map-6、Mic-44/45 等；并移除 UI-Ind-167、Lat-12、Fun-264、Perf-60 等（以官方变更表为准）。

六、测试与认证流程

6.1 推荐使用 STEP

STEP（System Test Evaluation Platform） 是图形化测试主工具：

1. 安装 STEP（Tools/application/，v4.4.0）
2. 填写问卷，生成针对你产品的测试套件
3. 加载 .tdb 测试数据库（不可随意移动文件位置）
4. 按测试指南执行
5. 向 Dolby 提交结果，等待终审

6.2 测试类型

6.3 辅助工具

七、v1.1 相对 v1.0 的主要更新

文档

• 麦克风：Mic-44 替代 Mic-43，Mic-45 替代 Mic-40
• 大量 UI / 功能 / 延迟 / 映射 / 调音类要求增删

测试材料

• 无线同步测试频率与 WLT-58 对齐
• MS12 渲染输出扩展到 16 路
• Capture Stack、映射精度、Atmos 指示等测试更新
• 新增 Tuning Mode 测试
• 合并 Android 14 AV Sync 测试

工具

八、已知问题（文档注明）

• 部分测试仍引用 MS12 v2.8 / Home Audio v1.8 的测试材料
• Electrical_tests_02_DAP_virtualizer_negative 在输出静音时可能 误报通过
• Safari 在 Downloads 打开离线 HTML 可能样式异常（建议 Firefox，或放到 Documents）
• 参考 MS12 v2.8 实现仍可能限制约 10 路渲染、dconf 约 12000 字节
• zip 建议解压到 较短路径，避免路径过长

九、文档结构一览

Kit_Wrapper（总览）
├── How to use this kit
├── Documentation
├── Tools
├── Test materials
└── Glossary

DolbyAtmosFlexConnectForMS12/
├── System Development Guide
├── System Testing Guide
└── Speaker Placement Guide

DolbyAtmosFlexConnectForHomeAudio/
├── System Development Guide
├── System Testing Guide
└── Speaker Placement Guide

十、一句话总结

FlexConnect SDK v1.1 = 电视 + 无线音箱协同播 Atmos 的完整开发与认证包。
厂商按文档做完灵活渲染、声学校准、无线同步与 UI，用 STEP 跑完全部测试并提交 Dolby 审批后，才能正式打上 Dolby Atmos 认证。