QAudioDeviceInfo 類提供查詢音頻設備及其功能的接口。 更多...
| 頭： | #include <QAudioDeviceInfo> |
| qmake: | QT += multimedia |
| QAudioDeviceInfo (const QAudioDeviceInfo & other ) | |
| QAudioDeviceInfo () | |
| QAudioDeviceInfo & | operator= (const QAudioDeviceInfo & other ) |
| ~QAudioDeviceInfo () | |
| QString | deviceName () const |
| bool | isFormatSupported (const QAudioFormat & settings ) const |
| bool | isNull () const |
| QAudioFormat | nearestFormat (const QAudioFormat & settings ) const |
| QAudioFormat | preferredFormat () const |
| QString | realm () const |
| QList<QAudioFormat::Endian> | supportedByteOrders () const |
| QList<int> | supportedChannelCounts () const |
| QStringList | supportedCodecs () const |
| QList<int> | supportedSampleRates () const |
| QList<int> | supportedSampleSizes () const |
| QList<QAudioFormat::SampleType> | supportedSampleTypes () const |
| bool | operator!= (const QAudioDeviceInfo & other ) const |
| bool | operator== (const QAudioDeviceInfo & other ) const |
| QList<QAudioDeviceInfo> | availableDevices (QAudio::Mode mode ) |
| QAudioDeviceInfo | defaultInputDevice () |
| QAudioDeviceInfo | defaultOutputDevice () |
QAudioDeviceInfo lets you query for audio devices--such as sound cards and USB headsets--that are currently available on the system. The audio devices available are dependent on the platform or audio plugins installed.
A QAudioDeviceInfo is used by Qt to construct classes that communicate with the device--such as QAudioInput ，和 QAudioOutput .
You can also query each device for the formats it supports. A format in this context is a set consisting of a specific byte order, channel, codec, frequency, sample rate, and sample type. A format is represented by the QAudioFormat 類。
The values supported by the device for each of these parameters can be fetched with supportedByteOrders (), supportedChannelCounts (), supportedCodecs (), supportedSampleRates (), supportedSampleSizes ()，和 supportedSampleTypes (). The combinations supported are dependent on the platform, audio plugins installed and the audio device capabilities. If you need a specific format, you can check if the device supports it with isFormatSupported (), or fetch a supported format that is as close as possible to the format with nearestFormat (). For instance:
QAudioFormat format; format.setSampleRate(44100); // ... other format parameters format.setSampleType(QAudioFormat::SignedInt); QAudioDeviceInfo info(QAudioDeviceInfo::defaultOutputDevice()); if (!info.isFormatSupported(format)) format = info.nearestFormat(format);
靜態函數 defaultInputDevice (), defaultOutputDevice ()，和 availableDevices () let you get a list of all available devices. Devices are fetched according to the value of mode this is specified by the QAudio ::Mode enum. The QAudioDeviceInfo returned are only valid for the QAudio ::Mode.
例如：
const auto deviceInfos = QAudioDeviceInfo::availableDevices(QAudio::AudioOutput); for (const QAudioDeviceInfo &deviceInfo : deviceInfos) qDebug() << "Device name: " << deviceInfo.deviceName();
In this code sample, we loop through all devices that are able to output sound, i.e., play an audio stream in a supported format. For each device we find, we simply print the deviceName ().
另請參閱 QAudioOutput and QAudioInput .
構造副本為 other .
構造空的 QAudioDeviceInfo 對象。
設置 QAudioDeviceInfo 對象等於 other .
銷毀此音頻設備信息。
[static]
QList
<
QAudioDeviceInfo
> QAudioDeviceInfo::
availableDevices
(
QAudio::Mode
mode
)
返迴的音頻設備列錶支持 mode .
[static]
QAudioDeviceInfo
QAudioDeviceInfo::
defaultInputDevice
()
返迴默認輸入音頻設備的信息。所有平颱和音頻插件實現均提供要使用的默認音頻設備。
[static]
QAudioDeviceInfo
QAudioDeviceInfo::
defaultOutputDevice
()
返迴默認輸齣音頻設備的信息。所有平颱和音頻插件實現均提供要使用的默認音頻設備。
返迴音頻設備的人類可讀名稱。
設備名稱從屬所使用的平颱/音頻插件。
它們是音頻設備的唯一字符串標識符。
如 default, Intel, U0x46d0x9a4
返迴 true 若供給 settings are supported by the audio device described by this QAudioDeviceInfo .
返迴是否此 QAudioDeviceInfo object holds a valid device definition.
Returns the closest QAudioFormat to the supplied settings that the system supports.
These settings are provided by the platform/audio plugin being used.
They are also dependent on the QAudio ::Mode being used.
Returns the default audio format settings for this device.
These settings are provided by the platform/audio plugin being used.
They are also dependent on the QAudio ::Mode being used.
A typical audio system would provide something like:
Returns the key that represents the audio plugin.
該函數在 Qt 5.14 引入。
另請參閱 QAudioSystemPlugin .
返迴支持的字節序列錶。
Returns a list of supported channel counts.
This is typically 1 for mono sound, or 2 for stereo sound.
返迴支持的編解碼器列錶。
所有平颱和插件實現都應提供支持：
audio/pcm - 綫性 PCM
編寫插件以支持額外編解碼器，參考：
http://www.iana.org/assignments/media-types/audio/
返迴支持的采樣率的列錶 (以赫茲為單位)。
返迴支持的采樣大小的列錶 (以位為單位)。
通常這將包括 8 位和 16 位的采樣大小。
Returns a list of supported sample types.
返迴 true，若此 QAudioDeviceInfo class represents a different audio device than other
返迴 true，若此 QAudioDeviceInfo class represents the same audio device as other .