Bilive项目在macOS ARM64 Docker环境下合并模式录制问题的分析与解决

Bilive项目在macOS ARM64 Docker环境下合并模式录制问题的分析与解决

bilive 极快的B站直播录制、自动切片、自动渲染弹幕以及字幕并投稿至B站，兼容超低配置机器。 项目地址: https://gitcode.com/gh_mirrors/bi/bilive

问题背景

在macOS ARM64架构下使用Docker运行Bilive项目时，用户反馈在视频录制过程中选择了合并(merge)模式后，系统仅完成了录制阶段但未能成功上传视频文件。从日志分析来看，系统虽然显示了上传进度，但实际上并未执行视频上传操作。

技术分析

经过深入排查，发现问题根源在于render_then_merge函数中的视频分辨率识别与弹幕处理逻辑存在缺陷。具体表现为：

1. 视频分辨率识别问题：函数尝试通过get_resolution方法获取原始视频文件的分辨率信息，但在ARM64架构的Docker环境下，这一操作可能因兼容性问题而失败。

2. 弹幕处理流程缺陷：在获取分辨率后，系统将分辨率参数传递给process_danmakus函数进行弹幕处理，但由于前置步骤的失败，导致整个合并流程中断。

解决方案

针对上述问题，开发团队提出了以下修复方案：

1. 增强分辨率获取的健壮性：修改get_resolution方法的实现，确保其在跨平台环境下能够稳定工作，特别是针对ARM64架构的优化。

2. 完善错误处理机制：在视频处理流程中添加适当的错误捕获和处理逻辑，确保即使某个环节出现问题，系统也能给出明确的错误提示而非静默失败。

3. 统一处理逻辑：将合并模式与追加(append)模式的处理逻辑进行统一，避免因模式差异导致的代码不一致问题。

技术实现细节

修复后的代码结构更加清晰，主要修改点包括：

# 识别视频分辨率
resolution_x, resolution_y = get_resolution(original_video_path)
# 处理弹幕为ASS字幕格式并移除表情符号
subtitle_font_size, subtitle_margin_v = process_danmakus(
    xml_path, resolution_x, resolution_y
)

这一修改确保了：

• 视频分辨率获取的可靠性
• 弹幕处理与视频参数的匹配性
• 整个合并流程的完整性

影响范围评估

该问题主要影响：

• 使用macOS ARM64系统的用户
• 采用Docker容器部署的环境
• 选择视频合并(merge)模式的录制场景

对于其他使用场景（如直接运行、x86架构等）则不受此问题影响。

用户建议

对于遇到类似问题的用户，建议：

1. 更新到包含此修复的最新版本
2. 检查Docker环境配置，确保有足够的权限和资源
3. 监控日志输出，关注视频处理各阶段的完成状态
4. 如仍遇到问题，提供详细的日志信息以便进一步分析

总结

此次问题的解决不仅修复了macOS ARM64 Docker环境下合并模式录制的功能缺陷，更重要的是完善了项目的跨平台兼容性设计，为后续功能扩展奠定了更坚实的基础。开发团队将持续关注用户反馈，不断提升Bilive项目在不同环境下的稳定性和可靠性。

bilive 极快的B站直播录制、自动切片、自动渲染弹幕以及字幕并投稿至B站，兼容超低配置机器。 项目地址: https://gitcode.com/gh_mirrors/bi/bilive