Python+FFmpeg实现视频自动化处理的完整指南

from typing import Tuple, List

def _translate_crf_to_hw_quality(crf_value: str, encoder_family: str) -> int:
    """
    将 CRF (0-51) 转换为不同硬件的质量参数。
    """
    try:
        crf = float(crf_value)
        # NVENC/QSV/VAAPI: 范围 ~1-51，越小质量越高，逻辑与 CRF 类似
        if encoder_family in ['nvenc', 'qsv', 'vaapi']:
            return int(max(1, min(crf, 51)))
        
        # VideoToolbox (Mac): 范围 1-100，越大质量越高。需要反向映射。
        # 经验公式: Quality = 100 - (CRF * 1.8)
        if encoder_family == 'videotoolbox':
            quality = 100 - (crf * 1.8)
            return int(max(1, min(quality, 100)))
            
    except (ValueError, TypeError):
        return None
    return None

def _build_hw_command(args: list, hw_codec: str) -> Tuple[List[str], List[str]]:
    """
    构建硬件编码参数。
    返回: (新参数列表, 硬件解码参数列表)
    """
    if not hw_codec or 'libx' in hw_codec or hw_codec == 'copy':
        return list(args), []

    encoder_family = hw_codec.split('_')[-1].lower() # 提取 nvenc, qsv 等
    
    # 1. Preset 映射表
    PRESET_MAP = {
        'nvenc': {'fast': 'p2', 'medium': 'p4', 'slow': 'p7'}, # p1-p7
        'qsv': {'fast': 'faster', 'medium': 'medium', 'slow': 'slower'},
        'amf': {'fast': 'speed', 'medium': 'balanced', 'slow': 'quality'},
        'videotoolbox': None # Apple 硬编不支持 -preset
    }
    
    # 2. 质量参数名映射表
    QUALITY_PARAM_MAP = {
        'nvenc': '-cq',
        'qsv': '-global_quality',
        'videotoolbox': '-q:v',
    }

    new_args = []
    # ... (省略遍历 args 替换 -c:v, -preset, -crf 的循环逻辑
    # 核心是将 args 中的 -crf 23 替换为 [hw_param, mapped_value]
    
    return new_args, []

# 目标：慢放视频，且保证时长绝对精确，防止丢帧
speed_factor = 2.0 # 慢放2倍 (PTS * 2)
input_duration = 5.0 # 原始切片时长
target_duration = input_duration * speed_factor # 目标时长 10.0秒

cmd = [
    '-i', 'input.mp4',
    '-an', # 去除音频，防止变速后音画不同步干扰
    '-c:v', 'libx264',
    '-g', '1', # All-Intra，拼接神器
    
    # --- 滤镜链 ---
    # 1. tpad: 先在尾部复制最后一帧 0.1秒  作为安全缓冲 
    # 2. setpts: 将 (原视频 + padding) 整体拉伸
    # 结果：缓冲也被拉伸了，保证了最后有足够的数据供截取
    '-vf', f'tpad=stop_mode=clone:stop_duration=0.1,setpts={speed_factor}*PTS',
    
    # --- 关键设置 ---
    '-fps_mode', 'vfr', # 允许可变帧率，防止强行对齐导致卡顿
    
    # --- 输出截断 ---
    # 强制只输出目标时长，切掉多余的 padding
    '-t', f'{target_duration:.6f}', 
    'output_clip.mp4'
]

import os
from pathlib import Path

def merge_media(novoice_mp4, audio_file, subtitle_file, sub_type, output_path):
    """
    sub_type: 1/3 为硬字幕(烧录), 2/4 为软字幕(流)
    """
    # 1. 路径处理 (Windows 滤镜兼容性关键!)
    # subtitles='C\:/path/to/file.srt'
    abs_sub = Path(subtitle_file).resolve().as_posix()
    vf_sub_path = abs_sub.replace(':', '\\:') 

    # 2. 基础命令
    cmd = ["ffmpeg", "-y", "-i", novoice_mp4]
    
    has_audio = False
    if audio_file and os.path.exists(audio_file):
        cmd.extend(["-i", audio_file])
        has_audio = True
        
    # 如果是软字幕，需要作为输入流
    if sub_type in [2, 4]:
        cmd.extend(["-i", subtitle_file])

    # 3. 场景分支构建
    # 场景 A: 硬字幕 (必须重编码)
    if sub_type in [1, 3]:
        # Map: 视频(0) + 音频(1,如有)
        cmd.extend(['-map', '0:v'])
        if has_audio:
            cmd.extend(['-map', '1:a'])
            
        cmd.extend([
            '-c:v', 'libx264', # 硬字幕无法 Copy
            '-vf', f"subtitles='{vf_sub_path}'", # 注意单引号包裹
            '-c:a', 'copy' if has_audio else 'none'
        ])

    # 场景 B: 软字幕 (MP4封装推荐 mov_text)
    elif sub_type in [2, 4]:
        # Map: 视频(0) + 音频(1,如有) + 字幕(1或2)
        cmd.extend(['-map', '0:v'])
        if has_audio:
            cmd.extend(['-map', '1:a', '-map', '2:s'])
        else:
            cmd.extend(['-map', '1:s']) # 此时字幕是第2个输入(索引1)

        cmd.extend([
            '-c:v', 'copy', # 软字幕视频流可以直接 Copy (速度快)
            '-c:a', 'copy' if has_audio else 'none',
            '-c:s', 'mov_text'
        ])

    # 4. 通用参数与执行
    cmd.extend(['-movflags', '+faststart'])
    
    # 只有在重编码(非copy)时才加 CRF/Preset
    if '-c:v' in cmd and 'copy' not in cmd[cmd.index('-c:v')+1]:
         cmd.extend(['-crf', '23', '-preset', 'fast', '-fps_mode', 'vfr'])

    cmd.append(output_path)
    
    # 执行 (subprocess)
    # tools.runffmpeg(cmd)