Метод My.Computer.Audio.Play

Статья
11/05/2008

Обновлен: Ноябрь 2007

Воспроизведение звукового файла .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 _
)

Параметры

location
Строка String содержит имя звукового файла
data
Массив Byte, представляющий звуковой файл.
stream
Stream, представляющий звуковой файл.
playMode
Режим Перечисление AudioPlayMode для воспроизведения звука. По умолчанию — AudioPlayMode.Background.

Исключения

Следующие условия могут создать исключение.

Значением data или stream является Nothing, или location является пустой строкой (ArgumentNullException).
Аргумент playMode не является одним из значений Перечисление AudioPlayMode (InvalidEnumArgumentException).
Пользователь не имеет необходимых разрешений для доступа к файлу location (IOException).
Неправильный путь к файлу в location (DirectoryNotFoundException)
Путь к файлу в location имеет слишком большую длину (PathTooLongException)
В случае частичного доверия пользователь не имеет необходимых разрешений (SecurityException).

Заметки

Метод Play воспроизводит звуковой файл .wav, хранящийся в файле location в виде массива байтов в data или в виде потока в stream.

При использовании перегрузки, которая принимает только параметр location, метод Play воспроизводит звук в фоновом режиме. В противном случае способ воспроизведения звука определяется параметром playMode.

playMode	Описание
AudioPlayMode.Background	Воспроизводит звук в фоновом режиме. Вызывающий код продолжает выполнение.
AudioPlayMode.BackgroundLoop	Воспроизводит звук в фоновом режиме до тех пор, пока не будет вызван метод Метод My.Computer.Audio.Stop. Вызывающий код продолжает выполнение.
AudioPlayMode.WaitToComplete	Воспроизводит звук и ожидает его завершения, после чего продолжает выполнять вызывающий код.

Воспроизведение в фоновом режиме позволяет приложению выполнять другой код во время воспроизведения звука. Дополнительные сведения см. в разделах Практическое руководство. Циклическое воспроизведение звука в Visual Basic и Практическое руководство. Воспроизведение звука в Visual Basic.

Задачи

В приведенной ниже таблице показаны примеры задач, в которых используется метод My.Computer.Audio.Play.

Задача	См. разделы
Однократное воспроизведение звука	Практическое руководство. Воспроизведение звуков и ожидание завершения в Visual Basic
Многократное воспроизведение звука	Практическое руководство. Циклическое воспроизведение звука в Visual Basic
Воспроизведение звука в фоновом режиме	Практическое руководство. Воспроизведение звука в Visual Basic

Пример

Метод My.Computer.Audio.Play воспроизводит заданный звук в фоновом режиме при заданном значении PlayMode.Background.

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

Этот код может выполняться только в приложении Windows Forms.

Имя файла должно указывать на звуковой WAV-файл в системе.

Чтобы упростить управление звуковыми файлами, рекомендуется сохранять файлы в виде ресурсов приложения. Затем к ним можно будет обращаться с помощью объекта Объект My.Resources.

Требования

Пространство имен:Microsoft.VisualBasic.Devices

Класс:Audio

Сборка: библиотека времени выполнения Visual Basic (в Microsoft.VisualBasic.dll)

Доступность по типу проекта

Тип проекта	Доступность
Приложение Windows	Да
Библиотека классов	Да
Консольное приложение	Да
Библиотека элементов управления Windows	Да
Библиотека веб-элементов управления	Нет
Служба Windows	Да
Веб-узел	Нет

Разрешения

Могут потребоваться следующие разрешения.

Разрешение	Описание
FileIOPermission	Определяет возможность доступа к файлам и папкам. Связанное перечисление: Unrestricted.
SecurityPermission	Описывает набор разрешений безопасности, примененных к коду. Связанное перечисление: ControlThread.