RaspiCam v2使用picamera输出到BytesIO流时捕获黑屏问题咨询

问题结论 #

picamera输出到文件和输出到BytesIO流的相机参数生效逻辑没有任何差异，全黑问题和输出目标无关。

故障原因 #

你当前的代码在修改完相机参数后立刻执行了捕获操作：
picamera的快门速度、ISO、AWB、曝光等参数修改后，相机传感器需要至少2~3帧的时间完成参数同步和曝光校准，立即捕获得到的是参数尚未生效的未曝光帧，自然显示为全黑。
你之前写入本地文件的测试脚本能正常出图，大概率是脚本中参数设置和捕获操作之间有隐含的延迟（比如启动预览、中间有其他逻辑执行、手动操作间隔），刚好满足了参数生效的等待要求。

修复方案 #

1. 增加参数生效等待时间 #

参数设置完成后，增加0.1~0.3秒的等待时间，确保参数同步完成：

import time
if self.camera is not None:
    buffer = BytesIO()
    self.camera.shutter_speed = shutter_speed_ms
    self.camera.iso = iso
    self.camera.resolution = resolution
    self.camera.brightness = brightness
    self.camera.contrast = contrast
    self.camera.sharpness = sharpness
    self.camera.saturation = saturation
    self.camera.awb_mode = awb_mode

    # 增加等待时间，确保参数生效
    time.sleep(0.2)
    self.camera.capture(buffer, "jpeg")
    buffer.seek(0)
else:
    raise RuntimeError("capture instance does not exist.")

2. 额外注意参数单位坑 #

picamera的shutter_speed参数单位为微秒，如果你的变量shutter_speed_ms存储的是毫秒值，需要先乘以1000再赋值，否则快门速度过短也会导致全黑：

self.camera.shutter_speed = shutter_speed_ms * 1000

3. 优化建议 #

如果你的相机参数是固定的，建议在相机实例初始化阶段就完成所有参数设置，不要每次捕获前重复修改参数，既可以避免等待开销，也能降低出图异常概率。

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