Compartilhar via


Método My.Computer.Audio.Play

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:

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.

Para obter mais informações, consulte Segurança de Acesso de código e Solicitando permissões.

Consulte também

Tarefas

Como: Tocar sons e Wait For Completion in Visual Basic

Como: Executar o loop Sounds in Visual Basic

Como: Tocar sons no Visual Basic

Referência

Objeto My.Computer.Audio

Método My.Computer.Audio.Stop

Enumeração AudioPlayMode

System.IO.Stream

Audio.Play