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

Dokumentation der Mitgliedsfunktionen

QMediaRecorder::QMediaRecorder(QObject *parent = nullptr)

Erstellt einen Medienrekorder. Der Medienrekorder ist ein untergeordnetes Element von „ parent “.

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

Löscht ein Medienrekorder-Objekt.

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

Zeigt an, dass sich die tatsächliche location des aufgezeichneten Mediums geändert hat. Dieses Signal wird in der Regel zu Beginn der Aufzeichnung ausgesendet.

void QMediaRecorder::addMetaData(const QMediaMetaData &metaData)

Fügt „ metaData “ zu den aufgezeichneten Medien hinzu.

int QMediaRecorder::audioBitRate() const

Gibt die Bitrate des komprimierten Audiostreams in Bit pro Sekunde zurück.

Siehe auch „ setAudioBitRate()“.

[signal] void QMediaRecorder::audioBitRateChanged()

Gibt ein Signal aus, wenn sich die Audio-Bitrate der Aufnahme ändert.

int QMediaRecorder::audioChannelCount() const

Gibt die Anzahl der Audiokanäle zurück.

Siehe auch „ setAudioChannelCount()“.

[signal] void QMediaRecorder::audioChannelCountChanged()

Gibt ein Signal aus, wenn sich die Anzahl der Audiokanäle für die Aufnahme ändert.

int QMediaRecorder::audioSampleRate() const

Gibt die Audio-Abtastrate in Hz zurück.

Siehe auch „ setAudioSampleRate()“.

[signal] void QMediaRecorder::audioSampleRateChanged()

Gibt ein Signal aus, wenn sich die Abtastrate der Audioaufnahme ändert.

QMediaCaptureSession *QMediaRecorder::captureSession() const

Gibt die Medienaufzeichnungssitzung zurück.

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

Zeigt an, dass sich die duration der aufgezeichneten Medien geändert hat.

QMediaRecorder::EncodingMode QMediaRecorder::encodingMode() const

Gibt den Kodierungsmodus zurück.

Siehe auch ` setEncodingMode()` und ` EncodingMode`.

[signal] void QMediaRecorder::encodingModeChanged()

Gibt ein Signal aus, wenn sich der Kodierungsmodus ändert.

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

Zeigt an, dass ein „ error “ aufgetreten ist, wobei „ errorString “ eine Beschreibung des Fehlers enthält.

bool QMediaRecorder::isAvailable() const

Gibt „ true “ zurück, wenn der Medienaufzeichnungsdienst einsatzbereit ist.

[signal] void QMediaRecorder::metaDataChanged()

Signalisiert, dass sich die Metadaten eines Medienobjekts geändert haben.

Wenn mehrere Metadatenelemente geändert werden, wird „metaDataChanged()“ einmal ausgelöst.

QIODevice *QMediaRecorder::outputDevice() const

Gibt das Ausgabe-E/A-Gerät für Medieninhalte zurück.

Siehe auch setOutputDevice().

[slot] void QMediaRecorder::pause()

Hält die Aufnahme an.

Der Status des Recorders wird auf „ QMediaRecorder::PausedState “ geändert.

Je nach Plattform wird das Anhalten der Aufzeichnung möglicherweise nicht unterstützt. In diesem Fall bleibt der Status des Rekorders unverändert.

[signal] void QMediaRecorder::qualityChanged()

Gibt ein Signal aus, wenn sich die Aufnahmequalität ändert.

[slot] void QMediaRecorder::record()

Die Aufzeichnung wird gestartet.

Während der Status des Recorders sofort auf c{QMediaRecorder::RecordingState} geändert wird, kann die Aufzeichnung asynchron beginnen.

Wenn die Aufzeichnung fehlschlägt, wird das Signal „ error()“ ausgelöst, wobei der Status des Rekorders auf „ QMediaRecorder::StoppedState “ zurückgesetzt wird.

Diese Methode aktualisiert „ actualLocation “ gemäß den Regeln für dessen Erzeugung.

QMediaRecorder::RecorderState QMediaRecorder::recorderState() const

Gibt den aktuellen Status des Medienrekorders zurück.

Siehe auch „ QMediaRecorder::RecorderState “.

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

Signalisiert, dass sich die Eigenschaft „ state “ eines Medienrekorders geändert hat.

void QMediaRecorder::setAudioBitRate(int bitRate)

Legt die Audio bitRate en in Bit pro Sekunde fest.

Siehe auch ` audioBitRate()`.

void QMediaRecorder::setAudioChannelCount(int channels)

