feat(#632): 配音素材库音频架构统一，迁移到audio图层混音 #750

Merged

auto-approve-bot merged 1 commits from feat/voice-library-audio-unified-arch into develop 2026-07-23 10:43:48 +08:00

Conversation 5 Commits 1 Files Changed 3

+77 -11

xiaoxia commented 2026-07-23 10:36:45 +08:00

Owner

Copy Link

Copy Source

背景

一键生成路径中配音素材库音频使用独立的后处理 _mux_audio_track（直接ffmpeg mux替换音轨），与 UnifiedRenderService 的 audio 图层混音架构不统一，无法与 BGM/TTS 做混音音量平衡。

改动

1. UnifiedRenderService：新增 voiceover_audio_path 参数 + _maybe_add_voice_library_layer 方法，将配音素材库音频作为 audio 图层的 clip 加入统一混音链路
2. RenderAdapter：_do_render 和 render_from_memory 透传 voiceover_audio_path 参数
3. generation.py：删除后处理 _mux_audio_track 调用，配音音频直接传入渲染引擎

行为变化

• 从「替换原音轨」改为「混音叠加」，与 TTS 配音行为一致
• 支持配音 + BGM + 视频原声三者同时存在并正确混音
• 有配音时自动禁用直通模式（与 TTS 配音行为一致）

验证

• 162 个渲染单测全部通过
• 35 个 generation 单测全部通过
• 95 个 voice_library 单测全部通过

## 背景 一键生成路径中配音素材库音频使用独立的后处理 `_mux_audio_track`（直接ffmpeg mux替换音轨），与 UnifiedRenderService 的 audio 图层混音架构不统一，无法与 BGM/TTS 做混音音量平衡。 ## 改动 1. **UnifiedRenderService**：新增 `voiceover_audio_path` 参数 + `_maybe_add_voice_library_layer` 方法，将配音素材库音频作为 audio 图层的 clip 加入统一混音链路 2. **RenderAdapter**：`_do_render` 和 `render_from_memory` 透传 `voiceover_audio_path` 参数 3. **generation.py**：删除后处理 `_mux_audio_track` 调用，配音音频直接传入渲染引擎 ## 行为变化 - 从「替换原音轨」改为「混音叠加」，与 TTS 配音行为一致 - 支持配音 + BGM + 视频原声三者同时存在并正确混音 - 有配音时自动禁用直通模式（与 TTS 配音行为一致） ## 验证 - 162 个渲染单测全部通过 - 35 个 generation 单测全部通过 - 95 个 voice_library 单测全部通过

xiaoxia added 1 commit 2026-07-23 10:36:45 +08:00

feat(#632): 配音素材库音频架构统一，迁移到audio图层混音 ... cd8fb98c1b

- UnifiedRenderService 增加 voiceover_audio_path 参数
- 新增 _maybe_add_voice_library_layer 方法，配音素材库音频加到audio图层
- 与TTS配音、BGM共享统一混音链路，支持音量平衡
- RenderAdapter 透传 voiceover_audio_path 参数
- 删除一键生成路径中后处理 _mux_audio_track 调用
- 行为：从替换音轨改为混音叠加，与TTS配音行为一致

auto-approve-bot approved these changes 2026-07-23 10:42:13 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot approved these changes 2026-07-23 10:42:13 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

gitea-actions bot commented 2026-07-23 10:42:46 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#750
预览链接	https://pr-750.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #750 | | 预览链接 | [https://pr-750.preview.xiaoxiajianji.com](https://pr-750.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

auto-approve-bot merged commit 72b62a60c4 into develop 2026-07-23 10:43:48 +08:00

auto-approve-bot deleted branch feat/voice-library-audio-unified-arch 2026-07-23 10:43:49 +08:00

gitea-actions bot commented 2026-07-23 10:44:12 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #750 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #750 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

auto-approve-bot commented 2026-07-23 10:46:24 +08:00

Collaborator

Copy Link

Copy Source

代码审查结果 - PR #750

⚠️ 问题（0个需要修改）

无

💡 建议（1个可选）

1. unified_render_service.py 第859行：建议优化导入方式，避免在方法内部使用 from video_processing.unified_render_service import _LAYER_Z_INDEX。虽然这能解决常量定义顺序问题，但属于循环导入规避技巧，不够优雅。建议将 _LAYER_Z_INDEX 移至文件顶部定义，或重构为类常量/配置类。

---

✅ 格式检查通过 | ✅ 逻辑审查通过 | ✅ 性能良好

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-07-23 10:46:24 | 模型:}

## 代码审查结果 - PR #750 ### ⚠️ 问题（0个需要修改） 无 ### 💡 建议（1个可选） 1. `unified_render_service.py` 第859行：建议优化导入方式，避免在方法内部使用 `from video_processing.unified_render_service import _LAYER_Z_INDEX`。虽然这能解决常量定义顺序问题，但属于循环导入规避技巧，不够优雅。建议将 `_LAYER_Z_INDEX` 移至文件顶部定义，或重构为类常量/配置类。 --- ✅ 格式检查通过 | ✅ 逻辑审查通过 | ✅ 性能良好 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-07-23 10:46:24 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

Sign in to join this conversation.

Reviewers

No Reviewers

auto-approve-bot

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#750