QAudioSink Class

QFilesourceFile;// クラス・メンバー。QAudioSink* sourceFile; // クラス・メンバー。QIODevice::ReadOnly)；    QAudioFormatformat;// フォーマットの設定、例えばformat.setSampleRate(8000); format.setChannelCount(1); format.setSampleFormat(QAudioFormat::UInt8)；    QAudioDeviceinfo(QMediaDevices::defaultAudioOutput());if(!info.isFormatSupported(format)) { {.        qWarning() << "Raw audio format not supported by backend, cannot play audio.";
       return; } audio= newQAudioSink(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 によって参照されるデバイスは、出力format パラメータで使用される。

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

オーディオ出力を直ちに停止し、現在バッファにあるオーディオデータをすべて破棄する。QIODevice にプッシュされた保留中のオーディオデータはすべて無視される。

stop()も参照 。

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()も参照 。