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 の子オブジェクトです。

[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)

エラーの説明を含むerrorString で、error が発生したことを通知する。

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

ビデオ録画の解像度が変更されたときのシグナル。