Qt 实现的万能采集库( 屏幕/相机/扬声器/麦克风采集)

news2024/12/23 13:34:12

【写在前面】

之前应公司需要，给公司写过一整套直播的库( 推拉流，编解码)，类似于 libobs。

结果后来因为没有相关项目，便停止开发&维护了。

不过里面很多有用的组件，然后也挺好用的，遂开源出来一部分。

因此，本篇就简单讲一下用法。

【正文开始】

关于 AnyCapture：

AnyCapture 是一个基于 Qt 的回调式采集库。

它简化了各类采集实现(包装)，提供相当方便的接口，旨在能够轻松集成以实现采集相关工作。

采集目标：

轻松采集屏幕, ScreenCapture 提供多种采集模式(GDI/DX9/DXGI)，AnyCapture 默认将自动选择。

轻松采集相机, CameraCapture 使用 Qt Multimedia 完成采集工作。

轻松采集音频输入&输出, AudioCapture 使用 WASAPI(Windows)。

最多支持采集1个屏幕&1个相机&1个音频输入&1个音频输出, 然而可简单实例多个(无需担心资源占用)实现多路采集。

如何构建：

1、构建 libyuvconvertor, 为 libyuv 浅包装, 构建文件 /libyuvconvertor/libyuvconvertor.pro。

2、构建 anycapture, 构建文件 anycapture.pro。

如何使用：

1、使用 availableCameras() / availableScreens() / availableAudioInputs() / availableAudioOutputs() 获取有效设备。

2、使用 startCapture*() 开启采集, 采集到的资源将通过回调传递。

3、使用 stopCapture*() 停止采集。

AnyCapture 接口说明：

    /**
     * @brief 获取有效的相机列表
     * @return QList<CameraDevice>
     */
    static QList<any_capture::CameraDevice> availableCameras();

    /**
     * @brief 开始采集相机
     * @param info 要采集的相机信息{使用 @link availableCameras() 获取}
     * @param settings 相机设置
     * @param format 输出图像格式
     * @param callback 采集回调{为空则可使用 @link grabCameraFrame() 抓取}
     * @param master 采集回调指针
     * @return bool{true:成功; false:失败}
     */
    bool startCaptureCamera(const QCameraInfo &info, const QCameraViewfinderSettings &settings, any_capture::OutputVideoFormat format
                            , any_capture::capture_callback callback, void *master);

    /**
     * @brief 抓取一帧相机帧
     * @warning 需要先使用{@link startCaptureCamera()}
     * @return QVideoFrame
     */
    QVideoFrame grabCameraFrame() const;

    /**
     * @brief 停止采集相机
     */
    void stopCaptureCamera();

    /**
     * @brief 获取有效的屏幕列表
     * @return QList<QScreen *>
     */
    static QList<QScreen *> availableScreens();

    /**
     * @brief 开始采集屏幕
     * @param captureScreen 要采集的屏幕{使用 @link availableScreens() 获取}
     * @param captureFrameRate 捕获帧率
     * @param captureCursor 是否捕获光标
     * @param format 输出图像格式
     * @param callback 采集回调{为空则不会采集,但可使用 @link grabScreen() 抓取}
     * @param master 采集回调指针
     * @return bool{true:成功; false:失败}
     */
    bool startCaptureScreen(QScreen *captureScreen, int captureFrameRate, bool captureCursor, any_capture::OutputVideoFormat format
                            , any_capture::capture_callback callback, void *master);

    /**
     * @brief 抓取一帧屏幕
     * @warning 需要先使用{@link startCaptureScreen()}
     * @return QImage
     */
    QImage grabScreen() const;

    /**
     * @brief 停止采集屏幕
     */
    void stopCaptureScreen();

    /**
     * @brief 获取有效的音频输入
     * @return QList<any_capture::AudioDevice>
     */
    static QList<any_capture::AudioDevice> availableAudioInputs();

    /**
     * @brief 开始采集音频输入
     * @param input 要采集的音频输入
     * @param callback 采集回调
     * @param master 采集回调指针
     * @return bool{true:成功; false:失败}
     */
    bool startCaptureAudioInput(const any_capture::AudioDevice &input, any_capture::capture_callback callback, void *master);

    /**
     * @brief 停止采集音频输入
     */
    void stopCaptureAudioInput();

    /**
     * @brief 获取有效的音频输出
     * @return QList<any_capture::AudioDevice>
     */
    static QList<any_capture::AudioDevice> availableAudioOutputs();

    /**
     * @brief 开始采集音频输出
     * @param output 要采集的音频输出
     * @param callback 采集回调
     * @param master 采集回调指针
     * @return bool{true:成功; false:失败}
     */
    bool startCaptureAudioOutput(const any_capture::AudioDevice &output, any_capture::capture_callback callback, void *master);

    /**
     * @brief 停止采集音频输出
     */
    void stopCaptureAudioOutput();

【结语】

注意：AudioCapture / ScreenCapture / CameraCapture 都可以单独使用。

项目链接(多多star呀..⭐_⭐)：

CSDN 的：https://download.csdn.net/download/u011283226/89067080?spm=1001.2014.3001.5501https://download.csdn.net/download/u011283226/89067080?spm=1001.2014.3001.5501 Github 的：https://github.com/mengps/AnyCapturehttps://github.com/mengps/AnyCapture