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

メンバ関数ドキュメント

QMediaRecorder::QMediaRecorder(QObject *parent = nullptr)

メディア レコーダーを構築する。メディア レコーダーはparent の子です。

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

メディアレコーダーオブジェクトを破棄する。

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

記録メディアの実際のlocation が変化したことを示す信号。このシグナルは通常、記録開始時に発せられる。

void QMediaRecorder::addMetaData(const QMediaMetaData &metaData)

記録メディアにmetaData 。

int QMediaRecorder::audioBitRate() const

圧縮オーディオストリームのビットレートをビット毎秒で返す。

setAudioBitRate()も参照してください 。

[signal] void QMediaRecorder::audioBitRateChanged()

録画音声のビットレートが変更されたときの信号。

int QMediaRecorder::audioChannelCount() const

オーディオチャンネル数を返す。

setAudioChannelCount()も参照してください 。

[signal] void QMediaRecorder::audioChannelCountChanged()

録音オーディオチャンネル数が変更されたときに通知する。

int QMediaRecorder::audioSampleRate() const

オーディオサンプルレートを Hz 単位で返します。

setAudioSampleRate()も参照してください 。

[signal] void QMediaRecorder::audioSampleRateChanged()

レコーディングオーディオサンプルレートが変更されたときのシグナル。

QMediaCaptureSession *QMediaRecorder::captureSession() const

メディアキャプチャセッションを返します。

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

記録メディアのduration が変更されたことを示す。

[signal] void QMediaRecorder::encoderSettingsChanged()

エンコーダの設定が変更されたことを知らせる。

QMediaRecorder::EncodingMode QMediaRecorder::encodingMode() const

エンコーディングモードを返す。

setEncodingMode() およびEncodingModeも参照してください 。

[signal] void QMediaRecorder::encodingModeChanged()

エンコーディングモードが変更されたときに通知する。

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

error 、エラーの説明を含むerrorString 。

bool QMediaRecorder::isAvailable() const

メディア・レコーダー・サービスが使用可能であれば、true を返す。

[signal] void QMediaRecorder::metaDataChanged()

メディアオブジェクトのメタデータが変更されたことを知らせる。

複数のメタデータ要素が変更された場合、 metaDataChanged()は一度だけ発行される。

QIODevice *QMediaRecorder::outputDevice() const

メディアコンテンツの出力IOデバイスを返す。

setOutputDevice()も参照 。

[slot] void QMediaRecorder::pause()

録音を一時停止します。

レコーダーの状態はQMediaRecorder::PausedState に変更されます。

プラットフォームによっては、録画の一時停止に対応していない場合があります。この場合、レコーダーの状態は変更されません。

[signal] void QMediaRecorder::qualityChanged()

録画画質が変化したときに通知する。

[slot] void QMediaRecorder::record()

録画を開始する。

レコーダーの状態はすぐに c{QMediaRecorder::RecordingState} に変更されるが、録画は非同期で開始される。

録画に失敗すると、error() シグナルが発せられ、レコーダーの状態はQMediaRecorder::StoppedState にリセットされる。

このメソッドは、生成規則に従ってactualLocation を更新する。

QMediaRecorder::RecorderState QMediaRecorder::recorderState() const

現在のメディアレコーダーの状態を返す。

QMediaRecorder::RecorderStateも参照 。

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

メディアレコーダのstate が変更されたことを通知する。

void QMediaRecorder::setAudioBitRate(int bitRate)

オーディオbitRate をビット毎秒で設定する。

audioBitRate()も参照 。

void QMediaRecorder::setAudioChannelCount(int channels)

オーディオchannels の数を設定します。

値 -1 は、レコーダーがオーディオソースから利用可能なものとコーデックの制限に基づいて最適な選択を行う必要があることを示します。

audioChannelCount()も参照 。

void QMediaRecorder::setAudioSampleRate(int sampleRate)

オーディオのsampleRate を Hz 単位で設定します。

値が-1 の場合、レコーダーはオーディオソースから利用可能なものとコーデックの制限に基づいて最適な選択を行う必要があることを示します。

audioSampleRate()も参照 。

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

エンコーディングmode の設定をする。

ConstantQualityEncoding が設定されている場合、品質エンコーディングパラメータが使用され、ビットレートは無視されます。

encodingMode() およびEncodingModeも参照 。

void QMediaRecorder::setMetaData(const QMediaMetaData &metaData)

メタデータをmetaData に設定する。

metaData()も参照のこと 。

void QMediaRecorder::setOutputDevice(QIODevice *device)

メディアコンテンツの出力IOデバイスを設定する。

device は、録画開始前にWriteOnly またはReadWrite モードでオープンされていなければならない。

メディアレコーダは、指定されたdevice の所有権を取らない。録画が開始された場合、シグナルrecorderStateChanged(StoppedState) が発せられるまで、デバイスをアライブしてオープンしておく必要がある。

このメソッドは、指定されたdevice がnull でない限り、actualLocation を即座にリセットする。

書き込み可能な出力デバイスがレコーダーに割り当てられている場合、outputLocation は無視され、録画開始時にactualLocation は生成されない。この動作は将来変更される可能性があるため、outputLocation またはoutputDevice のどちらか1つの出力のみを設定することを推奨する。

QMediaRecorder::setOutputDevice はFFmpegバックエンドでのみサポートされています。

outputDevice() およびoutputLocationも参照のこと 。

void QMediaRecorder::setVideoBitRate(int bitRate)

ビデオbitRate をビット毎秒で設定する。

videoBitRate()も参照 。

void QMediaRecorder::setVideoFrameRate(qreal frameRate)

ビデオframeRate を設定する。

値が 0 の場合、レコーダーは、ビデオソースから利用可能なものとコーデックの制限に基づいて、最適な選択を行う必要があることを示します。

videoFrameRate()も参照 。

void QMediaRecorder::setVideoResolution(const QSize &size)

エンコードされたビデオの解像度をsize に設定する。

空のQSize を渡すと、レコーダーは、ビデオソースから利用可能なものとコーデックの制限に基づいて、最適な解像度を選択します。

videoResolution()も参照 。

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

エンコードされたビデオの解像度のwidth とheight を設定する。

これはオーバーロードされた関数です。

[slot] void QMediaRecorder::stop()

レコーダーは録画を停止します。しかし、保留中のビデオおよびオーディオデータの処理には、まだ時間がかかる場合があります。メディアレコーダーの状態がQMediaRecorder::StoppedState に変わると、録画は終了します。

int QMediaRecorder::videoBitRate() const

圧縮ビデオストリームのビットレートをビット毎秒で返す。

setVideoBitRate()も参照 。

[signal] void QMediaRecorder::videoBitRateChanged()

録画映像のビットレートが変更された場合に通知する。

qreal QMediaRecorder::videoFrameRate() const

ビデオフレームレートを返す。

setVideoFrameRate()も参照 。

[signal] void QMediaRecorder::videoFrameRateChanged()

録画映像のフレームレートが変化したときに通知する。

QSize QMediaRecorder::videoResolution() const

エンコードされた動画の解像度を返す。

setVideoResolution()も参照 。

[signal] void QMediaRecorder::videoResolutionChanged()

録画解像度が変更された場合に通知する。