如何用Python从Webcam/IP Camera流中持续获取元数据？

需从本地Webcam或IP Camera的直播流中持续获取元数据，要求每秒（或每帧）打印一次流的元数据，期望获取的元数据包含相机型号、曝光时间、ISO、分辨率等硬件/流参数（示例参考给定的Exif格式内容）。但尝试OpenCV、PyGame、PIL ExifTags均失败，原因是解码后的单帧仅包含像素数据，不含元数据。

解码后的视频帧仅保留像素信息，设备硬件参数、流传输信息等元数据，通常存储在流传输协议的容器层或摄像头硬件API接口中，而非解码后的帧本身，因此直接从帧中提取元数据不可行。

方案1：通过摄像头硬件API直接获取参数 #

本地USB摄像头（Linux环境） #

利用V4L2（Video for Linux 2）接口读取摄像头原生硬件参数，这类参数与期望的元数据高度匹配。可使用Python的pyv4l2库实现：

import pyv4l2.control as ctrl
import time

# 打开摄像头设备（通常为/dev/video0）
cam = ctrl.V4L2Control("/dev/video0")

# 定义需要获取的参数列表（根据摄像头支持情况调整）
target_params = [
    ctrl.BRIGHTNESS,
    ctrl.CONTRAST,
    ctrl.SATURATION,
    ctrl.EXPOSURE_ABSOLUTE,
    ctrl.WHITE_BALANCE_TEMPERATURE,
    ctrl.ISO_SENSITIVITY
]

# 每秒循环获取并打印参数
while True:
    print("=== 摄像头实时元数据 ===")
    for param in target_params:
        try:
            value = cam.get_control_value(param)
            param_name = ctrl.controls[param].name
            print(f"{param_name}: {value}")
        except Exception:
            print(f"{ctrl.controls[param].name}: 设备不支持该参数")
    print("------------------------")
    time.sleep(1)

本地USB摄像头（Windows环境） #

可通过opencv-python的cv2.CAP_PROP_*属性获取部分常用参数：

import cv2
import time

cap = cv2.VideoCapture(0)

while cap.isOpened():
    print("=== 摄像头实时元数据 ===")
    # 获取分辨率
    width = cap.get(cv2.CAP_PROP_FRAME_WIDTH)
    height = cap.get(cv2.CAP_PROP_FRAME_HEIGHT)
    print(f"分辨率: {int(width)}x{int(height)}")
    # 获取帧率
    fps = cap.get(cv2.CAP_PROP_FPS)
    print(f"帧率: {fps:.2f}")
    # 获取曝光时间
    exposure = cap.get(cv2.CAP_PROP_EXPOSURE)
    print(f"曝光时间: {exposure}")
    # 获取ISO
    iso = cap.get(cv2.CAP_PROP_ISO_SPEED)
    print(f"ISO: {iso}")
    print("------------------------")
    time.sleep(1)
    # 必须读取帧才能更新参数状态
    ret, _ = cap.read()
    if not ret:
        break

cap.release()

方案2：IP摄像头（RTSP/ONVIF协议） #

方法A：使用FFprobe提取流元数据 #

FFprobe可解析RTSP/RTMP流的容器信息、编码参数，部分摄像头会在流中嵌入设备元数据。

命令行示例：

ffprobe -v error -show_format -show_streams rtsp://用户名:密码@摄像头IP:端口/流路径

Python封装实现（依赖ffmpeg-python库）：

import ffmpeg
import time

stream_url = "rtsp://用户名:密码@摄像头IP:端口/流路径"

while True:
    print("=== IP摄像头流元数据 ===")
    try:
        probe_result = ffmpeg.probe(stream_url)
        # 打印流格式信息
        format_info = probe_result['format']
        print(f"流格式: {format_info['format_name']}")
        print(f"比特率: {format_info['bit_rate']} bps")
        # 打印视频流核心信息
        video_stream = next(s for s in probe_result['streams'] if s['codec_type'] == 'video')
        print(f"编码格式: {video_stream['codec_name']}")
        print(f"分辨率: {video_stream['width']}x{video_stream['height']}")
        print(f"帧率: {eval(video_stream['r_frame_rate']):.2f}")
    except Exception as e:
        print(f"获取元数据失败: {str(e)}")
    print("------------------------")
    time.sleep(1)

