QAudioSink Class

QFile sourceFile;   // class member.
QAudioSink* audio; // class member.
{
    sourceFile.setFileName("/tmp/test.raw");
    sourceFile.open(QIODevice::ReadOnly);

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

    QAudioDevice info(QMediaDevices::defaultAudioOutput());
    if (!info.isFormatSupported(format)) {
        qWarning() << "Raw audio format not supported by backend, cannot play audio.";
        return;
    }

    audio = new QAudioSink(format, this);
    connect(audio, QAudioSink::stateChanged, this, &AudioInputExample::handleStateChanged);
    audio->start(&sourceFile);
}

void AudioOutputExample::stopAudioOutput()
{
    audio->stop();
    sourceFile.close();
    delete audio;
}

void AudioOutputExample::handleStateChanged(QAudio::State newState)
{
    switch (newState) {
        case QAudio::IdleState:
            // Finished playing (no more data)
            AudioOutputExample::stopAudioOutput();
            break;

        case QAudio::StoppedState:
            // Stopped for other reasons
            if (audio->error() != QAudio::NoError) {
                // Error handling
            }
            break;

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

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

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

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

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

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

[virtual noexcept] QAudioSink::~QAudioSink()

このオーディオ出力を破棄します。

これにより、使用されているシステムリソースが解放され、バッファが解放されます。

qsizetype QAudioSink::bufferSize() const

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

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

setBufferSize()も参照 。

qsizetype QAudioSink::bytesFree() const

オーディオ・バッファで使用可能な空きバイト数を返します。

qint64 QAudioSink::elapsedUSecs() const

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

QtAudio::Error QAudioSink::error() const

エラー状態を返す。

QAudioFormat QAudioSink::format() const

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

bool QAudioSink::isNull() const

QAudioSink インスタンスがnull の場合はtrue を返し、そうでない場合はfalse を返す。

qint64 QAudioSink::processedUSecs() const

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

void QAudioSink::reset()

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

void QAudioSink::resume()

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

state() をsuspend() が呼び出されたときのシンクの状態に設定し、error() を QAudioError::NoError に設定する。オーディオシンクの状態がQtAudio::SuspendedState でない場合、この関数は何もしない。

void QAudioSink::setBufferSize(qsizetype value)

オーディオ・バッファ・サイズをバイト単位でvalue に設定します。

bufferSize()も参照 。

void QAudioSink::setVolume(qreal volume)

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

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

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

UIの音量コントロールは通常、非線形にスケーリングする必要があります。例えば、対数スケールを使用すると、知覚されるラウドネスが直線的に変化します。詳しくはQtAudio::convertVolume() を参照。

volume()も参照 。

QIODevice *QAudioSink::start()

システムのオーディオ出力へのデータ転送に使用されている内部QIODevice へのポインタを返します。このデバイスはすでにオープンされており、write() はそこに直接データを書き込むことができる。

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

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

QIODeviceも参照 。

void QAudioSink::start(QIODevice *device)

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

QAudioSink が正常に音声データを出力できた場合、state() はQtAudio::ActiveState を返し、error() はQtAudio::NoError を返し、stateChanged() シグナルが発せられる。

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

QIODeviceも参照のこと 。

QtAudio::State QAudioSink::state() const

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

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

このシグナルは、デバイスstate が変更されたときに発せられる。これはオーディオ出力の現在の状態です。

void QAudioSink::stop()

音声出力を停止し、システムリソースから切り離します。

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

reset()も参照 。

void QAudioSink::suspend()

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

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

qreal QAudioSink::volume() const

0.0 から 1.0 の間の音量を返します。

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