### 如何使用 `ffmpeg-python` 处理不同输入源 #### 输入文件路径 当处理本地存储中的媒体文件时，可以直接指定文件路径作为输入。以下是读取本地 MP4 文件并提取其基本信息的示例： ```python import ffmpeg # 定义输入视频文件名 input_file = "example.mp4" # 获取视频流信息 probe = ffmpeg.probe(input_file) video_stream = next((stream for stream in probe['streams'] if stream['codec_type'] == 'video'), None) if video_stream: width = int(video_stream['width']) height = int(video_stream['height']) print(f"Video Resolution: {width}x{height}") else: print("No video stream found.") ``` 此代码片段展示了如何解析视频文件的信息[^3]。 --- #### URL 流输入 对于网络资源（如 RTSP 或 HTTP 流），可以通过提供 URL 来加载远程媒体内容。下面是一个从 URL 加载视频并将帧保存为图像的例子： ```python import ffmpeg url = "http://techslides.com/demos/sample-videos/small.mp4" output_image_pattern = "frame_%03d.png" ( ffmpeg.input(url, rtsp_transport='tcp') # 如果是 RTSP，则需设置传输协议 .filter('fps', fps=1) # 设置每秒抽取一帧 .output(output_image_pattern, vframes=10) # 输出前 10 帧到图片序列 .run() ) ``` 这里演示了如何通过 URL 进行实时流捕获，并将其转换成一系列静态图像[^1]。 --- #### 音频设备输入 某些情况下可能需要采集来自麦克风或其他音频硬件的数据。以下是如何配置基于 ALSA 设备名称来录制声音的方法之一： ```python import ffmpeg audio_device_name = 'alsa_input.pci-0000_00_1b.0.analog-stereo' process = ( ffmpeg .input(audio_device_name, format='alsa') .output('output.wav', acodec='pcm_s16le', ar='44100') .overwrite_output() # 自动覆盖已有文件 .run_async(pipe_stdout=True) # 启用异步模式以便后续操作 ) ``` 这段脚本说明了怎样利用特定驱动程序接口连接物理声卡完成录音任务[^2]。 --- #### 屏幕共享或桌面捕捉 在跨平台开发过程中，有时还需要实现屏幕录像功能。借助 X11grab 可轻松达成目标如下所示： ```python import ffmpeg screen_width = 1920 screen_height = 1080 framerate = 30 output_filename = 'desktop_capture.mkv' command = [ '-f', 'x11grab', '-r', str(framerate), '-s', f'{screen_width}x{screen_height}', '-i', ':0.0+0,0', # 替换为实际显示编号和偏移量 ] process = ( ffmpeg .input(':0.0+0,0', format='x11grab', r=str(framerate), s=f'{screen_width}x{screen_height}') .output(output_filename, codec='libx264', preset='ultrafast') .overwrite_output() .run_async(pipe_stdin=False, pipe_stderr=False, quiet=True) ) ``` 该部分解释了针对 Linux 平台上的图形界面进行录屏的技术细节[^1]。 --- #### 总结 以上分别介绍了四种常见的输入方式及其对应的应用场景：本地磁盘文件、互联网直播链接、外部音效装置以及计算机内部画面输出端口。这些方法均依赖于强大的 FFmpeg 工具集并通过 Python 封装简化交互流程[^2]。