方法B：通过ONVIF协议获取实时设备参数 #

ONVIF是IP摄像头的标准协议，可直接获取硬件参数、实时状态（如曝光、聚焦、白平衡等）。使用onvif-zeep库实现：

from onvif import ONVIFCamera
import time

# 摄像头连接信息
camera_ip = "摄像头IP"
port = 80
username = "用户名"
password = "密码"

# 初始化摄像头连接
mycam = ONVIFCamera(camera_ip, port, username, password)
media_service = mycam.create_media_service()
ptz_service = mycam.create_ptz_service()

# 获取默认视频配置
profiles = media_service.GetProfiles()
default_profile = profiles[0]

while True:
    print("=== IP摄像头实时元数据 ===")
    # 获取视频流地址
    stream_uri = media_service.GetStreamUri({
        'StreamSetup': {'Stream': 'RTP-Unicast', 'Transport': {'Protocol': 'RTSP'}},
        'ProfileToken': default_profile.token
    })
    print(f"流地址: {stream_uri.Uri}")
    # 获取PTZ状态（仅支持PTZ的设备有效）
    try:
        ptz_status = ptz_service.GetStatus({'ProfileToken': default_profile.token})
        print(f"PTZ状态: 变焦={ptz_status.Position.Zoom}, 聚焦={ptz_status.Position.Focus}")
    except:
        print("该摄像头不支持PTZ功能")
    # 获取视频编码配置
    media_config = media_service.GetConfiguration(default_profile.MediaProfileToken)
    print(f"分辨率: {media_config.VideoEncoderConfiguration.Resolution.Width}x{media_config.VideoEncoderConfiguration.Resolution.Height}")
    print(f"帧率限制: {media_config.VideoEncoderConfiguration.RateControl.FrameRateLimit}")
    print("------------------------")
    time.sleep(1)

方案3：结合ExifTool生成带元数据的帧（补充方案） #

如果需要将获取到的参数嵌入到帧的Exif中再输出，可先从API获取参数，将帧保存为JPEG并写入Exif，再用ExifTool读取：

import cv2
import exiftool
import time
import tempfile

cap = cv2.VideoCapture(0)
et = exiftool.ExifToolHelper()

while cap.isOpened():
    ret, frame = cap.read()
    if not ret:
        break
    # 从摄像头获取参数
    exposure = cap.get(cv2.CAP_PROP_EXPOSURE)
    iso = cap.get(cv2.CAP_PROP_ISO_SPEED)
    # 临时保存帧
    with tempfile.NamedTemporaryFile(suffix='.jpg', delete=False) as tmp_file:
        cv2.imwrite(tmp_file.name, frame)
    # 写入自定义Exif元数据
    et.set_tags(tmp_file.name, {
        'Exif:ExposureTime': exposure/1000000 if exposure > 0 else 1/30,
        'Exif:ISO': iso,
        'Exif:Make': 'Webcam',
        'Exif:Model': 'USB Camera'
    })
    # 读取并打印元数据
    metadata = et.get_metadata(tmp_file.name)[0]
    print("=== 带Exif的帧元数据 ===")
    for key, value in metadata.items():
        if key.startswith('Exif:') or key.startswith('File:'):
            print(f"{key.split(':')[-1]}: {value}")
    print("------------------------")
    time.sleep(1)

cap.release()
et.close()

• 不同摄像头支持的参数范围存在差异，需根据实际设备调整参数列表。
• IP摄像头需确保网络可达，并开启了对应协议（RTSP/ONVIF）。
• 部分小众USB摄像头可能需要安装额外驱动才能获取全部参数。

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