QVideoFrameInput Class
QVideoFrameInput 类用于向QMediaRecorder 或通过QMediaCaptureSession 输出视频提供自定义视频帧。更多
| 头文件： | #include <QVideoFrameInput> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Multimedia)target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
| qmake： | QT += multimedia |
| 自 | Qt 6.8 |
| 继承： | QObject |
公共函数
| QVideoFrameInput(QObject *parent = nullptr) | |
| QVideoFrameInput(const QVideoFrameFormat &format, QObject *parent = nullptr) | |
| virtual | ~QVideoFrameInput() override |
| QMediaCaptureSession * | captureSession() const |
| QVideoFrameFormat | format() const |
| bool | sendVideoFrame(const QVideoFrame &frame) |
信号
| void | readyToSendVideoFrame() |
详细说明
QVideoFrameInput 仅支持 FFmpeg 后端。
可通过将QVideoFrameInput 和QMediaRecorder 连接到QMediaCaptureSession 来录制自定义视频帧。要实现拉动模式，可调用sendVideoFrame() 来响应readyToSendVideoFrame() 信号。在下面的代码段中，这是通过将信号连接到自定义媒体生成器类中的槽来实现的。插槽函数会发出另一个带有新视频帧的信号，该信号与sendVideoFrame() 相连：
QMediaCaptureSession session; QMediaRecorder recorder; QVideoFrameInput videoInput; session.setRecorder(&recorder); session.setVideoFrameInput(&videoInput); MediaGenerator generator; // Custom class providing video frames connect(&videoInput, &QVideoFrameInput::readyToSendVideoFrame, &generator, &MediaGenerator::nextVideoFrame); connect(&generator, &MediaGenerator::videoFrameReady, &videoInput, &QVideoFrameInput::sendVideoFrame); recorder.record();
这是提供视频帧的 slot 函数的最小实现：
void MediaGenerator::nextVideoFrame() { QVideoFrame frame = nextFrame(); emit videoFrameReady(frame); }
更多详情请参见readyToSendVideoFrame() 和sendVideoFrame()。
另请参见 QMediaRecorder,QMediaCaptureSession, 和QVideoSink 。
成员函数文档
[explicit] QVideoFrameInput::QVideoFrameInput(QObject *parent = nullptr)
用parent 构建一个新的 QVideoFrameInput 对象。
[explicit] QVideoFrameInput::QVideoFrameInput(const QVideoFrameFormat &format, QObject *parent = nullptr)
使用视频帧format 和parent 构建一个新的 QVideoFrameInput 对象。
指定的format 将作为调用QMediaRecorder::record() 时初始化匹配视频编码器的提示。如果未指定格式或格式无效，视频编码器将在发送第一帧时初始化。在匹配的视频编码器初始化后发送其他像素格式和大小的视频帧可能会在录制过程中造成性能下降。
如果您事先知道要发送什么格式的帧，我们建议您指定格式。
[override virtual noexcept] QVideoFrameInput::~QVideoFrameInput()
销毁对象。
QMediaCaptureSession *QVideoFrameInput::captureSession() const
返回视频帧输入所连接的捕捉会话，如果视频帧输入未连接捕捉会话，则返回nullptr 。
使用QMediaCaptureSession::setVideoFrameInput() 将视频帧输入连接到会话。
QVideoFrameFormat QVideoFrameInput::format() const
返回创建视频帧输入时指定的视频帧格式。
[signal] void QVideoFrameInput::readyToSendVideoFrame()
表示可以向视频帧输入发送新帧。收到信号后，如果有帧要发送，则调用sendVideoFrame 一次或循环调用，直到返回false 。
另请参阅 sendVideoFrame() 。
bool QVideoFrameInput::sendVideoFrame(const QVideoFrame &frame)
将QVideoFrame 发送至QMediaRecorder 或通过QMediaCaptureSession 发送视频输出。
如果指定的frame 已成功发送至目的地，则返回true 。如果帧未被发送，则返回false 。如果实例未分配给QMediaCaptureSession 、会话没有视频输出或媒体记录器、媒体记录器未启动或其队列已满，则会出现这种情况。一旦目的地能够处理新帧，就会发送信号readyToSendVideoFrame 。
QMediaRecorder 会将空视频帧的发送视为输入流的结束。如果QMediaRecorder::autoStop 是true 且所有输入都报告了流的结束，则QMediaRecorder 会自动停止录制。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
