Класс QMediaControl

Класс QMediaControl предоставляет базовый интерфейс для управления медиа-сервисами. Подробнее...

Заголовок:	#include <QMediaControl>
qmake:	QT += multimedia
Наследуется от:	QObject
Наследуется:	QAudioDecoderControl, QAudioEncoderSettingsControl, QAudioInputSelectorControl, QAudioOutputSelectorControl, QAudioRoleControl, QCameraCaptureBufferFormatControl, QCameraCaptureDestinationControl, QCameraControl, QCameraExposureControl, QCameraFeedbackControl, QCameraFlashControl, QCameraFocusControl, QCameraImageCaptureControl, QCameraImageProcessingControl, QCameraInfoControl, QCameraLocksControl, QCameraViewfinderSettingsControl, QCameraViewfinderSettingsControl2, QCameraZoomControl, QCustomAudioRoleControl, QImageEncoderControl, QMediaAudioProbeControl, QMediaAvailabilityControl, QMediaContainerControl, QMediaGaplessPlaybackControl, QMediaNetworkAccessControl, QMediaPlayerControl, QMediaRecorderControl, QMediaStreamsControl, QMediaVideoProbeControl, QMetaDataReaderControl, QMetaDataWriterControl, QRadioDataControl, QRadioTunerControl, QVideoDeviceSelectorControl, QVideoEncoderSettingsControl, QVideoRendererControl, QVideoWidgetControl, и QVideoWindowControl

Открытые функции

виртуальный ~QMediaControl()

31 открытая функция, унаследованная от QObject

Статические открытые члены

const QMetaObject staticMetaObject

9 статических открытых членов, унаследованных от QObject

Защищённые функции

QMediaControl(QObject *parent = nullptr)

9 защищённых функций, унаследованных от QObject

Защищённые переменные

QMediaControlPrivate * d_ptr

Макросы

Q_MEDIA_DECLARE_CONTROL(Class, IId)

Дополнительные унаследованные члены

1 свойство, унаследованное от QObject
1 открытый слот, унаследованный от QObject
2 сигнала, унаследованные от QObject

Подробное описание

Класс QMediaControl предоставляет базовый интерфейс для управления медиа-сервисами.

Управление медиа предоставляет интерфейс к отдельным функциям, предоставляемым медиа-сервисом. Большинство сервисов реализуют основной контроллер, который предоставляет основные функции сервиса, и ряд дополнительных контроллеров, которые предоставляют любые дополнительные функции.

Указатель на контроллер, реализованный медиа-сервисом, можно получить, используя член QMediaService::requestControl() класса QMediaService. Если сервис не реализует контроллер, он вернёт указатель null.

QMediaPlayerControl *control = qobject_cast<QMediaPlayerControl *>(
        mediaService->requestControl("org.qt-project.qt.mediaplayercontrol/5.0"));

В качестве альтернативы, если IId контроллера был объявлен с помощью Q_MEDIA_DECLARE_CONTROL, можно использовать шаблонную версию QMediaService::requestControl() для запроса сервиса без явного указания IId или использования qobject_cast().

QMediaPlayerControl *control = mediaService->requestControl<QMediaPlayerControl *>();

В основном, код приложения не будет взаимодействовать напрямую с контроллерами медиа-сервиса; вместо этого QMediaObject, который владеет сервисом, выступает в качестве посредника между одним или несколькими контроллерами и приложением.

См. также QMediaService и QMediaObject.

Документация по функциям-членам

`[protected]` QMediaControl::QMediaControl(QObject **parent* = nullptr)

Создаёт контроллер медиа с заданным parent.

`[virtual]` QMediaControl::~QMediaControl()

Удаляет контроллер медиа.

Документация по макросам

Q_MEDIA_DECLARE_CONTROL(Class, IId)

Макрос Q_MEDIA_DECLARE_CONTROL объявляет IId для Class, который наследуется от QMediaControl.

Объявление IId для QMediaControl позволяет запросить экземпляр этого контроллера из QMediaService::requestControl() без явного указания IId.

QMediaPlayerControl *control = mediaService->requestControl<QMediaPlayerControl *>();

См. также QMediaService::requestControl().

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.12/qmediacontrol.html