Класс QMediaRecorderControl
Класс QMediaRecorderControl предоставляет доступ к функционалу записи QMediaService. Подробнее...
| Заголовок: | #include <QMediaRecorderControl> |
| qmake: | QT += multimedia |
| Наследуется от: | QMediaControl |
Открытые функции
| virtual | ~QMediaRecorderControl() |
| virtual void | applySettings() = 0 |
| virtual qint64 | duration() const = 0 |
| virtual bool | isMuted() const = 0 |
| virtual QUrl | outputLocation() const = 0 |
| virtual bool | setOutputLocation(const QUrl &location) = 0 |
| virtual QMediaRecorder::State | state() const = 0 |
| virtual QMediaRecorder::Status | status() const = 0 |
| virtual qreal | volume() const = 0 |
Открытые слоты
| virtual void | setMuted(bool muted) = 0 |
| virtual void | setState(QMediaRecorder::State state) = 0 |
| virtual void | setVolume(qreal volume) = 0 |
Сигналы
| void | actualLocationChanged(const QUrl &location) |
| void | durationChanged(qint64 duration) |
| void | error(int error, const QString &errorString) |
| void | mutedChanged(bool muted) |
| void | stateChanged(QMediaRecorder::State state) |
| void | statusChanged(QMediaRecorder::Status status) |
| void | volumeChanged(qreal gain) |
Защищенные функции
| QMediaRecorderControl(QObject *parent = nullptr) |
Макросы
| QMediaRecorderControl_iid |
Подробное описание
В прикладном коде обычно используется класс QMediaRecorder - этот класс в основном используется при реализации нового QMediaService или если есть доступ к конкретной низкоуровневой функциональности, которая не присутствует в QMediaRecorder.
Если QMediaService может записывать медиа, он будет реализовывать QMediaRecorderControl. Этот контроль обеспечивает возможность установить место расположения вывода и выполнять запись, паузу и остановку записи с помощью метода setState(). Он также предоставляет обратную связь о продолжительности записи.
Имя интерфейса QMediaRecorderControl - org.qt-project.qt.mediarecordercontrol/5.0 , как определено в QMediaRecorderControl_iid.
См. также QMediaService::requestControl() и QMediaRecorder.
Документация по функциям-членам
[protected] QMediaRecorderControl::QMediaRecorderControl(QObject *parent = nullptr)
Конструирует элемент управления записью медиа с указанным parent.
[signal] void QMediaRecorderControl::actualLocationChanged(const QUrl &location)
Сигнализирует о том, что фактическое местоположение медиа location изменилось. Этот сигнал должен быть выпущен в начале записи.
[signal] void QMediaRecorderControl::durationChanged(qint64 duration)
Сигнализирует о том, что продолжительность записываемого медиа изменилась.
Этот сигнал генерируется только при прерывистом изменении продолжительности, например, при сбросе до 0.
[signal] void QMediaRecorderControl::error(int error, const QString &errorString)
Сигнализирует о возникновении error. errorString описывает ошибку.
[signal] void QMediaRecorderControl::mutedChanged(bool muted)
Сигнализирует о том, что состояние muted устройства записи медиа изменилось.
[pure virtual slot] void QMediaRecorderControl::setMuted(bool muted)
Устанавливает состояние muted устройства записи медиа.
См. также isMuted().
[pure virtual slot] void QMediaRecorderControl::setState(QMediaRecorder::State state)
Устанавливает состояние устройства записи медиа state.
См. также state().
[pure virtual slot] void QMediaRecorderControl::setVolume(qreal volume)
Устанавливает громкость аудио volume устройства управления записью медиа.
Громкость масштабируется линейно, варьируясь от 0 (тишина) до 100 (полная громкость).
См. также volume().
[signal] void QMediaRecorderControl::stateChanged(QMediaRecorder::State state)
Сигнализирует о том, что состояние устройства записи медиа изменилось.
[signal] void QMediaRecorderControl::statusChanged(QMediaRecorder::Status status)
Сигнализирует о том, что статус устройства записи медиа изменился.
[signal] void QMediaRecorderControl::volumeChanged(qreal gain)
Сигнализирует о том, что значение усиления аудио gain изменилось.
[virtual] QMediaRecorderControl::~QMediaRecorderControl()
Уничтожает элемент управления записью медиа.
[pure virtual] void QMediaRecorderControl::applySettings()
Записывает настройки кодера и выполняет предварительную инициализацию, чтобы уменьшить задержки при запуске записи.
[pure virtual] qint64 QMediaRecorderControl::duration() const
Возвращает текущую продолжительность в миллисекундах.
[pure virtual] bool QMediaRecorderControl::isMuted() const
Возвращает true, если устройство записи выключено, и false, если нет.
[pure virtual] QUrl QMediaRecorderControl::outputLocation() const
Возвращает текущее местоположение вывода.
См. также setOutputLocation().
[pure virtual] bool QMediaRecorderControl::setOutputLocation(const QUrl &location)
Устанавливает выходной пункт назначения и возвращает, успешно ли выполнено это действие. Если файл по указанному выходному пункту назначения уже существует, он должен быть перезаписан.
Пункт назначения может быть относительным или пустым; в этом случае служба должна использовать специфичный для системы метод определения места и имени файла.
После начала записи бэкэнд должен сообщить фактическое расположение файла с помощью сигнала actualLocationChanged().
См. также outputLocation().
[pure virtual] QMediaRecorder::State QMediaRecorderControl::state() const
Возвращает текущее состояние записи.
См. также setState().
[pure virtual] QMediaRecorder::Status QMediaRecorderControl::status() const
Возвращает текущий статус записи.
[pure virtual] qreal QMediaRecorderControl::volume() const
Возвращает громкость звука для управления медиазаписью.
См. также setVolume().
Документация макросов
QMediaRecorderControl_iid
org.qt-project.qt.mediarecordercontrol/5.0
Определяет имя интерфейса класса QMediaRecorderControl.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/qmediarecordercontrol.html