Audio.Play Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Reproduz um arquivo de som .wav.
Sobrecargas
| Play(String) |
Reproduz um arquivo de som .wav. |
| Play(Byte[], AudioPlayMode) |
Reproduz um arquivo de som .wav. |
| Play(Stream, AudioPlayMode) |
Reproduz um arquivo de som .wav. |
| Play(String, AudioPlayMode) |
Reproduz um arquivo de som .wav. |
Play(String)
Reproduz um arquivo de som .wav.
public:
void Play(System::String ^ location);public void Play (string location);member this.Play : string -> unitPublic Sub Play (location As String)Parâmetros
- location
- String
Um String que contém o nome do arquivo de som.
Exceções
location é uma cadeia de caracteres vazia.
O usuário não tem permissões suficientes para acessar o arquivo nomeado por location.
O caminho do arquivo está mal formado em location.
O nome do caminho em location é muito longo.
Existe uma situação de confiança parcial na qual o usuário não tem as permissões necessárias.
Exemplos
O My.Computer.Audio.Play método reproduz o som especificado em segundo plano quando PlayMode.Background é especificado.
Sub PlayBackgroundSoundFile()
My.Computer.Audio.Play("C:\Waterfall.wav",
AudioPlayMode.WaitToComplete)
End Sub
Este exemplo de código só pode ser executado em um aplicativo Windows Forms.
O nome do arquivo deve fazer referência a um arquivo de som .wav em seu sistema.
Para simplificar o gerenciamento de seus arquivos de som, considere armazenar os arquivos como recursos de aplicativo. Em seguida, eles podem ser acessados por meio do My.Resources objeto .
Comentários
O Play método reproduz o arquivo de som .wav armazenado como um arquivo em location, como uma matriz de bytes no dataou como um fluxo no stream.
Se a sobrecarga que usa apenas o location parâmetro for usada, o Play método reproduzirá o som em segundo plano. Caso contrário, o playMode parâmetro determina como o som será reproduzido.
playMode |
Descrição |
|---|---|
AudioPlayMode.Background |
Reproduz o som em segundo plano. O código de chamada continua a ser executado. |
AudioPlayMode.BackgroundLoop |
Reproduz o som em segundo plano até que o Stop método seja chamado. O código de chamada continua a ser executado. |
AudioPlayMode.WaitToComplete |
Reproduz o som e aguarda até que ele seja concluído antes que o código de chamada continue. |
A reprodução em segundo plano permite que o aplicativo execute outro código enquanto o som é reproduzido.
Para obter mais informações, consulte Como reproduzir sons.
Disponibilidade por tipo de projeto
| Tipo de projeto | Disponível |
|---|---|
| Aplicativo do Windows | Sim |
| Biblioteca de Classes | Sim |
| Aplicativo do Console | Sim |
| Biblioteca de Controle do Windows | Sim |
| Biblioteca de Controles da Web | Não |
| Serviço do Windows | Sim |
| Site | Não |
Confira também
Aplica-se a
Play(Byte[], AudioPlayMode)
Reproduz um arquivo de som .wav.
public:
void Play(cli::array <System::Byte> ^ data, Microsoft::VisualBasic::AudioPlayMode playMode);public void Play (byte[] data, Microsoft.VisualBasic.AudioPlayMode playMode);member this.Play : byte[] * Microsoft.VisualBasic.AudioPlayMode -> unitPublic Sub Play (data As Byte(), playMode As AudioPlayMode)Parâmetros
- data
- Byte[]
Matriz Byte que representa o arquivo de som.
- playMode
- AudioPlayMode
O modo AudioPlayMode de reprodução do som. Por padrão, AudioPlayMode.Background.
Exceções
data é Nothing.
playMode não é um dos valores de enumeração AudioPlayMode.
Existe uma situação de confiança parcial na qual o usuário não tem as permissões necessárias.
Exemplos
O My.Computer.Audio.Play método reproduz o som especificado em segundo plano quando PlayMode.Background é especificado.
Sub PlayBackgroundSoundFile()
My.Computer.Audio.Play("C:\Waterfall.wav",
AudioPlayMode.WaitToComplete)
End Sub
Este exemplo de código só pode ser executado em um aplicativo Windows Forms.
O nome do arquivo deve fazer referência a um arquivo de som .wav em seu sistema.
Para simplificar o gerenciamento de seus arquivos de som, considere armazenar os arquivos como recursos de aplicativo. Em seguida, eles podem ser acessados por meio do My.Resources objeto .
Comentários
O Play método reproduz o arquivo de som .wav armazenado como um arquivo em location, como uma matriz de bytes no dataou como um fluxo no stream.
Se a sobrecarga que usa apenas o location parâmetro for usada, o Play método reproduzirá o som em segundo plano. Caso contrário, o playMode parâmetro determina como o som será reproduzido.
playMode |
Descrição |
|---|---|
AudioPlayMode.Background |
Reproduz o som em segundo plano. O código de chamada continua a ser executado. |
AudioPlayMode.BackgroundLoop |
Reproduz o som em segundo plano até que o Stop método seja chamado. O código de chamada continua a ser executado. |
AudioPlayMode.WaitToComplete |
Reproduz o som e aguarda até que ele seja concluído antes que o código de chamada continue. |
A reprodução em segundo plano permite que o aplicativo execute outro código enquanto o som é reproduzido.
Para obter mais informações, consulte Como reproduzir sons.
Disponibilidade por tipo de projeto
| Tipo de projeto | Disponível |
|---|---|
| Aplicativo do Windows | Sim |
| Biblioteca de Classes | Sim |
| Aplicativo do Console | Sim |
| Biblioteca de Controle do Windows | Sim |
| Biblioteca de Controles da Web | Não |
| Serviço do Windows | Sim |
| Site | Não |
Confira também
Aplica-se a
Play(Stream, AudioPlayMode)
Reproduz um arquivo de som .wav.
public:
void Play(System::IO::Stream ^ stream, Microsoft::VisualBasic::AudioPlayMode playMode);public void Play (System.IO.Stream stream, Microsoft.VisualBasic.AudioPlayMode playMode);member this.Play : System.IO.Stream * Microsoft.VisualBasic.AudioPlayMode -> unitPublic Sub Play (stream As Stream, playMode As AudioPlayMode)Parâmetros
- playMode
- AudioPlayMode
O modo AudioPlayMode de reprodução do som. Por padrão, AudioPlayMode.Background.
Exceções
stream é Nothing.
playMode não é um dos valores de enumeração AudioPlayMode.
Existe uma situação de confiança parcial na qual o usuário não tem as permissões necessárias.
Exemplos
O My.Computer.Audio.Play método reproduz o som especificado em segundo plano quando PlayMode.Background é especificado.
Sub PlayBackgroundSoundFile()
My.Computer.Audio.Play("C:\Waterfall.wav",
AudioPlayMode.WaitToComplete)
End Sub
Este exemplo de código só pode ser executado em um aplicativo Windows Forms.
O nome do arquivo deve fazer referência a um arquivo de som .wav em seu sistema.
Para simplificar o gerenciamento de seus arquivos de som, considere armazenar os arquivos como recursos de aplicativo. Em seguida, eles podem ser acessados por meio do My.Resources objeto .
Comentários
O Play método reproduz o arquivo de som .wav armazenado como um arquivo em location, como uma matriz de bytes no dataou como um fluxo no stream.
Se a sobrecarga que usa apenas o location parâmetro for usada, o Play método reproduzirá o som em segundo plano. Caso contrário, o playMode parâmetro determina como o som será reproduzido.
playMode |
Descrição |
|---|---|
AudioPlayMode.Background |
Reproduz o som em segundo plano. O código de chamada continua a ser executado. |
AudioPlayMode.BackgroundLoop |
Reproduz o som em segundo plano até que o Stop método seja chamado. O código de chamada continua a ser executado. |
AudioPlayMode.WaitToComplete |
Reproduz o som e aguarda até que ele seja concluído antes que o código de chamada continue. |
A reprodução em segundo plano permite que o aplicativo execute outro código enquanto o som é reproduzido.
Para obter mais informações, consulte Como reproduzir sons.
Disponibilidade por tipo de projeto
| Tipo de projeto | Disponível |
|---|---|
| Aplicativo do Windows | Sim |
| Biblioteca de Classes | Sim |
| Aplicativo do Console | Sim |
| Biblioteca de Controle do Windows | Sim |
| Biblioteca de Controles da Web | Não |
| Serviço do Windows | Sim |
| Site | Não |
Confira também
Aplica-se a
Play(String, AudioPlayMode)
Reproduz um arquivo de som .wav.
public:
void Play(System::String ^ location, Microsoft::VisualBasic::AudioPlayMode playMode);public void Play (string location, Microsoft.VisualBasic.AudioPlayMode playMode);member this.Play : string * Microsoft.VisualBasic.AudioPlayMode -> unitPublic Sub Play (location As String, playMode As AudioPlayMode)Parâmetros
- location
- String
Um String que contém o nome do arquivo de som.
- playMode
- AudioPlayMode
O modo AudioPlayMode de reprodução do som. Por padrão, AudioPlayMode.Background.
Exceções
location é uma cadeia de caracteres vazia.
O usuário não tem permissões suficientes para acessar o arquivo nomeado por location.
O caminho do arquivo está mal formado em location.
O nome do caminho em location é muito longo.
playMode não é um dos valores de enumeração AudioPlayMode.
Existe uma situação de confiança parcial na qual o usuário não tem as permissões necessárias.
Exemplos
O My.Computer.Audio.Play método reproduz o som especificado em segundo plano quando PlayMode.Background é especificado.
Sub PlayBackgroundSoundFile()
My.Computer.Audio.Play("C:\Waterfall.wav",
AudioPlayMode.WaitToComplete)
End Sub
Este exemplo de código só pode ser executado em um aplicativo Windows Forms.
O nome do arquivo deve fazer referência a um arquivo de som .wav em seu sistema.
Para simplificar o gerenciamento de seus arquivos de som, considere armazenar os arquivos como recursos de aplicativo. Em seguida, eles podem ser acessados por meio do My.Resources objeto .
Comentários
O Play método reproduz o arquivo de som .wav armazenado como um arquivo em location, como uma matriz de bytes no dataou como um fluxo no stream.
Se a sobrecarga que usa apenas o location parâmetro for usada, o Play método reproduzirá o som em segundo plano. Caso contrário, o playMode parâmetro determina como o som será reproduzido.
playMode |
Descrição |
|---|---|
AudioPlayMode.Background |
Reproduz o som em segundo plano. O código de chamada continua a ser executado. |
AudioPlayMode.BackgroundLoop |
Reproduz o som em segundo plano até que o Stop método seja chamado. O código de chamada continua a ser executado. |
AudioPlayMode.WaitToComplete |
Reproduz o som e aguarda até que ele seja concluído antes que o código de chamada continue. |
A reprodução em segundo plano permite que o aplicativo execute outro código enquanto o som é reproduzido.
Para obter mais informações, consulte Como reproduzir sons.
Disponibilidade por tipo de projeto
| Tipo de projeto | Disponível |
|---|---|
| Aplicativo do Windows | Sim |
| Biblioteca de Classes | Sim |
| Aplicativo do Console | Sim |
| Biblioteca de Controle do Windows | Sim |
| Biblioteca de Controles da Web | Não |
| Serviço do Windows | Sim |
| Site | Não |
Confira também
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de