QAudioDecoder Class

メンバ関数ドキュメント

[explicit] QAudioDecoder::QAudioDecoder(QObject *parent = nullptr)

QAudioDecoder のインスタンスをparent で構築する。

[override virtual noexcept] QAudioDecoder::~QAudioDecoder()

オーディオ・デコーダー・オブジェクトを破棄する。

QAudioFormat QAudioDecoder::audioFormat() const

デコーダが設定されているオーディオフォーマットを返す。

setAudioFormat() およびformatChanged()も参照 。

bool QAudioDecoder::bufferAvailable() const

読み込み可能なバッファがある場合はtrueを返し、ない場合はfalseを返す。利用可能なバッファがない場合、read() 関数を呼び出すと、無効なバッファが返されます。

[signal] void QAudioDecoder::bufferAvailableChanged(bool available)

新しいバッファが利用可能であることを通知します (available が true の場合)。

available が false の場合、利用可能なバッファはありません。

bufferAvailable() およびbufferReady()も参照してください 。

[signal] void QAudioDecoder::bufferReady()

新しいデコードオーディオバッファが読み込み可能になったことを示す。

read() およびbufferAvailable()も参照 。

qint64 QAudioDecoder::duration() const

オーディオストリームの総時間（ミリ秒）を返します。

[signal] void QAudioDecoder::durationChanged(qint64 duration)

デコードされたデータの推定duration が変更されたことを示す。

positionChanged()も参照のこと 。

QAudioDecoder::Error QAudioDecoder::error() const

QAudioDecoder の現在のエラー状態を返す。

[signal] void QAudioDecoder::error(QAudioDecoder::Error error)

error 条件が発生したことを知らせる。

注意：シグナルerrorはこのクラスでオーバーロードされています。関数ポインタ構文を使用してこのシグナルに接続するために、Qtはこの例に示すように関数ポインタを取得する便利なヘルパーを提供します：

connect(audioDecoder, QOverload<QAudioDecoder::Error>::of(&QAudioDecoder::error),
    [=](QAudioDecoder::Error error){ /* ... */ });

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

[signal] void QAudioDecoder::finished()

デコードが正常に終了したことを知らせる。デコードに失敗した場合は、代わりにエラーシグナルが発せられる。

start(),stop(),error()も参照 。

[signal] void QAudioDecoder::formatChanged(const QAudioFormat &format)

デコーダの現在のオーディオフォーマットがformat に変更されたことを示す。

audioFormat() およびsetAudioFormat()も参照のこと 。

bool QAudioDecoder::isSupported() const

このプラットフォームでオーディオデコーディングがサポートされている場合はtrueを返す。

qint64 QAudioDecoder::position() const

デコーダーから最後に読み込まれたバッファの位置（ミリ秒単位）、またはバッファが読み込まれていない場合は-1を返す。

[signal] void QAudioDecoder::positionChanged(qint64 position)

デコーダの現在のposition が変更されたことを示す。

durationChanged()も参照 。

QAudioBuffer QAudioDecoder::read() const

デコーダからバッファを読み込む。現在利用可能なデコード・バッファがない場合、または失敗した場合は無効なバッファを返す。どちらの場合も、この関数はブロックしない。

read()を呼び出す前に、bufferReady()シグナルに応答するか、bufferAvailable()関数をチェックして、有用なデータが得られることを確認すべきである。

void QAudioDecoder::setAudioFormat(const QAudioFormat &format)

デコードされたサンプルのオーディオフォーマットをformat に設定する。

このプロパティは、デコーダが停止している間のみ設定できます。その他の時間にこのプロパティを設定しても無視される。

デコーダがこのフォーマットをサポートしていない場合、error （）はFormatError に設定される。

フォーマットを指定しない場合、デコードされたオーディオ自体のフォーマットが使用される。それ以外の場合は、何らかのフォーマット変換が適用される。

デコードされたフォーマットを元のオーディオファイルのフォーマットに戻したい場合は、無効なformat を指定することができます。

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

void QAudioDecoder::setSource(const QUrl &fileName)

現在のオーディオファイル名をfileName に設定する。

このプロパティが設定されると、現在のデコードはすべて停止され、オーディオバッファはすべて破棄される。

指定できるのは、ソースファイル名またはソースQIODevice のどちらか一方のみです。一方を設定すると、もう一方は解除されます。

source()も参照 。

void QAudioDecoder::setSourceDevice(QIODevice *device)

現在のオーディオQIODevice をdevice に設定する。

このプロパティが設定されると、現在のデコードはすべて停止され、オーディオバッファはすべて破棄される。

指定できるのは、ソースファイル名またはソースQIODevice のどちらか一方のみです。一方を設定すると、もう一方は設定されなくなります。

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

QUrl QAudioDecoder::source() const

デコードする現在のファイル名を返す。setSourceDevice が呼び出された場合、これは空になる。

setSource()も参照 。

[signal] void QAudioDecoder::sourceChanged()

デコーダの電流ソースが変更されたことを示す。

source() およびsourceDevice()も参照 。

QIODevice *QAudioDecoder::sourceDevice() const

QIODevice が設定されている場合は、現在のソースを返します。setSource() が呼び出された場合、これは NULLptr になります。

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

[slot] void QAudioDecoder::start()

オーディオリソースのデコードを開始する。

データがデコードされると、十分なデータがデコードされた時点でbufferReady() シグナルが発せられる。read() を呼び出すと、ブロックせずにオーディオ・バッファが返されます。

バッファの準備ができる前にread() を呼び出すと、無効なバッファが返されます。

read()も参照 。

[slot] void QAudioDecoder::stop()

音声のデコードを停止する。再度start() を呼び出すと、デコードを最初から再開する。