SoundPlayer.PlaySync Metoda

Definicja

Odtwarza plik WAV i najpierw ładuje plik WAV, jeśli nie został załadowany.Plays the .wav file and loads the .wav file first if it has not been loaded.

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

Wyjątki

Czas, który upłynął podczas ładowania, przekracza czas (w milisekundach) określony przez LoadTimeout .The elapsed time during loading exceeds the time, in milliseconds, specified by LoadTimeout.

Nie można znaleźć pliku określonego przez SoundLocation .The file specified by SoundLocation cannot be found.

Nagłówek. wav jest uszkodzony; plik określony przez SoundLocation nie jest plikiem PCM. wav.The .wav header is corrupted; the file specified by SoundLocation is not a PCM .wav file.

Przykłady

Poniższy przykład kodu demonstruje użycie PlaySync metody do synchronicznego odtwarzania pliku. wav.The following code example demonstrates the use of the PlaySync method to synchronously play a .wav file.

private:
   SoundPlayer^ Player;

   void loadSoundAsync()
   {
      // Note: You may need to change the location specified based on
      // the location of the sound to be played.
      this->Player->SoundLocation = "http://www.tailspintoys.com/sounds/stop.wav";
      this->Player->LoadAsync();
   }

   void Player_LoadCompleted( Object^ /*sender*/, System::ComponentModel::AsyncCompletedEventArgs^ /*e*/ )
   {
      if (this->Player->IsLoadCompleted == true)
      {
         this->Player->PlaySync();
      }
   }
private SoundPlayer Player = new SoundPlayer();
private void loadSoundAsync()
{
    // Note: You may need to change the location specified based on
    // the location of the sound to be played.
    this.Player.SoundLocation = "http://www.tailspintoys.com/sounds/stop.wav";
    this.Player.LoadAsync();
}

private void Player_LoadCompleted (
    object sender, 
    System.ComponentModel.AsyncCompletedEventArgs e)
{
    if (this.Player.IsLoadCompleted)
    {
        this.Player.PlaySync();
    }
}
Private WithEvents Player As New SoundPlayer

Sub LoadSoundAsync()
    ' Note: You may need to change the location specified based on
    ' the location of the sound to be played.
    Me.Player.SoundLocation = "http://www.tailspintoys.com/sounds/stop.wav"
    Me.Player.LoadAsync ()
End Sub

Private Sub PlayWhenLoaded(ByVal sender As Object, ByVal e As _
    System.ComponentModel.AsyncCompletedEventArgs) Handles _
    Player.LoadCompleted
    If Me.Player.IsLoadCompleted = True Then
            Me.Player.PlaySync()
    End If
End Sub

Uwagi

PlaySyncMetoda używa bieżącego wątku do odtwarzania pliku. wav, uniemożliwiając wątek do obsługi innych komunikatów do momentu zakończenia ładowania.The PlaySync method uses the current thread to play a .wav file, preventing the thread from handling other messages until the load is complete. Możesz użyć LoadAsync metody lub, Load Aby załadować plik WAV do wcześniejszej pamięci.You can use the LoadAsync or Load method to load the .wav file to memory in advance. Po pomyślnym załadowaniu pliku WAV z Stream adresu URL przyszłe wywołania metod odtwarzania dla programu SoundPlayer nie będą musiały ponownie załadować pliku. wav do momentu zmiany ścieżki dźwięku.After a .wav file is successfully loaded from a Stream or URL, future calls to playback methods for the SoundPlayer will not need to reload the .wav file until the path for the sound changes.

Jeśli plik. wav nie został określony lub nie można go załadować, PlaySync metoda spowoduje odtworzenie domyślnego dźwięku dźwiękowego.If the .wav file has not been specified or it fails to load, the PlaySync method will play the default beep sound.

Dotyczy

Zobacz też