ArxchiboboandClaude Sonnet 4.5
a15d4b255e
新增功能: - 添加3个新视频格式: h264-advanced, h264-high444, ffmpeg-manual - 新增9个高级参数: preset, tune, crf, pix_fmt, colorspace等 - 支持yuv420p (Mac兼容) 和 yuv444p (专业后期) 像素格式 - 实现三级模式: 标准模式/高级模式/手动模式 - 自动处理High444 profile和色彩元数据 代码改进: - 优化VIDEO_FORMATS字典,添加兼容性标记 - 扩展INPUT_TYPES,添加完整的高级参数支持 - 增强_create_video方法,智能处理不同模式 - 调整默认CRF值从19到20 (Mac推荐值) 文档新增: - VIDEO_FORMATS_GUIDE.md: YUV格式完整教程 - QUICK_REFERENCE.md: 快速参考卡片 - USAGE_GUIDE.md: 详细使用指南 - INTEGRATION_SUMMARY.md: 技术整合总结 - COMPLETION_REPORT.md: 完成报告 工具脚本: - simple_check.py: 简单验证脚本 - verify_integration.py: 完整验证脚本 h264-high444模块: - 独立的H.264 High 4:4:4编码节点 - 支持专业yuv444p格式 - 完整的色彩管理和高级参数 技术亮点: - 向后兼容,不影响现有工作流 - 默认配置确保Mac/iOS兼容性 - 清晰的兼容性标注和中文提示 - 完善的三层文档体系 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
8.3 KiB
8.3 KiB
🎬 视频格式快速参考卡片
1️⃣ 我应该选择哪个格式?
┌─────────────────────────────────────────────────┐
│ 需要在Mac/iPhone上播放? │
│ 需要分享给他人? │
│ 发布到社交媒体? │
│ ├─ 是 → 选择 video/h264-mp4✅ │
│ └─ 否 → 继续下一步 │
└─────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────┐
│ 需要最高色彩保真度? │
│ 进行专业后期制作? │
│ 制作绿幕特效? │
│ ├─ 是 → 选择 video/h264-high444 ⚠️ │
│ │ (Mac不兼容,仅Windows/Linux) │
│ └─ 否 → 选择 video/h264-mp4 ✅ │
└─────────────────────────────────────────────────┘
2️⃣ 格式速查表
| 我想... | 选择这个格式 | Mac兼容 |
|---|---|---|
| 日常使用,发社交媒体 | video/h264-mp4 ✅ |
✅ 完美 |
| 节省空间,4K视频 | video/h265-mp4 |
✅ 支持 |
| 网页嵌入播放 | video/vp9-webm |
✅ 支持 |
| Mac原生格式 | video/mov |
✅ 完美 |
| 自定义编码参数 | video/h264-advanced ⚙️ |
⚠️ 看配置 |
| 专业后期,最高质量 | video/h264-high444 🎥 |
❌ 不兼容 |
| 完全手动控制 | video/ffmpeg-manual 🔧 |
⚠️ 看配置 |
3️⃣ 质量参数速查
简单模式 (quality参数)
quality: 95-100 → 接近无损,文件很大
quality: 85-90 → 高质量,推荐日常使用 ✅
quality: 70-80 → 好质量,文件适中
quality: 50-60 → 可接受,文件较小
quality: <50 → 质量明显下降
高级模式 (CRF参数)
CRF 0-17 → 视觉无损,文件巨大
CRF 18-20 → 极高质量,推荐存档 ✅
CRF 21-23 → 高质量,推荐日常 ✅
CRF 24-28 → 好质量,文件适中
CRF 29+ → 质量下降
4️⃣ 像素格式选择
┌──────────────────────────────────────────┐
│ yuv420p │
│ ✅ Mac/iOS/Android全兼容 │
│ ✅ 所有播放器支持 │
│ ✅ 文件大小小 │
│ ⭐⭐⭐⭐ 95%色彩精度 │
│ → 日常使用推荐 │
└──────────────────────────────────────────┘
┌──────────────────────────────────────────┐
│ yuv444p │
│ ❌ Mac/iOS不兼容 │
│ ⚠️ 部分Android设备支持 │
│ ✅ Windows/Linux支持 │
│ 📈 文件大50% │
│ ⭐⭐⭐⭐⭐ 100%色彩精度 │
│ → 专业后期推荐 │
└──────────────────────────────────────────┘
5️⃣ 常见场景配置
🎯 场景: 发布到YouTube/Bilibili
format: video/h264-mp4
quality: 85
frame_rate: 30 或 60
为什么?
- H.264最广泛支持
- yuv420p确保兼容性
- quality 85平衡质量和文件大小
🎯 场景: 分享给Mac用户
format: video/h264-mp4
quality: 85-90
或使用QuickTime原生格式:
format: video/mov
quality: 85-90
为什么?
- 确保Mac/iPhone完美播放
- MOV是Mac原生格式
🎯 场景: 高质量视频存档
format: video/h264-advanced
advanced_crf: 18
advanced_preset: slow
advanced_pix_fmt: yuv420p # 保持兼容性!
为什么?
- CRF 18接近无损
- preset=slow获得最佳压缩
- 仍然使用yuv420p保证兼容
🎯 场景: 专业后期制作素材
format: video/h264-high444
# 或
format: video/h264-advanced
advanced_pix_fmt: yuv444p
advanced_crf: 16
advanced_preset: slow
注意:
- ⚠️ Mac不能播放
- 仅用作中间格式
- 最终导出前转换为yuv420p
🎯 场景: 绿幕抠像视频
format: video/h264-advanced
advanced_pix_fmt: yuv444p # 色度边缘更锐利
advanced_tune: film
advanced_crf: 16
为什么?
- yuv444p保留完整色度信息
- 色键抠像更精确
- tune=film优化电影感
6️⃣ Preset参数说明
ultrafast → 极快,质量差 (实时直播)
superfast → 很快,质量一般
veryfast → 快,质量尚可
faster → 较快,质量好
fast → 快,质量很好
medium → 适中,质量优秀 ← 推荐日常 ✅
slow → 慢,质量极佳 ← 推荐存档 ✅
slower → 很慢,质量最佳
veryslow → 极慢,质量顶级 (电影制作)
7️⃣ Tune参数说明
none → 通用优化 (默认)
film → 电影内容
animation → 动画内容
grain → 保留胶片颗粒
stillimage → 静态图片序列
fastdecode → 快速解码
zerolatency → 低延迟 (直播)
8️⃣ 故障排查
❌ 问题: Mac上视频显示黑屏
原因: 使用了yuv444p格式
解决:
- 重新生成,选择
video/h264-mp4 - 或转换现有视频:
ffmpeg -i input.mp4 -c:v libx264 -pix_fmt yuv420p output.mp4
❌ 问题: 文件太大
解决方案:
方案1: 调整quality参数
quality: 70-80 # 从85降低
方案2: 使用H.265压缩
format: video/h265-mp4
方案3: 调整CRF (高级模式)
advanced_crf: 23-25 # 从18-20提高
❌ 问题: 编码太慢
解决方案:
方案1: 使用更快的preset
advanced_preset: fast 或 veryfast
方案2: 降低分辨率
- 在生成图像时就使用更小的分辨率
❌ 问题: 颜色看起来不对
解决方案:
方案1: 调整色彩空间
advanced_colorspace: bt709 # HD视频
advanced_colorspace: bt601 # SD视频
方案2: 调整色彩范围
advanced_color_range: pc # 0-255全范围
advanced_color_range: tv # 16-235有限范围
9️⃣ 命令行验证视频格式
# 检查视频编码信息
ffprobe -v error -select_streams v:0 \
-show_entries stream=codec_name,pix_fmt,profile \
-of default=nw=1 video.mp4
# 期望输出 (Mac兼容):
h264
yuv420p
High
# 如果输出yuv444p,说明Mac不兼容!
🔟 一句话总结
┌────────────────────────────────────────────────────┐
│ │
│ 如果不确定,永远选择: │
│ │
│ format: video/h264-mp4 │
│ quality: 85 │
│ │
│ 这是质量、兼容性和文件大小的最佳平衡! │
│ │
└────────────────────────────────────────────────────┘
📚 更多详细信息
- VIDEO_FORMATS_GUIDE.md: 完整的YUV格式教程
- README.md: 所有功能的详细说明
- High444编码节点: 查看
comfyui-h264-high444/
最后提醒:
🎯 Mac/iOS用户: 必须使用 yuv420p
🎥 专业用户: 可以用 yuv444p,但发布前要转换
💡 不确定: 就用默认的 video/h264-mp4