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

メンバ関数のドキュメント

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 が変更されたことを通知します。

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() は 1 回だけ発火します。

QIODevice *QMediaRecorder::outputDevice() const

メディアコンテンツの出力I/Oデバイスを返します。

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)

メディアコンテンツの出力I/Oデバイスを設定します。

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 のビデオエンコーディングを設定します。

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

動画の録画解像度が変更されたときにシグナルを発します。