Класс QMediaRecorderControl

Класс QMediaRecorderControl предоставляет доступ к функциональности записи QMediaService. Подробнее...

• Список всех членов, включая унаследованные

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

Открытые слоты

Сигналы

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

Макросы

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

В прикладном коде обычно используется класс 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)

Сигнализирует о возникновении ошибки. 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)

Устанавливает выходное местоположение и возвращает, успешно ли выполнена эта операция. Если файл в выходном месте уже существует, он должен быть перезаписан.

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().