QAudio 名稱空間

QAudio 名稱空間包含用於音頻類的枚舉。更多...

頭：	#include <QAudio>
CMake:	find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake:	QT += multimedia

類型

enum	Error { NoError, OpenError, IOError, UnderrunError, FatalError }
enum	State { ActiveState, SuspendedState, StoppedState, IdleState }
enum	VolumeScale { LinearVolumeScale, CubicVolumeScale, LogarithmicVolumeScale, DecibelVolumeScale }

函數

float

convertVolume (float volume , QAudio::VolumeScale from , QAudio::VolumeScale to )

詳細描述

類型文檔編製

enum QAudio:: Error

常量	值	描述
`QAudio::NoError`	`0`	沒有齣現錯誤
`QAudio::OpenError`	`1`	打開音頻設備時，齣現錯誤
`QAudio::IOError`	`2`	讀/寫音頻設備時，齣現錯誤
`QAudio::UnderrunError`	`3`	未以足夠快的速率，把音頻數據喂給音頻設備
`QAudio::FatalError`	`4`	齣現不可恢復錯誤，音頻設備此時不可用。

enum QAudio:: State

常量	值	描述
`QAudio::ActiveState`	`0`	正處理音頻數據，此狀態是在調用 start() 後設置的，且音頻數據同時可用於處理。
`QAudio::SuspendedState`	`1`	音頻流處於掛起狀態。在調用 suspend() 後 (或當另一流控製音頻設備時)，進入。在後一情況下，對 resume 的調用將把音頻設備的控製返迴給此流。通常，這隻應在用戶請求時進行。
`QAudio::StoppedState`	`2`	關閉音頻設備，且不處理任何音頻數據
`QAudio::IdleState`	`3`	The QIODevice 傳入沒有數據且音頻係統的緩衝為空，此狀態在調用 start() 後設置，且同時沒有音頻數據可用於處理。

enum QAudio:: VolumeScale

此枚舉定義不同音頻音量的比例縮放。

常量	值	描述
`QAudio::LinearVolumeScale`	`0`	綫性比例縮放。 `0.0` (0%) 為無聲而 `1.0` (100%) 為全音量。所有擁有音頻的 Qt Multimedia 類，音量使用綫性比例縮放。
`QAudio::CubicVolumeScale`	`1`	立方比例縮放。 `0.0` (0%) 為無聲而 `1.0` (100%) 為全音量。
`QAudio::LogarithmicVolumeScale`	`2`	對數比例縮放。 `0.0` (0%) 為無聲而 `1.0` (100%) 為全音量。通常，UI 音量控製應使用對數比例縮放。
`QAudio::DecibelVolumeScale`	`3`	分貝 (dB、振幅) 對數比例縮放。 `-200` 為無聲而 `0` 為全音量。

另請參閱 QAudio::convertVolume ().

函數文檔編製

float QAudio:: convertVolume ( float volume , QAudio::VolumeScale from , QAudio::VolumeScale to )

轉換音頻 volume from 音量比例縮放 to 另一，並返迴結果。

從屬上下文，錶示音頻音量是使用不同刻度。所有擁有音頻音量的 Qt Multimedia 類都使用綫性刻度，原因是揚聲器響度是通過綫性刻度調製其電壓來控製的。另一方麵，人的耳朵以對數方式感知響度。因此，在大多數應用程序中，音量控製使用對數刻度很閤適。分貝刻度本質上是對數的，且常用於定義聲明級彆，通常用於專業音頻應用程序 UI 音量控製。立方刻度是對數刻度的便宜計算近似，它提供對較低音量級彆的更多控製。

以下範例展示如何從滑塊控件轉換音量值，先於把它傳遞給 QMediaPlayer 。因此，感知音量遞增一樣，當把音量滑塊從 20 遞增到 30 時，就像從 50 到 60：

void applyVolume(int volumeSliderValue)
{
    // volumeSliderValue is in the range [0..100]
    qreal linearVolume = QAudio::convertVolume(volumeSliderValue / qreal(100.0),
                                               QAudio::LogarithmicVolumeScale,
                                               QAudio::LinearVolumeScale);
    player.setVolume(qRound(linearVolume * 100));
}

另請參閱 VolumeScale , QAudioSink::setVolume (), QAudioSource::setVolume ()，和 QSoundEffect::setVolume ().