My.Computer.Audio.Play (Método)

Artículo
08/23/2008

Actualización: noviembre 2007

Reproduce un archivo de sonido .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
String que contiene el nombre del archivo de sonido
data
Matriz Byte que representa el archivo de sonido.
stream
Stream que representa el archivo de sonido.
playMode
Modo AudioPlayMode (Enumeración) de reproducción del sonido. De forma predeterminada, es AudioPlayMode.Background.

Excepciones

Las circunstancias siguientes pueden provocar una excepción:

data o stream es Nothing, o location es una cadena vacía (ArgumentNullException).
El argumento playMode no es ninguno de los valores de AudioPlayMode (Enumeración) (InvalidEnumArgumentException).
El usuario no tiene permisos suficientes para el acceso al archivo cuyo nombre va especificado por location (IOException).
La ruta de acceso del archivo es incorrecta en location (DirectoryNotFoundException)
El nombre de la ruta de acceso de location es demasiado largo (PathTooLongException)
Hay una situación de confianza parcial en la que el usuario no dispone de los permisos necesarios (SecurityException).

Comentarios

El método Play reproduce el archivo de sonido .wav almacenado como un archivo en la ubicación location, como una matriz de bytes en data, o como secuencia en stream.

Si se utiliza la sobrecarga que toma sólo el parámetro location, el método Play reproduce el sonido en segundo plano. De lo contrario, el parámetro playMode determina cómo se reproducirá el sonido.

playMode	Descripción
AudioPlayMode.Background	Reproduce el sonido en segundo plano. El código de llamada continúa ejecutándose.
AudioPlayMode.BackgroundLoop	Reproduce el sonido en segundo plano hasta que se llame a My.Computer.Audio.Stop (Método). El código de llamada continúa ejecutándose.
AudioPlayMode.WaitToComplete	Reproduce el sonido y espera hasta que finalice antes de continuar el código de llamada.

La reproducción en segundo plano permite que la aplicación ejecute otro código mientras se reproduce el sonido. Para obtener más información, vea Cómo: Reproducir sonidos en bucle en Visual Basic y Cómo: Reproducir sonidos en Visual Basic.

Tareas

La tabla siguiente muestra una lista de ejemplos de tareas en las que está implicado el método My.Computer.Audio.Play.

Para	Vea
Reproducir un sonido una vez	Cómo: Reproducir sonidos y esperar a que finalicen en Visual Basic
Reproducir un sonido muchas veces	Cómo: Reproducir sonidos en bucle en Visual Basic
Reproducir un sonido en segundo plano	Cómo: Reproducir sonidos en Visual Basic

Ejemplo

El método My.Computer.Audio.Play reproduce el sonido especificado en segundo plano cuando se especifica PlayMode.Background.

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

Este ejemplo de código sólo se puede ejecutar en una aplicación de Windows Forms.

El nombre de archivo debe hacer referencia a un archivo de sonido .wav almacenado en el sistema.

Para simplificar la administración de sus archivos de sonido, considere almacenar los archivos como recursos de aplicación. Así se puede tener acceso a ellos a través de My.Resources (Objeto).

Requisitos

Espacio de nombres:Microsoft.VisualBasic.Devices

Clase:Audio

Ensamblado: biblioteca en tiempo de ejecución de Visual Basic (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Tipo de proyecto	Disponible
Aplicación para Windows	Sí
Biblioteca de clases	Sí
Aplicación de consola	Sí
Biblioteca de controles de Windows	Sí
Biblioteca de controles Web	No
Servicio de Windows	Sí
Sitio Web	No

Permisos

Los permisos siguientes pueden ser necesarios:

Permiso	Descripción
FileIOPermission	Controla la capacidad de tener acceso a archivos y carpetas. Enumeración asociada: Unrestricted.
SecurityPermission	Describe un conjunto de permisos de seguridad aplicados al código. Enumeración asociada: ControlThread.