如何使用测试版Picamera2 Python库的循环输出功能？

问题背景 #

要在树莓派Bullseye系统上实现：持续将视频录制到循环缓冲区，当收到终端输入的触发信号时，保存缓冲区里的历史帧+后续几秒的内容。原Picamera库无法在Bullseye运行，改用官方测试版的Picamera2后，遇到以下问题：

• 按文档示例修改后，若picam2.start_recording与output.start的间隔超过缓冲区大小（默认150帧），生成的H264文件无法被VLC、MP4Box识别，文件虽有MB级大小但无法播放。
• 推测原因是循环缓冲区覆盖旧帧时，丢失了解码必需的关键帧（I帧），导致播放器无法解析视频流。

问题根源 #

H264编码的视频必须依赖关键帧来启动解码，循环缓冲区满了之后会覆盖最早的帧，如果被覆盖的帧包含最近的关键帧，后续保存的文件就没有了解码的起始点，自然无法被播放器识别。

解决方案 #

通过配置编码器的关键帧生成频率，确保循环缓冲区始终保留至少一个关键帧；同时利用Picamera2的CircularOutput特性，触发保存时自动从最近的关键帧开始导出内容。

修正后的代码 #

from picamera2.encoders import H264Encoder
from picamera2.outputs import CircularOutput
from picamera2 import Picamera2
import time

# 初始化相机并配置视频参数
picam2 = Picamera2()
# 可根据需求调整分辨率、帧率，这里用1280x720@30fps示例
video_config = picam2.create_video_configuration(main={"size": (1280, 720)})
picam2.configure(video_config)

# 配置H264编码器，设置关键帧间隔（每30帧生成一个关键帧，对应30fps下每秒一个）
# bitrate可根据需求调整，数值越大画质越好
encoder = H264Encoder(bitrate=1000000, intra_period=30)
# 缓冲区大小设为150帧，对应30fps下5秒的内容，确保能容纳多个关键帧周期
output = CircularOutput(buffersize=150)

# 启动循环录制，视频流持续写入缓冲区
picam2.start_recording(encoder, output)
print("等待触发输入，按回车开始保存视频...")
input()  # 等待用户输入触发保存操作

# 设置输出文件路径，CircularOutput会自动从最近的关键帧开始导出缓冲区内容
output.fileoutput = "saved_video.h264"
output.start()

# 继续录制5秒的实时内容，和缓冲区历史帧合并保存
print("正在保存视频，5秒后完成...")
time.sleep(5)

# 停止保存并结束录制
output.stop()
picam2.stop_recording()
print("视频已保存为 saved_video.h264")

# 可选：将H264封装为MP4格式（需提前安装MP4Box）
# import subprocess
# subprocess.run(["MP4Box", "-add", "saved_video.h264", "saved_video.mp4"])

关键配置说明 #

• 关键帧间隔intra_period：设置为帧率数值（比如30fps就设为30），确保每秒生成一个关键帧，保证缓冲区里始终有可用于解码的起始点。
• 缓冲区大小buffersize：建议设置为关键帧间隔的3-5倍，避免触发保存时，最近的关键帧已经被覆盖。
• 文件封装：生成的H264裸流部分播放器可能不支持，可使用MP4Box转为MP4格式，命令为MP4Box -add saved_video.h264 saved_video.mp4。

内容的提问来源于stack exchange，提问作者CricGuru