Freigeben über


SoundPlayer.Play Methode

Definition

Lädt zunächst die WAV-Datei, sofern sie nicht bereits geladen ist, und gibt sie mithilfe eines neuen Threads wieder.

public:
 void Play();
public void Play ();
member this.Play : unit -> unit
Public Sub Play ()

Ausnahmen

Die beim Ladevorgang verstrichene Zeit übersteigt die vom LoadTimeout angegebene Zeitspanne (in Millisekunden).

Die durch SoundLocation angegebene Datei kann nicht gefunden werden.

Der WAV-Header ist fehlerhaft; die durch die SoundLocation angegebene Datei ist keine PCM-WAV-Datei.

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung der Play -Methode zum asynchronen Wiedergeben einer .wav-Datei. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die SoundPlayer-Klasse bereitgestellt wird.

ReportStatus( "Playing .wav file asynchronously." );
player->Play();
ReportStatus("Playing .wav file asynchronously.");
player.Play();
ReportStatus("Playing .wav file asynchronously.")
player.Play()

Hinweise

Die Play -Methode gibt den Sound mithilfe eines neuen Threads ab. Wenn Sie aufrufen Play , bevor die .wav-Datei in den Arbeitsspeicher geladen wurde, wird die .wav Datei geladen, bevor die Wiedergabe beginnt. Sie können die LoadAsync - oder Load -Methode verwenden, um die .wav-Datei im Voraus in den Arbeitsspeicher zu laden. Nachdem eine .wav Datei erfolgreich aus einer Stream ODER URL geladen wurde, müssen zukünftige Aufrufe von Wiedergabemethoden für die SoundPlayer die .wav-Datei erst erneut geladen werden, wenn sich der Pfad für den Sound ändert.

Wenn die .wav Datei nicht angegeben wurde oder nicht geladen werden kann, gibt die Play Methode den Standardtonton ab.

Gilt für:

Weitere Informationen