10.QT-QAudioOutput类使用

2020-09-14 13:53:31 浏览数 (1)

本章需要用到的类如下:

  • QAudioDeviceInfo类提供音频输出设备
  • QAudioFormat类提供音频参数设置
  • QAudioOutput类提供了用于将PCM原始音频数据发送到音频输出设备的接口。

1.QAudioDeviceInfo类

用来提供音频输出设备,并且包含该设备支持的格式,排序,通道,编码器,频率,采样率等, 用户可以通过bool isFormatSupported(const QAudioFormat &settings) 来判断是否支持该格式.用户一般通过defaultOutputDevice()来获取当前默认播放设备.

如果想获取所有音频输出设备可以通过availableDevices()成员函数,比如:

代码语言:javascript复制
foreach(const QAudioDeviceInfo &deviceInfo, QAudioDeviceInfo::availableDevices(QAudio::AudioOutput))
{
     qDebug() << "Device name: " << deviceInfo.deviceName();
}    

2.QAudioOutput类

常用函数如下所示:

代码语言:javascript复制
QAudio::Error QAudioOutput::error(); //获取当前错误信息
void QAudioOutput::suspend(); //暂停
void QAudioOutput::resume(); //恢复
void QAudioOutput::start(QIODevice *device) //启动播放,参数是QIODevice(需要通过write成员写入pcm数据数组)

QIODevice *QAudioOutput::start(); //打开设备并返回一个指向内部QIODevice的指针,通过write()便可以直接向其写入pcm数据进行播放.
 
QAudio::State QAudioOutput::state(); //获取当前QAudioOutput状态,状态如下所示:
//QAudio::ActiveState:正在播放中
//QAudio::SuspendedState:正在暂停中
//QAudio::StoppedState:已被停止,可能是被异常终止了
//QAudio::IdleState:处于空闲中,什么都没干


void QAudioOutput::setVolume(qreal volume); //设置音量 (0.0~1.0之间,默认音量为1.0)
 

void QAudioOutput::setBufferSize(int value); //重新设置缓冲区大小,需要在start()之前设置

int QAudioOutput::bufferSize() const; //获取缓冲区大小,默认为35280,需要start()后,才分配buff

int QAudioOutput::bytesFree() //返回音频缓冲区中可用的空闲字节数。
//注意:返回值仅在QAudio::ActiveState或QAudio::IdleState状态下有效,否则返回零。


int QAudioOutput::periodSize(); //周期大小(以字节为单位),每播放一次音频数据所需多少个数据量
                    //periodSize用来防止缓冲区欠运行和确保不间断回放所需的数据量

3.初始化QAudioOutput

开始播放音频流只需使用QIODevice调用start()即可。然后QAudioOutput将从io设备中获取所需的数据。所以播放音频文件是简单的如下:

代码语言:javascript复制
QFile sourceFile;  
QAudioOutput* audio; 
sourceFile.setFileName("/tmp/test.raw");
sourceFile.open(QIODevice::ReadOnly);
 
QAudioFormat format;
// Set up the format, eg.
format.setSampleRate(44100); //设置采样率
format.setChannelCount(1); //设置通道数
format.setSampleSize(16); //样本数据16位
format.setCodec("audio/pcm"); //播出格式为pcm格式
format.setByteOrder(QAudioFormat::LittleEndian); //默认小端模式
format.setSampleType(QAudioFormat::UnSignedInt); //无符号整形数
 
QAudioDeviceInfo info(QAudioDeviceInfo::defaultOutputDevice()); //选择默认输出设备
 
if (!info.isFormatSupported(format))
{
qDebug()<<"输出设备不支持该格式,不能播放音频";
return;
}
 
audio = new QAudioOutput(format, this);
connect(audio, SIGNAL(stateChanged(QAudio::State)),this,SLOT(handleStateChanged(QAudio::State)));
 
audio->start(&sourceFile);
}

文件在播放过程中, 当遇到错误时,状态更改为QAudio::StoppedState,并发送stateChanged()信号函数,这时可以通过error()函数获取错误信息,注意:文件播放结束(QAudio::IdleState)后,需要停止设备:

代码语言:javascript复制
void AudioOutputExample::handleStateChanged(QAudio::State newState)
{
    switch (newState) {
        case QAudio::IdleState:
            // 数据已经没有了,播放完毕
            audio->stop();
            sourceFile.close();
            delete audio;
            break;
         
        case QAudio::StoppedState:
                // 音频设备已关闭,检查error是否异常关闭
                if (audio->error() != QAudio::NoError) {
                // Error handling
                }
                break;
         
        case QAudio::SuspendedState:
            // 音频被暂停
            break;
            
            
        case QAudio::ActiveState:
            // 启动音频播放,正在解析中
            break;
    }
}

4.补充说明

由于QAudioOutput支持的输入数据必须是原始数据,所以播放mp3,WAV,AAC等格式文件,需要解封装后才能支持播放.

而在QT中,提供了QMediaPlayer类可以支持解封装,但是该类的解码协议都是基于平台的,如果平台自身无法播放,那么QMediaPlayer也无法播放.有兴趣的朋友可以去试试.

所以接下来,我们使用ffmpeg QAudioOutput来实现一个简单的音频播放器

0 人点赞