PlaySound()

Syntax

Ergebnis = PlaySound(#Sound [, Flags [, Lautstärke]])

Startet das Abspielen des angegebenen Sounds.

Parameter

#Sound	Der abzuspielende Sound.
Flags (optional)	Dies kann eine Kombination der folgenden Werte sein: 0 : kein Flag #PB_Sound_Loop : spielt den Sound kontinuierlich (startet ihn erneut, sobald das Ende erreicht ist) #PB_Sound_MultiChannel: spielt den Sound in einem neuen Kanal, anstelle den zuvor abgespielten Sound zu stoppen. Dies ermöglicht die Verwendung des gleichen Sounds und dessen gleichzeitiges Abspielen auf verschiedenen Kanälen. 'Ergebnis' wird dann der neu allokierte Kanal sein, und kann von den anderen Sound-Befehlen wie SoundVolume(), SoundPan(), etc. verwendet werden.
Lautstärke (optional)	Legt die anfängliche Lautstärke des #Sound fest. Die gültigen Werte liegen zwischen 0 (keine Lautstärke) und 100 (volle Lautstärke). Der Standardwert ist 100.

Rückgabewert

Die Kanal-Nummer, wenn das #PB_Sound_MultiChannel Flag verwendet wird.

Beispiel

  If InitSound()           ; Initialisieren des Sound-Systems
    UseOGGSoundDecoder()   ; Verwenden von Ogg-Dateien
    
    ; Lädt einen Sound aus einer Datei
    If LoadSound(0, #PB_Compiler_Home +"Examples/3D/Data/Siren.ogg")
      ; Der Sound wird abgespielt
      PlaySound(0, #PB_Sound_Loop, 20)
      
      MessageRequester("Info", "OK zum Stoppen.")
      
      FreeSound(0) ; Der Sound wird freigegeben
    EndIf
    End
  Else
    Debug "Warnung! Die Sound-Umgebung konnte nicht initialisiert werden. Daher können keine Sound-Befehle verwendet werden..."
  EndIf

Siehe auch

StopSound(), FreeSound(), PauseSound(), ResumeSound()

Unterstützte OS

Alle