Home · All Classes · Modules · QSS HELP · QSS 案例 · VER007 HOME

QAudioDeviceInfo Class Reference
^{^{[QtMultimedia module]}}

该QAudioDeviceInfo类提供查询音频设备及其功能的接口。More...

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类。

由该设备为每一个参数所支持的值可以与提取supportedByteOrders（）supportedChannelCounts（）supportedCodecs（）supportedSampleRates（）supportedSampleSizes（）和supportedSampleTypes（）。支持的组合是依赖于平台，安装音频插件和音频设备的能力上。如果你需要一个特定的格式，您可以检查设备是否支持它isFormatSupported（），或者获取一个支持的格式是尽可能接近的格式nearestFormat（）。例如：

         QAudioFormat format;
         format.setFrequency(44100);
         ...
         format.setSampleType(QAudioFormat.SignedInt);

         QAudioDeviceInfo info(QAudioDeviceInfo.defaultOutputDevice());

         if (!info.isFormatSupported(format))
             format = info.nearestFormat(format);

一个QAudioDeviceInfo所使用的Qt构建类与设备进行通信 - 如QAudioInput和QAudioOutput。静态函数defaultInputDevice（）defaultOutputDevice（）和availableDevices（）让你得到所有可用设备的列表。器件读取根据mode的值，这是由指定的QAudio.Mode枚举。该QAudioDeviceInfo返回仅适用于本QAudio.Mode。

例如：

 foreach(const QAudioDeviceInfo &deviceInfo, QAudioDeviceInfo.availableDevices(QAudio.AudioOutput))
     qDebug() << "Device name: " << deviceInfo.deviceName();

在此代码示例中，我们遍历所有的都能够输出声音，即设备，支持的格式播放音频流。对于发现的每个设备，我们只需打印deviceName（）。

Method Documentation

QAudioDeviceInfo.init (self)

构造一个空QAudioDeviceInfo对象。

QAudioDeviceInfo.init (self, QAudioDeviceInfo other)

构造的副本other。

list-of-QAudioDeviceInfo QAudioDeviceInfo.availableDevices (QAudio.Mode mode)

返回支持的音频设备列表mode。

QAudioDeviceInfo QAudioDeviceInfo.defaultInputDevice ()

返回默认的输入音频设备的名称。所有的平台和音频插件的实现提供了一个默认的音频设备使用。

QAudioDeviceInfo QAudioDeviceInfo.defaultOutputDevice ()

返回缺省输出音频设备的名称。所有的平台和音频插件的实现提供了一个默认的音频设备使用。

QString QAudioDeviceInfo.deviceName (self)

返回音频设备的可读名称。

设备名称具体取决于正在使用的平台/音频插件有所不同。

他们是一个唯一的字符串识别为音频设备。

例如：。默认情况下，英特尔， U0x46d0x9a4

bool QAudioDeviceInfo.isFormatSupported (self, QAudioFormat format)

返回True如果settings通过这种音频设备所支持QAudioDeviceInfo。

bool QAudioDeviceInfo.isNull (self)

返回是否该QAudioDeviceInfo对象持有设备的定义。

QAudioFormat QAudioDeviceInfo.nearestFormat (self, QAudioFormat format)

最接近的回报QAudioFormat至settings该系统的音频支持。

由平台/音频插件被用来提供这些设置。

他们也都依赖于QAudio.Mode被使用。

QAudioFormat QAudioDeviceInfo.preferredFormat (self)

Returns QAudioFormat的默认设置。

由平台/音频插件被用来提供这些设置。

他们也都依赖于QAudio.Mode被使用。

一个典型的音响系统可以提供这样的：

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)

返回所支持的采样率的清单。