主页 | 所有的类 | 主要的类 | 注释的类 | 分组的类 | 函数

QSound类参考

QSound提供对平台音频设备的访问。 详情请见……

#include <qsound.h>

继承了QObject。

所有成员函数的列表。

公有成员

• QSound ( const QString & filename, QObject * parent = 0, const char * name = 0 )
• ~QSound ()
• int loops () const
• int loopsRemaining () const
• void setLoops ( int l )
• QString fileName () const
• bool isFinished () const

公有槽

• void play ()
• void stop ()

静态公有成员

• bool isAvailable ()
• void play ( const QString & filename )
• bool available ()

详细描述

Qt提供了在大多数GUI应用程序中通常都需要的操作：异步播放声音文件。这用一个单呼叫就能简单的完成：

        QSound::play("mysounds/bells.wav");
    

第二个API是被用来根据一个声音文件创建一个QSound对象并且随后就播放它：

        QSound bells("mysounds/bells.wav");

        bells.play();
    

用以上第二种方式播放声音虽然也许会消耗更多的内存，但依靠底层平台的音频设备，比起第一种方式播放声音起来更直接。

在微软Windows下使用的底层多媒系统，仅支持WAVE格式的声音文件。

在X11下有效的使用了网络音频系统，另外所有的操作工作都在默默的进行着。NAS支持WAVE和AU文件。

有趣的是，在苹果机上，我们使用QT（QuickTime）来播放声音，这意思就是说所有的QuickTime格式被Qt/Mac所支持。

在Qt/Embedded中,使用了内建混声服务器，可以直接访问/dev/dsp。其仅仅可以支持WAVE格式。

用QSound::isAvailable()可以测试支持的声音。

也可以参考多媒体类。

成员函数文档

QSound::QSound ( const QString & filename, QObject * parent = 0, const char * name = 0 )

这也许会比静态函数play使用更多的内存。

父类parent和名称name的参数（默认为0）被传递给了QObject的构造函数。

QSound::~QSound ()

bool QSound::available () [静态]

如果可以有效的支持就返回真，否则返回假。

QString QSound::fileName () const

bool QSound::isAvailable () [静态]

如果没有有效的声音，所有的QSound操作工作安静且快速。

bool QSound::isFinished () const

int QSound::loops () const

int QSound::loopsRemaining () const

该函数在窗口下不支持并且总是返回循环的总数。

void QSound::play ( const QString & filename ) [静态]

实例：sound/sound.cpp。

void QSound::play () [槽]

开启声音播放。该数数立即返回。依靠平台的音频设备，其它的声音也许被停止，也许被新的声音混合。

在任何时候声音可以再次播放，可能混合或者替代先播放的声音。

void QSound::setLoops ( int l )

在Windows中, 不同于1的循环次数的声音将总是死循环。

也可以参考loops()。

void QSound::stop () [槽]

也可以参考play()。

这个文件是Qt工具包一部分。 版权所有 © 1995-2002 Trolltech。保留所有权利。