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 Dokumentation

QMediaRecorder::QMediaRecorder(QObject *parent = nullptr)

Konstruiert einen Medienrekorder. Der Medienrekorder ist ein Kind von parent.

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

Zerstört ein Medienrekorder-Objekt.

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

Signalisiert, dass sich die aktuelle location des bespielten Mediums geändert hat. Dieses Signal wird normalerweise beim Start der Aufnahme ausgegeben.

void QMediaRecorder::addMetaData(const QMediaMetaData &metaData)

Fügt metaData zu den aufgezeichneten Medien hinzu.

int QMediaRecorder::audioBitRate() const

Gibt die Bitrate des komprimierten Audiostroms in Bits pro Sekunde zurück.

Siehe auch setAudioBitRate().

[signal] void QMediaRecorder::audioBitRateChanged()

Signalisiert, 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()

Signalisiert, wenn sich die Anzahl der Aufnahme-Audiokanäle ändert.

int QMediaRecorder::audioSampleRate() const

Gibt die Audio-Sample-Rate in Hz zurück.

Siehe auch setAudioSampleRate().

[signal] void QMediaRecorder::audioSampleRateChanged()

Signalisiert, wenn sich die Abtastrate der Audioaufnahme ändert.

QMediaCaptureSession *QMediaRecorder::captureSession() const

Gibt die Medienerfassungssitzung zurück.

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

Signalisiert, dass sich die duration des bespielten Mediums geändert hat.

[signal] void QMediaRecorder::encoderSettingsChanged()

Signalisiert, wenn sich die Encodereinstellungen ändern.

QMediaRecorder::EncodingMode QMediaRecorder::encodingMode() const

Gibt den Kodierungsmodus zurück.

Siehe auch setEncodingMode() und EncodingMode.

[signal] void QMediaRecorder::encodingModeChanged()

Signalisiert, wenn sich der Kodierungsmodus ändert.

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

Signalisiert, dass ein error aufgetreten ist, wobei errorString eine Beschreibung des Fehlers enthält.

bool QMediaRecorder::isAvailable() const

Gibt true zurück, wenn der Medienrekorderdienst 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 ausgegeben.

QIODevice *QMediaRecorder::outputDevice() const

Gibt das Ausgabe-IO-Gerät für Medieninhalte zurück.

Siehe auch setOutputDevice().

[slot] void QMediaRecorder::pause()

Pausiert die Aufnahme.

Der Rekorderstatus wird auf QMediaRecorder::PausedState geändert.

Je nach Plattform wird das Pausieren der Aufzeichnung möglicherweise nicht unterstützt. In diesem Fall bleibt der Rekorderstatus unverändert.

[signal] void QMediaRecorder::qualityChanged()

Signalisiert, wenn sich die Aufnahmequalität ändert.

[slot] void QMediaRecorder::record()

Startet die Aufnahme.

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

Schlägt die Aufzeichnung fehl, wird das Signal error() ausgegeben und der Rekorderstatus auf QMediaRecorder::StoppedState zurückgesetzt.

Diese Methode aktualisiert actualLocation gemäß ihren Erzeugungsregeln.

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 der state eines Medienrekorders geändert hat.

void QMediaRecorder::setAudioBitRate(int bitRate)

Legt die Audioqualität bitRate in Bits pro Sekunde fest.

Siehe auch audioBitRate().

void QMediaRecorder::setAudioChannelCount(int channels)

Legt die Anzahl der Audiosignale channels fest.

Ein Wert von -1 bedeutet, dass der Rekorder eine optimale Auswahl treffen sollte, die auf den von der Audioquelle verfügbaren Daten und den Einschränkungen des Codecs basiert.

Siehe auch audioChannelCount().

void QMediaRecorder::setAudioSampleRate(int sampleRate)

Legt die Audiofrequenz sampleRate in Hz fest.

Ein Wert von -1 zeigt an, dass der Rekorder eine optimale Auswahl treffen sollte, die auf den verfügbaren Daten der Audioquelle und den Einschränkungen des Codecs basiert.

Siehe auch audioSampleRate().

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

Legt die Einstellung für die Kodierung mode fest.

Wenn ConstantQualityEncoding gesetzt ist, wird der Qualitätskodierungsparameter 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-IO-Gerät für Medieninhalte fest.

Das device muss im Modus WriteOnly oder ReadWrite geöffnet worden sein, bevor die Aufnahme beginnt.

Der Medienrekorder übernimmt nicht das Eigentum an dem angegebenen device. Wenn die Aufzeichnung gestartet wurde, muss das Gerät am Leben gehalten und geöffnet werden, bis das Signal recorderStateChanged(StoppedState) ausgegeben wird.

Diese Methode setzt actualLocation sofort zurück, es sei denn, das angegebene device ist null.

Wenn dem Rekorder ein beschreibbares Ausgabegerät zugewiesen ist, wird outputLocation ignoriert, und actualLocation wird beim Start der Aufzeichnung nicht erzeugt. Dieses Verhalten kann sich in Zukunft ändern, daher empfehlen wir, nur einen Ausgang zu setzen, entweder outputLocation oder outputDevice.

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

Siehe auch outputDevice() und outputLocation.

void QMediaRecorder::setVideoBitRate(int bitRate)

Legt das Video bitRate in Bits pro Sekunde fest.

Siehe auch videoBitRate().

void QMediaRecorder::setVideoFrameRate(qreal frameRate)

Legt das Video frameRate fest.

Ein Wert von 0 bedeutet, dass der Rekorder eine optimale Auswahl treffen sollte, die auf den von der Videoquelle verfügbaren Daten und den Einschränkungen des Codecs basiert.

Siehe auch videoFrameRate().

void QMediaRecorder::setVideoResolution(const QSize &size)

Setzt die Auflösung des kodierten Videos auf size.

Übergeben Sie eine leere QSize, damit der Rekorder eine optimale Auflösung auf der Grundlage der von der Videoquelle verfügbaren Daten und der Einschränkungen des Codecs wählt.

Siehe auch videoResolution().

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

Legt die width und height der Auflösung des kodierten Videos fest.

Dies ist eine überladene Funktion.

[slot] void QMediaRecorder::stop()

Der Rekorder stoppt die Aufzeichnung. Die Verarbeitung anstehender Video- und Audiodaten kann jedoch noch einige Zeit in Anspruch nehmen. Die Aufnahme ist beendet, wenn der Status des Medienrekorders auf QMediaRecorder::StoppedState wechselt.

int QMediaRecorder::videoBitRate() const

Gibt die Bitrate des komprimierten Videostroms in Bits pro Sekunde zurück.

Siehe auch setVideoBitRate().

[signal] void QMediaRecorder::videoBitRateChanged()

Signalisiert, wenn sich die Bitrate der Videoaufzeichnung ändert.

qreal QMediaRecorder::videoFrameRate() const

Gibt die Videobildrate zurück.

Siehe auch setVideoFrameRate().

[signal] void QMediaRecorder::videoFrameRateChanged()

Signalisiert, wenn sich die Bildrate der Videoaufzeichnung ändert.

QSize QMediaRecorder::videoResolution() const

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

Siehe auch setVideoResolution().

[signal] void QMediaRecorder::videoResolutionChanged()

Signalisiert, wenn sich die Auflösung der Videoaufzeichnung ändert.