QAudioSource Class

QFile destinationFile;   // Class member
QAudioSource* audio; // Class member
{
    destinationFile.setFileName("/tmp/test.raw");
    destinationFile.open( QIODevice::WriteOnly | QIODevice::Truncate );

    QAudioFormat format;
    // Set up the desired format, for example:
    format.setSampleRate(8000);
    format.setChannelCount(1);
    format.setSampleFormat(QAudioFormat::UInt8);

    QAudioDevice info = QMediaDevices::defaultAudioInput();
    if (!info.isFormatSupported(format)) {
        qWarning() << "Default format not supported, trying to use the nearest.";
    }

    audio = new QAudioSource(format, this);
    connect(audio, &QAudioSource::stateChanged, this, &AudioInputExample::handleStateChanged);

    QTimer::singleShot(3000, this, &AudioInputExample::stopRecording);
    audio->start(&destinationFile);
    // Records audio for 3000ms
}

void AudioInputExample::stopRecording()
{
    audio->stop();
    destinationFile.close();
    delete audio;
}

void AudioInputExample::handleStateChanged(QAudio::State newState)
{
    switch (newState) {
        case QAudio::StoppedState:
            if (audio->error() != QAudio::NoError) {
                // Error handling
            } else {
                // Finished recording
            }
            break;

        case QAudio::ActiveState:
            // Started recording - read from IO device
            break;

        default:
            // ... other cases as appropriate
            break;
    }
}

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

[explicit] QAudioSource::QAudioSource(const QAudioFormat &format = QAudioFormat(), QObject *parent = nullptr)

新しいオーディオ入力を構築し、それをparent にアタッチする。 デフォルトのオーディオ入力デバイスは、出力format パラメータで使用される。

[explicit] QAudioSource::QAudioSource(const QAudioDevice &audioDevice, const QAudioFormat &format = QAudioFormat(), QObject *parent = nullptr)

新しいオーディオ入力を構築し、parent にアタッチします。audioDevice によって参照されるデバイスは、入力format パラメータで使用されます。

[virtual noexcept] QAudioSource::~QAudioSource()

このオーディオ入力を破棄する。

qsizetype QAudioSource::bufferSize() const

オーディオバッファサイズをバイト単位で返す。

start() の前に呼び出された場合、プラットフォームのデフォルト値を返す。start() の前に呼び出されたが、その前にsetBufferSize() が呼び出された場合、setBufferSize() で設定された値を返す。start() の後に呼び出された場合、実際に使用されているバッファ・サイズを返す。これは、setBufferSize() で設定された値とは異なる可能性がある。

setBufferSize()も参照 。

qsizetype QAudioSource::bytesAvailable() const

読み込める音声データの量をバイト単位で返します。

注意：返される値は、QtAudio::ActiveState またはQtAudio::IdleState の状態にあるときのみ有効である。

qint64 QAudioSource::elapsedUSecs() const

アイドル状態およびサスペンド状態にあった時間を含め、start() が呼び出されてからのマイクロ秒を返す。

QtAudio::Error QAudioSource::error() const

エラー状態を返す。

QAudioFormat QAudioSource::format() const

使用されているQAudioFormat を返す。

bool QAudioSource::isNull() const

オーディオ・ソースがnull の場合はtrue を返し、そうでない場合はfalse を返す。

qint64 QAudioSource::processedUSecs() const

start() が呼び出されてから処理された音声データ量をマイクロ秒単位で返す。

void QAudioSource::reset()

バッファ内のすべてのオーディオ・データを削除し、バッファをゼロにリセットする。

void QAudioSource::resume()

suspend() の後にオーディオ・データの処理を再開する。

state QtAudio::ActiveState 以前に start(QIODevice*) を呼び出した場合は、error() をQtAudio::NoError に設定。以前にstart() を呼び出した場合は、state() をQtAudio::IdleState に設定する。stateChanged() シグナルを発する。

void QAudioSource::setBufferSize(qsizetype value)

オーディオ・バッファ・サイズをvalue バイトに設定する。

注：この関数はstart() の前であればいつでも呼び出すことができます。start() 以降の呼び出しは無視されます。start() の後にbufferSize() を呼び出すと、実際に使用されているバッファサイズが返される。

bufferSize()も参照 。

void QAudioSource::setVolume(qreal volume)

入力ボリュームをvolume に設定する。

音量は、0.0 （無音）から1.0 （フル音量）まで、直線的にスケーリングされる。この範囲外の値はクランプされる。

デバイスが入力音量の調整に対応していない場合、volume は無視され、入力音量は 1.0 のままになります。

デフォルトの音量は1.0 です。

注：音量の調整は、グローバル音量ではなく、このオーディオストリームの音量を変更します。

volume()も参照 。

QIODevice *QAudioSource::start()

システムの音声入力からのデータ転送に使用される内部QIODevice へのポインタを返します。このデバイスはすでにオープンされており、read() はそこから直接データを読み込むことができる。

QAudioSource がシステムのオーディオ・デバイスにアクセスできた場合、state() はQtAudio::IdleState を返し、error() はQtAudio::NoError を返し、stateChanged() シグナルが発せられる。

この処理中に問題が発生した場合、error() はQtAudio::OpenError を返し、state() はQtAudio::StoppedState を返し、stateChanged() シグナルが発せられる。

QIODeviceも参照 。

void QAudioSource::start(QIODevice *device)

システムのオーディオ入力からdevice へのオーディオ・データの転送を開始する。device はWriteOnly 、Append またはReadWrite モードでオープンされていなければならない。

QAudioSource が正常にオーディオ・データを取得できた場合、state() はQtAudio::ActiveState またはQtAudio::IdleState のいずれかを返し、error() はQtAudio::NoError を返し、stateChanged() シグナルが発せられる。

この処理中に問題が発生した場合、error() はQtAudio::OpenError を返し、state() はQtAudio::StoppedState を返し、stateChanged() シグナルが発せられる。

QIODeviceも参照 。

QtAudio::State QAudioSource::state() const

オーディオ処理の状態を返す。

[signal] void QAudioSource::stateChanged(QtAudio::State state)

このシグナルは、デバイスstate が変更されたときに発せられる。

void QAudioSource::stop()

オーディオ入力を停止し、システムリソースから切り離します。

error() をQtAudio::NoError に、state() をQtAudio::StoppedState に設定し、stateChanged() シグナルを発信します。

void QAudioSource::suspend()

オーディオ・データの処理を停止し、バッファされたオーディオ・データを保持する。

error() をQtAudio::NoError に、state() をQtAudio::SuspendedState に設定し、stateChanged() シグナルを出力する。

qreal QAudioSource::volume() const

入力音量を返す。

デバイスが入力音量の調整に対応していない場合、返される値は 1.0 となる。

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