Класс 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)
Сигнализирует, что длительность записанного медиа 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)
Сигнализирует, что состояние state средства записи медиа изменилось.
[signal] void QMediaRecorderControl::statusChanged(QMediaRecorder::Status 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)
Устанавливает местоположение вывода location и возвращает, успешно ли выполнена эта операция. Если файл в указанном месте уже существует, он должен быть перезаписан.
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.15/qmediarecordercontrol.html