Método My.Computer.Audio.Play

Artigo
08/25/2010

Reproduz um arquivo de som .wav.

' Usage
My.Computer.Audio.Play(location)
My.Computer.Audio.Play(location ,playMode)
My.Computer.Audio.Play(data ,playMode)
My.Computer.Audio.Play(stream ,playMode)
' Declaration
Public Sub Play( _
   ByVal location As String _
)
' -or-
Public Sub Play( _
   ByVal location As String, _
   ByVal playMode As AudioPlayMode _
)
' -or-
Public Sub Play( _
   ByVal data As Byte(), _
   ByVal playMode As AudioPlayMode _
)
' -or-
Public Sub Play( _
   ByVal stream As System.IO.Stream, _
   ByVal playMode As AudioPlayMode _
)

Parâmetros

location
Uma String contendo o nome do arquivo de som
data
Matriz de Byte que representa o arquivo de som.
stream
Stream que representa o arquivo de som.
playMode
Modo Enumeração AudioPlayMode de reprodução do som.Por padrão, AudioPlayMode.Background.

Exceções

As condições a seguir podem causar uma exceção:

O data ou stream é Nothing, ou locationé uma sequência de caracteres vazia (ArgumentNullException).
O argumento playMode não é um dos valores Enumeração AudioPlayMode (InvalidEnumArgumentException).
O usuário não tem permissões suficientes para acessar o arquivo chamado por location (IOException).
O caminho do arquivo está malformado em location (DirectoryNotFoundException)
O nome do caminho em location é muito longo (PathTooLongException)
Uma situação na qual há confiança parcial e o usuário não possui permissões necessárias (SecurityException).

Comentários

O método Play executa o arquivo de som .wav armazenado como um arquivo em location, como um matriz de bytes no data, ou como um fluxo no stream.

Se a sobrecarga que utiliza apenas o parâmetro location for usada, o método Play toca o som no plano de fundo.Caso contrário, o parâmetro playMode determina como o som será reproduzido.

playMode	Descrição
AudioPlayMode.Background	Toca o som no plano de fundo.O código chamador continua a executar.
AudioPlayMode.BackgroundLoop	Toca o som no plano de fundo até que o Método My.Computer.Audio.Stop seja chamado.O código chamador continua a executar.
AudioPlayMode.WaitToComplete	Reproduz o som e espera até que ele seja concluído antes do código chamador continuar.

Reproduzir no segundo plano permite o aplicativo executar outro código enquanto o som é tocado.Para obter mais informações, consulte Como: Executar o loop Sounds in Visual Basic e Como: Tocar sons no Visual Basic.

Tarefas

A tabela a seguir lista exemplos de tarefas envolvendo o método My.Computer.Audio.Play.

Para	Consulte
Tocar um som uma vez	Como: Tocar sons e Wait For Completion in Visual Basic
Tocar um som várias vezes.	Como: Executar o loop Sounds in Visual Basic
Tocar um som no plano de fundo.	Como: Tocar sons no Visual Basic

Exemplo

O método My.Computer.Audio.Play toca o som especificado em segundo plano quando PlayMode.Background é especificado.

Sub PlayBackgroundSoundFile()
    My.Computer.Audio.Play("C:\Waterfall.wav", _
        AudioPlayMode.Background)
End Sub

Este exemplo de código pode ser executado somente dentro de um aplicativo Windows Forms.

O nome do arquivo deve referenciar um arquivo de som .WAV em seu sistema.

Para simplificar o gerenciamento de seus arquivos de som, considere armazenar os arquivos como recursos do aplicativo.Eles podem então ser acessados por meio de Objeto My.Resources.

Requisitos

Namespace:Microsoft.VisualBasic.Devices

Classe:Audio

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Sim
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controle da Web	Não
Serviço do Windows	Sim
Site	Não

Permissões

As seguintes permissões podem ser necessárias:

Permissão	Descrição
FileIOPermission	Controla a habilidade de acesso a arquivos e pastas.Enumeração associada: Unrestricted.
SecurityPermission	Descreve uma série de permissões de seguranças aplicadas ao código.Enumeração associada: ControlThread.