qplatformvideodevices_p.h

Enable keyboard shortcuts

// Copyright (C) 2022 The Qt Company Ltd.

// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only

#ifndef QPLATFORMVIDEODEVICES_H

#define QPLATFORMVIDEODEVICES_H

//

//  W A R N I N G

//  -------------

//

// This file is not part of the Qt API.  It exists purely as an

// implementation detail.  This header file may change from version to

// version without notice, or even be removed.

//

// We mean it.

//

#include <QtMultimedia/private/qcachedvalue_p.h>

#include <QtMultimedia/private/qtmultimediaglobal_p.h>

#include <QtMultimedia/qcameradevice.h>

#include <QtMultimedia/qmediarecorder.h>

#include <QtCore/qobject.h>

QT_BEGIN_NAMESPACE

class QCameraDevice;

class QPlatformMediaIntegration;

// Implementations should use constructor to setup device-changed notification

// listeners. Actual device enumeration should happen in findVideoInputs().

// This allows device enumeration be deferred until user starts using QMediaDevices

// functionality.

class Q_MULTIMEDIA_EXPORT QPlatformVideoDevices : public QObject

    Q_OBJECT

    QT_DEFINE_TAG_STRUCT(PrivateTag);

public:

    QPlatformVideoDevices(QPlatformMediaIntegration *integration);

    ~QPlatformVideoDevices() override;

    QList<QCameraDevice> videoInputs() const;

protected:

    // Implementation must be thread safe. Can be called from any thread as a result of

    // QMediaDevices::videoInputs().

    virtual QList<QCameraDevice> findVideoInputs() const = 0;

    // Thread-safe.

    // Called by the platform-implementation to signal that findVideoInputs() will return a new list

    // of devices.

    void onVideoInputsChanged();

    // Thread-safe. Called by platform-implementation.

    void updateVideoInputsCache();

Q_SIGNALS:

    void videoInputsChanged(PrivateTag);

protected:

    QPlatformMediaIntegration *m_integration = nullptr;

    mutable QCachedValue<QList<QCameraDevice>> m_videoInputs;

};

QT_END_NAMESPACE

#endif