# QSound Class Reference ## [[QtGui](index.htm) module] 該QSound的類提供了訪問平臺的音頻設備。[More...](#details) 繼承[QObject](qobject.html)。 ### Methods * `__init__ (self, QString?filename, QObject?parent?=?None)` * `QString fileName (self)` * `bool isFinished (self)` * `int loops (self)` * `int loopsRemaining (self)` * `play (self)` * `setLoops (self, int)` * `stop (self)` ### Static Methods * `bool isAvailable ()` * `play (QString?filename)` * * * ## Detailed Description 該QSound的類提供了訪問平臺的音頻設備。 Qt提供了最常用的音頻需要在運行GUI應用程序：異步播放聲音文件。這是通過使用靜態最容易實現[play](qsound.html#play)（ ）函數： ``` QSound.play("mysounds/bells.wav"); ``` 另外，從聲音文件首先創建一個QSound的對象，然后調用[play](qsound.html#play)（）槽： ``` QSound bells("mysounds/bells.wav"); bells.play(); ``` 一旦創建了QSound的對象可以查詢其[fileName](qsound.html#fileName)（）和總數[loops](qsound.html#loops)（） （即次數聲音的播放方式） 。重復的次數可以使用被改變的[setLoops](qsound.html#setLoops)（）函數。當演奏聲中，[loopsRemaining](qsound.html#loopsRemaining)（）函數返回重復的剩馀數量。使用[isFinished](qsound.html#isFinished)（ ）函數來確定聲音是否已經播放完畢。 使用QSound的對象可能會使用更多的內存比靜態的聲音發揮[play](qsound.html#play)（ ）函數，但它也可能更立即播放（取決于底層平臺的音頻設備） 。使用靜態[isAvailable](qsound.html#isAvailable)（ ）函數來確定是否在該平臺上存在的音響設備。這是實際使用的設備各不相同： | Platform | Audio Facility | | --- | --- | | Microsoft Windows | The underlying multimedia system is used; only WAVE format sound files are supported. | | X11 | The [resources](http://pyqt4doc.appspot.com/resources.html)。這可能會在將來的版本的Qt 。 * * * ## Method Documentation ``` QSound.__init__ (self, QString?filename, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個[QSound](qsound.html)由給定的所指定的文件中的對象_filename_并用給定的_parent_。這可能會使用更多的內存比靜態[play](qsound.html#play)（ ）函數，但它也可能更立即播放（取決于底層平臺的音頻設備） 。**See also** [play](qsound.html#play)（ ） 。 ``` QString QSound.fileName (self) ``` 返回與此相關聯的文件名[QSound](qsound.html)對象。**See also** [QSound](qsound.html#QSound)（ ） 。 ``` bool QSound.isAvailable () ``` 返回True如果平臺上存在的音響設備，否則返回False 。如果沒有健全的可用，所有[QSound](qsound.html)操作默默工作，迅速。應用程序可以選擇要么通知用戶，如果聲音是至關重要的應用程序，或在后臺運行而不打擾用戶。注意：在Windows這個總是因為一些聲卡驅動沒有實現的方式，找出它是否適用或不返回True 。 ``` bool QSound.isFinished (self) ``` 返回True如果聲音播放完畢，否則返回False 。**Warning:**在Windows中這個函數總是不成圈的聲音返回True 。 ``` int QSound.loops (self) ``` 返回的時候聲音會玩的次數。**See also** [loopsRemaining](qsound.html#loopsRemaining)（）和[setLoops](qsound.html#setLoops)（ ） 。 ``` int QSound.loopsRemaining (self) ``` 返回剩馀次數的聲音將循環（這個值每個聲音被播放的時間減少）。**See also** [loops](qsound.html#loops)（）和[isFinished](qsound.html#isFinished)（ ） 。 ``` QSound.play (QString?filename) ``` 播放聲音存儲由給定指定的文件中_filename_。**See also** [stop](qsound.html#stop)（ ）[loopsRemaining](qsound.html#loopsRemaining)（）和[isFinished](qsound.html#isFinished)（ ） 。 ``` QSound.play (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void play()`。這是一個重載函數。開始播放由這個指定的聲音[QSound](qsound.html)對象。該函數立即返回。根據平臺的音頻設備，其他聲音可能會停止或與新的聲音混合。聲音可以再次在任何時間進行播放，可能混合或替換的聲音以前次。**See also** [fileName](qsound.html#fileName)（ ） 。 ``` QSound.setLoops (self, int) ``` 設置重復給出的聲音_number_當它被播放的時間。注意，傳遞的值-1會導致聲音無限循環。**See also** [loops](qsound.html#loops)（ ） 。 ``` QSound.stop (self) ``` 這種方法也是一個Qt槽與C + +的簽名`void stop()`。停止播放聲音。請注意，在Windows上的電流回路將完成，如果一個播放聲音在一個循環。**See also** [play](qsound.html#play)（ ） 。 |