# QAudioDeviceInfo Class Reference ## [[QtMultimedia](index.htm) module] 該QAudioDeviceInfo類提供查詢音頻設備及其功能的接口。[More...](#details) ### Methods * `__init__ (self)` * `__init__ (self, QAudioDeviceInfo?other)` * `QString deviceName (self)` * `bool isFormatSupported (self, QAudioFormat?format)` * `bool isNull (self)` * `QAudioFormat nearestFormat (self, QAudioFormat?format)` * `QAudioFormat preferredFormat (self)` * `list-of-QAudioFormat.Endian supportedByteOrders (self)` * `list-of-int supportedChannelCounts (self)` * `list-of-int supportedChannels (self)` * `QStringList supportedCodecs (self)` * `list-of-int supportedFrequencies (self)` * `list-of-int supportedSampleRates (self)` * `list-of-int supportedSampleSizes (self)` * `list-of-QAudioFormat.SampleType supportedSampleTypes (self)` ### Static Methods * `list-of-QAudioDeviceInfo availableDevices (QAudio.Mode?mode)` * `QAudioDeviceInfo defaultInputDevice ()` * `QAudioDeviceInfo defaultOutputDevice ()` * * * ## Detailed Description 該QAudioDeviceInfo類提供查詢音頻設備及其功能的接口。 QAudioDeviceInfo讓您查詢的音頻設備 - 如聲卡和USB耳機 - 當前可用的系統上。可用的音頻設備都依賴安裝在平臺或音頻插件上。 您也可以查詢每個設備所支持的格式。在此上下文中的一種格式是一組由特定的字節順序，信道編解碼器，頻率，采樣率，和樣品的類型。的一種格式是由代表[QAudioFormat](qaudioformat.html)類。 由該設備為每一個參數所支持的值可以與提取[supportedByteOrders](qaudiodeviceinfo.html#supportedByteOrders)（ ）[supportedChannelCounts](qaudiodeviceinfo.html#supportedChannelCounts)（ ）[supportedCodecs](qaudiodeviceinfo.html#supportedCodecs)（ ）[supportedSampleRates](qaudiodeviceinfo.html#supportedSampleRates)（ ）[supportedSampleSizes](qaudiodeviceinfo.html#supportedSampleSizes)（）和[supportedSampleTypes](qaudiodeviceinfo.html#supportedSampleTypes)（ ） 。支持的組合是依賴于平臺，安裝音頻插件和音頻設備的能力上。如果你需要一個特定的格式，您可以檢查設備是否支持它[isFormatSupported](qaudiodeviceinfo.html#isFormatSupported)（ ） ，或者獲取一個支持的格式是盡可能接近的格式[nearestFormat](qaudiodeviceinfo.html#nearestFormat)（ ） 。例如： ``` [QAudioFormat](qaudioformat.html) format; format.setFrequency(44100); ... format.setSampleType([QAudioFormat](qaudioformat.html).SignedInt); QAudioDeviceInfo info(QAudioDeviceInfo.defaultOutputDevice()); if (!info.isFormatSupported(format)) format = info.nearestFormat(format); ``` 一個QAudioDeviceInfo所使用的Qt構建類與設備進行通信 - 如[QAudioInput](qaudioinput.html)和[QAudioOutput](qaudiooutput.html)。靜態函數[defaultInputDevice](qaudiodeviceinfo.html#defaultInputDevice)（ ）[defaultOutputDevice](qaudiodeviceinfo.html#defaultOutputDevice)（）和[availableDevices](qaudiodeviceinfo.html#availableDevices)（ ）讓你得到所有可用設備的列表。器件讀取根據mode的值，這是由指定的[QAudio.Mode](qaudio.html#Mode-enum)枚舉。該QAudioDeviceInfo返回僅適用于本[QAudio.Mode](qaudio.html#Mode-enum)。 例如： ``` foreach(const QAudioDeviceInfo &deviceInfo, QAudioDeviceInfo.availableDevices([QAudio](qaudio.html).AudioOutput)) qDebug() << "Device name: " << deviceInfo.deviceName(); ``` 在此代碼示例中，我們遍歷所有的都能夠輸出聲音，即設備，支持的格式播放音頻流。對于發現的每個設備，我們只需打印[deviceName](qaudiodeviceinfo.html#deviceName)（ ） 。 * * * ## Method Documentation ``` QAudioDeviceInfo.__init__ (self) ``` 構造一個空[QAudioDeviceInfo](qaudiodeviceinfo.html)對象。 ``` QAudioDeviceInfo.__init__ (self, QAudioDeviceInfo?other) ``` 構造的副本_other_。 ``` list-of-QAudioDeviceInfo QAudioDeviceInfo.availableDevices (QAudio.Mode?mode) ``` 返回支持的音頻設備列表_mode_。 ``` QAudioDeviceInfo QAudioDeviceInfo.defaultInputDevice () ``` [ 返回默認的輸入音頻設備的名稱。所有的平臺和音頻插件的實現提供了一個默認的音頻設備使用。 ](qaudiodeviceinfo.html) ``` QAudioDeviceInfo QAudioDeviceInfo.defaultOutputDevice () ``` [ 返回缺省輸出音頻設備的名稱。所有的平臺和音頻插件的實現提供了一個默認的音頻設備使用。 ``` QString QAudioDeviceInfo.deviceName (self) ``` 返回音頻設備的可讀名稱。 設備名稱具體取決于正在使用的平臺/音頻插件有所不同。 他們是一個唯一的字符串識別為音頻設備。 例如： 。默認情況下，英特爾， U0x46d0x9a4 ``` bool QAudioDeviceInfo.isFormatSupported (self, QAudioFormat?format) ``` ](qaudiodeviceinfo.html) [返回True如果_settings_通過這種音頻設備所支持](qaudiodeviceinfo.html)[QAudioDeviceInfo](qaudiodeviceinfo.html)。 ``` bool QAudioDeviceInfo.isNull (self) ``` 返回是否該[QAudioDeviceInfo](qaudiodeviceinfo.html)對象持有設備的定義。 ``` QAudioFormat QAudioDeviceInfo.nearestFormat (self, QAudioFormat?format) ``` [](qaudioformat.html) [最接近的回報](qaudioformat.html)[QAudioFormat](qaudioformat.html)至_settings_該系統的音頻支持。 由平臺/音頻插件被用來提供這些設置。 他們也都依賴于[QAudio.Mode](qaudio.html#Mode-enum)被使用。 ``` QAudioFormat QAudioDeviceInfo.preferredFormat (self) ``` [](qaudioformat.html) [Returns](qaudioformat.html) [QAudioFormat](qaudioformat.html)的默認設置。 由平臺/音頻插件被用來提供這些設置。 他們也都依賴于[QAudio.Mode](qaudio.html#Mode-enum)被使用。 一個典型的音響系統可以提供這樣的： * Input settings: 8000Hz mono 8 bit. * Output settings: 44100Hz stereo 16 bit little endian. ``` list-of-QAudioFormat.Endian QAudioDeviceInfo.supportedByteOrders (self) ``` 返回所支持的字節順序列表。 ``` list-of-int QAudioDeviceInfo.supportedChannelCounts (self) ``` 返回所支持的通道數的列表。 此功能被引入Qt的4.7 。 ``` list-of-int QAudioDeviceInfo.supportedChannels (self) ``` ``` QStringList QAudioDeviceInfo.supportedCodecs (self) ``` 返回所支持的編解碼器的列表。 所有的平臺和插件的實現應該對其提供支持： “音頻/ PCM ” - 線性PCM 對于編寫插件以支持更多的編解碼器是指： http://www.iana.org/assignments/media-types/audio/ ``` list-of-int QAudioDeviceInfo.supportedFrequencies (self) ``` ``` list-of-int QAudioDeviceInfo.supportedSampleRates (self) ``` 返回所支持的采樣率的清單。 此功能被引入Qt的4.7 。 ``` list-of-int QAudioDeviceInfo.supportedSampleSizes (self) ``` 返回支持的采樣大小的列表。 ``` list-of-QAudioFormat.SampleType QAudioDeviceInfo.supportedSampleTypes (self) ``` 返回支持的采樣類型的列表。