QMediaRecorder Class

QMediaCaptureSession session;
QAudioInput audioInput;
session.setAudioInput(&input);
QMediaRecorder recorder;
session.setRecorder(&recorder);
recorder.setQuality(QMediaRecorder::HighQuality);
recorder.setOutputLocation(QUrl::fromLocalFile("test.mp3"));
recorder.record();

Member Function Documentation

QMediaRecorder::QMediaRecorder(QObject *parent = nullptr)

Construit un enregistreur de médias. L'enregistreur de médias est un enfant de parent.

[override virtual noexcept] QMediaRecorder::~QMediaRecorder()

Détruit un objet enregistreur de médias.

[signal] void QMediaRecorder::actualLocationChanged(const QUrl &location)

Signale que le site location du support enregistré a changé. Ce signal est généralement émis au début de l'enregistrement.

void QMediaRecorder::addMetaData(const QMediaMetaData &metaData)

Ajoute metaData au support enregistré.

int QMediaRecorder::audioBitRate() const

Renvoie le débit du flux audio compressé en bits par seconde.

Voir également setAudioBitRate().

[signal] void QMediaRecorder::audioBitRateChanged()

Signaux lorsque le débit binaire de l'enregistrement audio change.

int QMediaRecorder::audioChannelCount() const

Renvoie le nombre de canaux audio.

Voir également setAudioChannelCount().

[signal] void QMediaRecorder::audioChannelCountChanged()

Signale la modification du nombre de canaux audio d'enregistrement.

int QMediaRecorder::audioSampleRate() const

Renvoie la fréquence d'échantillonnage audio en Hz.

Voir également setAudioSampleRate().

[signal] void QMediaRecorder::audioSampleRateChanged()

Signale le changement de la fréquence d'échantillonnage de l'enregistrement audio.

QMediaCaptureSession *QMediaRecorder::captureSession() const

Renvoie la session de capture de médias.

[signal] void QMediaRecorder::durationChanged(qint64 duration)

Signale que le site duration du support enregistré a changé.

QMediaRecorder::EncodingMode QMediaRecorder::encodingMode() const

Renvoie le mode d'encodage.

Voir aussi setEncodingMode() et EncodingMode.

[signal] void QMediaRecorder::encodingModeChanged()

Signale le changement de mode d'encodage.

[signal] void QMediaRecorder::errorOccurred(QMediaRecorder::Error error, const QString &errorString)

Signale qu'une erreur s'est produite à l'adresse error, errorString contenant une description de l'erreur.

bool QMediaRecorder::isAvailable() const

Renvoie true si le service de l'enregistreur de médias est prêt à être utilisé.

[signal] void QMediaRecorder::metaDataChanged()

Signale que les méta-données d'un objet média ont changé.

Si plusieurs éléments de métadonnées sont modifiés, metaDataChanged() n'est émis qu'une seule fois.

QIODevice *QMediaRecorder::outputDevice() const

Renvoie le périphérique de sortie IO pour le contenu multimédia.

Voir aussi setOutputDevice().

[slot] void QMediaRecorder::pause()

Interrompt l'enregistrement.

L'état de l'enregistreur passe à QMediaRecorder::PausedState.

Selon la plate-forme, la mise en pause de l'enregistrement peut ne pas être prise en charge. Dans ce cas, l'état de l'enregistreur reste inchangé.

[signal] void QMediaRecorder::qualityChanged()

Signale les changements de qualité d'enregistrement.

[slot] void QMediaRecorder::record()

Démarre l'enregistrement.

Bien que l'état de l'enregistreur passe immédiatement à c{QMediaRecorder::RecordingState}, l'enregistrement peut commencer de manière asynchrone.

En cas d'échec de l'enregistrement, le signal error() est émis et l'état de l'enregistreur est réinitialisé à QMediaRecorder::StoppedState.

Cette méthode met à jour actualLocation conformément à ses règles de génération.

QMediaRecorder::RecorderState QMediaRecorder::recorderState() const

Renvoie l'état actuel de l'enregistreur multimédia.

Voir également QMediaRecorder::RecorderState.

[signal] void QMediaRecorder::recorderStateChanged(QMediaRecorder::RecorderState state)

Signale que l'adresse state d'un enregistreur multimédia a changé.

