Kodi 远程渲染——Symfonium 控制客厅的 Kodi 播放
两种 Kodi 接入方式
Symfonium 可以和 Kodi 配合两种角色：
| 角色 | 说明 |
|---|---|
| 媒体源 | Symfonium 从 Kodi 拉音乐曲库（详见 Kodi 媒体桥接） |
| 远程渲染器 | Symfonium 把 Kodi 当作 Chromecast / UPnP 那样的投屏目标——在 Symfonium 里选歌，Kodi 在客厅出声 |
这两个角色可以同时开：Symfonium 从 Kodi 拉曲库，同时投到同一个 Kodi 渲染器上播。
打开 Kodi 远程渲染
第一步：Kodi 端开启 Web 服务器
在 Kodi 里：Settings → Services → Web server：
- 启用 "Allow remote control via HTTP"
- 设置端口（默认 8080）
- 设置用户名和密码（安全起见强烈建议设，不要留空）
- 启用 "Allow remote control from applications on this system"（选 Allowing applications on this system 或 Allow from all 都行，按你的安全习惯）
第二步：Symfonium 端配对
Symfonium 设置 → Providers → Add media provider → Kodi：
- 输入 Kodi 设备的 IP 地址（客厅电视盒子的局域网 IP）
- 输入端口、用户名、密码
- 连接测试通过后完成
连接上后 Kodi 会出现在 Symfonium 的投屏目标列表里。
投屏到 Kodi
- Symfonium 播放界面 → 投屏按钮
- 选你的 Kodi 设备
- 开始投屏
Kodi 会在客厅电视上弹出 Symfonium 推送的曲目信息（封面、歌曲名、艺术家），声音从 Kodi 所在设备的 HDMI / 音频输出出来。
Kodi 渲染器的特殊性
- 格式兼容性：Kodi 自己的播放器底层是 FFmpeg，支持的格式比 Chromecast / Sonos 全多了——DSD、ALAC、Opus、M4A、WavPack 等都能直接播，Symfonium 基本不用转码
- 控制能力：Symfonium 能控制 Kodi 的播放 / 暂停 / 下一首 / 上一首，还能调音量
- 队列同步：Symfonium 里的播放队列会同步到 Kodi，Kodi 按顺序播
- DSP 限制：和其他远程渲染器一样，Symfonium 的 EQ / ReplayGain / 交叉馈送等 DSP 效果不生效——声音由 Kodi 自己解码和调音
适合哪些场景
- 客厅电视 / 盒子已经在跑 Kodi，想在手机上方便地选歌投过去播，不想装额外 App
- Kodi 本身就管理着客厅的媒体库（电影、音乐、播客），Symfonium 接过去能统一浏览 + 智能推荐 + 移动端 EQ
- 你的 Kodi 里已经配好了 HDMI 音频到功放 + 多声道，不想折腾 Chromecast
常见问题
- Symfonium 连不上 Kodi？ 检查 Kodi 的 Web 服务器有没有开、用户名密码对不对、设备 IP 有没有变、两端是否在同一 Wi-Fi、路由器有没有做 AP 隔离
- 投屏时客厅电视切到 Kodi 界面显示曲目？ 这是正常行为——Kodi 会显示当前播放的曲目信息。如果你只想让电视继续显示桌面 / 其他 App，就别用 Kodi 渲染器，换 Chromecast 或 Sonos
- Kodi 声音和画面不同步？ 这个是 Kodi 端的设置问题（Audio offset），和 Symfonium 无关。在 Kodi Settings → System → Audio 里调