qplatformvideodevices_p.h

Go to the documentation of this file.

// 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