Legt die Anzahl der Audio channels fest.

Der Wert -1 bedeutet, dass der Recorder eine optimale Auswahl treffen soll, basierend auf den von der Audioquelle verfügbaren Daten und den Einschränkungen des Codecs.

Siehe auch ` audioChannelCount()`.

void QMediaRecorder::setAudioSampleRate(int sampleRate)

Legt die Audio- sampleRate e in Hz fest.

Der Wert „ -1 “ bedeutet, dass der Recorder eine optimale Auswahl treffen soll, basierend auf den von der Audioquelle verfügbaren Daten und den Einschränkungen des Codecs.

Siehe auch audioSampleRate().

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

Legt die Einstellung „encoding mode “ fest.

Wenn „ ConstantQualityEncoding “ gesetzt ist, wird der Qualitätsparameter für die Kodierung verwendet und die Bitraten werden ignoriert; andernfalls werden die Bitraten verwendet.

Siehe auch „ encodingMode()“ und „ EncodingMode “.

void QMediaRecorder::setMetaData(const QMediaMetaData &metaData)

Setzt die Metadaten auf „ metaData “.

Siehe auch ` metaData()`.

void QMediaRecorder::setOutputDevice(QIODevice *device)

Legen Sie das Ausgabe-E/A-Gerät für Medieninhalte fest.

Die Datei „ device “ muss vor Beginn der Aufzeichnung im Modus „ WriteOnly “ oder „ ReadWrite “ geöffnet worden sein.

Der Medienrekorder übernimmt nicht die Kontrolle über das angegebene „ device “. Wenn die Aufnahme gestartet wurde, muss das Gerät aktiv und geöffnet bleiben, bis das Signal „ recorderStateChanged(StoppedState) “ gesendet wird.

Diese Methode setzt „ actualLocation “ sofort zurück, es sei denn, der angegebene „ device “ lautet „ null “.

Wenn dem Recorder ein beschreibbares Ausgabegerät zugewiesen ist, wird „ outputLocation “ ignoriert, und „ actualLocation “ wird beim Start der Aufnahme nicht generiert. Dieses Verhalten kann sich in Zukunft ändern, daher empfehlen wir, nur eine Ausgabe festzulegen, entweder „ outputLocation “ oder „ outputDevice “.

QMediaRecorder::setOutputDevice wird nur vom FFmpeg-Backend unterstützt.

Siehe auch outputDevice() und outputLocation.

void QMediaRecorder::setVideoBitRate(int bitRate)

Legt die Video bitRate in Bit pro Sekunde fest.

Siehe auch ` videoBitRate()`.

void QMediaRecorder::setVideoFrameRate(qreal frameRate)

Legt die Videokodierungs frameRate fest.

Siehe auch ` videoFrameRate()`.

void QMediaRecorder::setVideoResolution(const QSize &size)

Legt die Auflösung des kodierten Videos auf „ size “ fest.

Übergeben Sie ein leeres ` QSize `, damit der Recorder anhand der von der Videoquelle verfügbaren Optionen und der Einschränkungen des Codecs eine optimale Auflösung auswählt.

Siehe auch ` videoResolution()`.

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

Legt die Werte für „ width “ und „ height “ der Auflösung des kodierten Videos fest.

[slot] void QMediaRecorder::stop()

Der Recorder beendet die Aufnahme. Die Verarbeitung der noch ausstehenden Video- und Audiodaten kann jedoch noch einige Zeit in Anspruch nehmen. Die Aufnahme ist abgeschlossen, sobald sich der Status des Medienrekorders in „ QMediaRecorder::StoppedState “ ändert.

int QMediaRecorder::videoBitRate() const

Gibt die Bitrate des komprimierten Videostreams in Bit pro Sekunde zurück.

Siehe auch „ setVideoBitRate()“.

[signal] void QMediaRecorder::videoBitRateChanged()

Gibt ein Signal aus, wenn sich die Bitrate der Videoaufnahme ändert.

qreal QMediaRecorder::videoFrameRate() const

Gibt die Bildrate der Videokodierung zurück.

Siehe auch „ setVideoFrameRate()“.

[signal] void QMediaRecorder::videoFrameRateChanged()

Gibt ein Signal aus, wenn sich die Bildrate der Videokodierung ändert.

QSize QMediaRecorder::videoResolution() const

Gibt die Auflösung des kodierten Videos zurück.

Siehe auch „ setVideoResolution()“.

[signal] void QMediaRecorder::videoResolutionChanged()

Gibt ein Signal aus, wenn sich die Auflösung der Videoaufzeichnung ändert.