void QMediaRecorder::setAudioBitRate(int bitRate)

Définit l'audio bitRate en bits par seconde.

Voir aussi audioBitRate().

void QMediaRecorder::setAudioChannelCount(int channels)

Définit le nombre d'audio channels.

Une valeur de -1 indique que l'enregistreur doit faire un choix optimal basé sur ce qui est disponible à partir de la source audio et les limitations du codec.

Voir également audioChannelCount().

void QMediaRecorder::setAudioSampleRate(int sampleRate)

Définit l'audio sampleRate en Hz.

Une valeur de -1 indique que l'enregistreur doit faire un choix optimal en fonction de ce qui est disponible à partir de la source audio et des limites du codec.

Voir également audioSampleRate().

void QMediaRecorder::setEncodingMode(QMediaRecorder::EncodingMode mode)

Définit le paramètre d'encodage mode.

Si ConstantQualityEncoding est défini, le paramètre de codage de la qualité est utilisé et les débits binaires sont ignorés, sinon les débits binaires sont utilisés.

Voir également encodingMode() et EncodingMode.

void QMediaRecorder::setMetaData(const QMediaMetaData &metaData)

Définit les métadonnées sur metaData.

Voir aussi metaData().

void QMediaRecorder::setOutputDevice(QIODevice *device)

Définir le périphérique de sortie IO pour le contenu multimédia.

Le site device doit avoir été ouvert dans les modes WriteOnly ou ReadWrite avant que l'enregistrement ne commence.

L'enregistreur de médias n'est pas propriétaire de l'adresse device spécifiée. Si l'enregistrement a commencé, le périphérique doit être maintenu en vie et ouvert jusqu'à ce que le signal recorderStateChanged(StoppedState) soit émis.

Cette méthode réinitialise immédiatement actualLocation à moins que le device spécifié ne soit null.

Si un périphérique de sortie accessible en écriture est attribué à l'enregistreur, outputLocation est ignoré et actualLocation n'est pas généré au début de l'enregistrement. Ce comportement pourrait changer à l'avenir, c'est pourquoi nous recommandons de ne définir qu'une seule sortie, soit outputLocation ou outputDevice.

QMediaRecorder::setOutputDevice n'est pris en charge qu'avec le backend FFmpeg.

Voir aussi outputDevice() et outputLocation.

void QMediaRecorder::setVideoBitRate(int bitRate)

Définit la vidéo bitRate en bits par seconde.

Voir également videoBitRate().

void QMediaRecorder::setVideoFrameRate(qreal frameRate)

Définit la vidéo frameRate.

Une valeur de 0 indique que l'enregistreur doit faire un choix optimal en fonction de ce qui est disponible à partir de la source vidéo et des limites du codec.

Voir également videoFrameRate().

void QMediaRecorder::setVideoResolution(const QSize &size)

Définit la résolution de la vidéo encodée à size.

Passez un QSize vide pour que l'enregistreur choisisse une résolution optimale en fonction de ce qui est disponible à partir de la source vidéo et des limites du codec.

Voir aussi videoResolution().

void QMediaRecorder::setVideoResolution(int width, int height)

Définit les propriétés width et height de la résolution de la vidéo encodée.

[slot] void QMediaRecorder::stop()

L'enregistreur arrête l'enregistrement. Le traitement des données vidéo et audio en attente peut toutefois prendre un certain temps. L'enregistrement est terminé lorsque l'état de l'enregistreur de médias passe à QMediaRecorder::StoppedState.

int QMediaRecorder::videoBitRate() const

Renvoie le débit binaire du flux vidéo compressé en bits par seconde.

Voir également setVideoBitRate().

[signal] void QMediaRecorder::videoBitRateChanged()

Signaux lorsque le débit binaire de l'enregistrement vidéo change.

qreal QMediaRecorder::videoFrameRate() const

Renvoie la fréquence d'images de la vidéo.

Voir également setVideoFrameRate().

[signal] void QMediaRecorder::videoFrameRateChanged()

Signaux lorsque la fréquence d'images de l'enregistrement vidéo change.

QSize QMediaRecorder::videoResolution() const

Renvoie la résolution de la vidéo encodée.

Voir également setVideoResolution().

[signal] void QMediaRecorder::videoResolutionChanged()

Signale le changement de résolution de l'enregistrement vidéo.