QMediaRecorder Class

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

Documentation des fonctions membres

QMediaRecorder::QMediaRecorder(QObject *parent = nullptr)

Crée un enregistreur multimédia. L'enregistreur multimédia est un élément enfant de ` parent`.

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

Supprime un objet « media recorder ».

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

Indique que l'location réelle 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 d'enregistrement.

int QMediaRecorder::audioBitRate() const

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

Voir aussi setAudioBitRate().

[signal] void QMediaRecorder::audioBitRateChanged()

Signale tout changement du débit binaire d'enregistrement audio.

int QMediaRecorder::audioChannelCount() const

Renvoie le nombre de canaux audio.

Voir aussi setAudioChannelCount().

[signal] void QMediaRecorder::audioChannelCountChanged()

Émet un signal lorsque le nombre de canaux audio d'enregistrement change.

int QMediaRecorder::audioSampleRate() const

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

Voir aussi setAudioSampleRate().

[signal] void QMediaRecorder::audioSampleRateChanged()

Émet un signal lorsque la fréquence d'échantillonnage audio de l'enregistrement change.

QMediaCaptureSession *QMediaRecorder::captureSession() const

Renvoie la session de capture multimédia.

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

Indique que l'duration s du support enregistré a changé.

QMediaRecorder::EncodingMode QMediaRecorder::encodingMode() const

Renvoie le mode d'encodage.

Voir également setEncodingMode() et EncodingMode.

[signal] void QMediaRecorder::encodingModeChanged()

Signale tout changement de mode d'encodage.

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

Indique qu'une « error » s'est produite, avec errorString contenant une description de l'erreur.

bool QMediaRecorder::isAvailable() const

Renvoie « true » si le service d'enregistrement multimédia est prêt à l'emploi.

[signal] void QMediaRecorder::metaDataChanged()

Indique que les métadonnées d'un objet multimédia ont été modifiées.

Si plusieurs éléments de métadonnées sont modifiés, la fonction metaDataChanged() est émise une seule fois.

QIODevice *QMediaRecorder::outputDevice() const

Renvoie le périphérique d'E/S de sortie pour le contenu multimédia.

Voir également setOutputDevice().

[slot] void QMediaRecorder::pause()

Interrompt l'enregistrement.

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

Selon la plateforme, 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 tout changement de qualité d'enregistrement.

[slot] void QMediaRecorder::record()

Lance l'enregistrement.

Bien que l'état de l'enregistreur passe immédiatement à c{QMediaRecorder::RecordingState}, l'enregistrement peut démarrer 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 aussi QMediaRecorder::RecorderState.

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

Indique qu’une propriété d’ state d’un enregistreur multimédia a changé.

void QMediaRecorder::setAudioBitRate(int bitRate)

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

Voir aussi audioBitRate().

void QMediaRecorder::setAudioChannelCount(int channels)

Définit le nombre d'channels s audio.

Une valeur de -1 indique que l'enregistreur doit effectuer un choix optimal en fonction des données disponibles provenant de la source audio et des limitations du codec.

Voir également audioChannelCount().

void QMediaRecorder::setAudioSampleRate(int sampleRate)

Définit l'sampleRate audio en Hz.

Une valeur de « -1 » indique que l'enregistreur doit effectuer un choix optimal en fonction des données disponibles provenant de la source audio et des limitations du codec.

Voir aussi audioSampleRate().

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

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

Si « ConstantQualityEncoding » est défini, le paramètre d'encodage « quality » est utilisé et les débits binaires sont ignorés ; dans le cas contraire, ce sont les débits binaires qui sont utilisés.

Voir également ` encodingMode()` et ` EncodingMode`.

void QMediaRecorder::setMetaData(const QMediaMetaData &metaData)

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

Voir également metaData().

void QMediaRecorder::setOutputDevice(QIODevice *device)

Définir le périphérique d'E/S de sortie pour le contenu multimédia.

L'device doit avoir été ouvert en mode « WriteOnly » ou « ReadWrite » avant le début de l'enregistrement.

L'enregistreur multimédia ne prend pas possession de l'device spécifié. Si l'enregistrement a été lancé, le périphérique doit rester actif et ouvert jusqu'à ce que le signal « recorderStateChanged(StoppedState) » soit émis.

Cette méthode réinitialise immédiatement ` actualLocation `, sauf si le signal ` device ` spécifié est ` 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émarrage de l’enregistrement. Ce comportement est susceptible d’évoluer à l’avenir ; nous recommandons donc de ne définir qu’une seule sortie, soit outputLocation, soit outputDevice.

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

Voir également outputDevice() et outputLocation.

void QMediaRecorder::setVideoBitRate(int bitRate)

Définit l'bitRate vidéo en bits par seconde.

Voir aussi ` videoBitRate()`.

void QMediaRecorder::setVideoFrameRate(qreal frameRate)

Définit l'frameRate d'encodage vidéo.

Voir également videoFrameRate().

void QMediaRecorder::setVideoResolution(const QSize &size)

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

Passez un paramètre « QSize » vide pour que l'enregistreur choisisse une résolution optimale en fonction des données disponibles provenant de la source vidéo et des limitations du codec.

Voir également videoResolution().

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

Définit les paramètres « width » et « height » de la résolution de la vidéo encodée.

[slot] void QMediaRecorder::stop()

L'enregistreur mettra fin à l'enregistrement. Le traitement des données vidéo et audio en attente peut toutefois encore prendre un certain temps. L'enregistrement est terminé dès que l'état de l'enregistreur multimédia passe à « QMediaRecorder::StoppedState ».

int QMediaRecorder::videoBitRate() const

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

Voir aussi setVideoBitRate().

[signal] void QMediaRecorder::videoBitRateChanged()

Signale tout changement du débit binaire de l'enregistrement vidéo.

qreal QMediaRecorder::videoFrameRate() const

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

Voir aussi setVideoFrameRate().

[signal] void QMediaRecorder::videoFrameRateChanged()

Signale tout changement de fréquence d'images lors de l'encodage vidéo.

QSize QMediaRecorder::videoResolution() const

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

Voir aussi setVideoResolution().

[signal] void QMediaRecorder::videoResolutionChanged()

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