Поделиться через


Audio.Play Метод

Определение

Воспроизведение звукового WAV-файла.

Перегрузки

Play(String)

Воспроизведение звукового WAV-файла.

Play(Byte[], AudioPlayMode)

Воспроизведение звукового WAV-файла.

Play(Stream, AudioPlayMode)

Воспроизведение звукового WAV-файла.

Play(String, AudioPlayMode)

Воспроизведение звукового WAV-файла.

Play(String)

Воспроизведение звукового WAV-файла.

public:
 void Play(System::String ^ location);
public void Play (string location);
member this.Play : string -> unit
Public Sub Play (location As String)

Параметры

location
String

Объект , String содержащий имя звукового файла.

Исключения

Параметр location равен пустой строке.

Пользователь не имеет необходимых разрешений для доступа к файлу по location.

Неправильный путь к файлу в location.

Путь в location имеет слишком большую длину.

В случае частичного доверия пользователь не имеет необходимых разрешений.

Примеры

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

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

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

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

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

Комментарии

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

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

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

Воспроизведение в фоновом режиме позволяет приложению выполнять другой код во время воспроизведения звуков.

Дополнительные сведения см. в разделе Воспроизведение звуков.

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

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

См. также раздел

Применяется к

Play(Byte[], AudioPlayMode)

Воспроизведение звукового 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 -> unit
Public Sub Play (data As Byte(), playMode As AudioPlayMode)

Параметры

data
Byte[]

Массив Byte представляет звуковой файл.

playMode
AudioPlayMode

Режим AudioPlayMode для воспроизведения звука. По умолчанию — AudioPlayMode.Background.

Исключения

data имеет значение Nothing.

Параметр playMode не совпадает ни с одним из значений перечисления AudioPlayMode.

В случае частичного доверия пользователь не имеет необходимых разрешений.

Примеры

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

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

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

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

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

Комментарии

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

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

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

Воспроизведение в фоновом режиме позволяет приложению выполнять другой код во время воспроизведения звуков.

Дополнительные сведения см. в разделе Воспроизведение звуков.

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

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

См. также раздел

Применяется к

Play(Stream, AudioPlayMode)

Воспроизведение звукового 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 -> unit
Public Sub Play (stream As Stream, playMode As AudioPlayMode)

Параметры

stream
Stream

Stream представляет звуковой файл.

playMode
AudioPlayMode

Режим AudioPlayMode для воспроизведения звука. По умолчанию — AudioPlayMode.Background.

Исключения

stream имеет значение Nothing.

Параметр playMode не совпадает ни с одним из значений перечисления AudioPlayMode.

В случае частичного доверия пользователь не имеет необходимых разрешений.

Примеры

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

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

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

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

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

Комментарии

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

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

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

Воспроизведение в фоновом режиме позволяет приложению выполнять другой код во время воспроизведения звуков.

Дополнительные сведения см. в разделе Воспроизведение звуков.

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

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

См. также раздел

Применяется к

Play(String, AudioPlayMode)

Воспроизведение звукового 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 -> unit
Public Sub Play (location As String, playMode As AudioPlayMode)

Параметры

location
String

Объект String , содержащий имя звукового файла.

playMode
AudioPlayMode

Режим AudioPlayMode для воспроизведения звука. По умолчанию — AudioPlayMode.Background.

Исключения

Параметр location равен пустой строке.

Пользователь не имеет необходимых разрешений для доступа к файлу по location.

Неправильный путь к файлу в location.

Путь в location имеет слишком большую длину.

Параметр playMode не совпадает ни с одним из значений перечисления AudioPlayMode.

В случае частичного доверия пользователь не имеет необходимых разрешений.

Примеры

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

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

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

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

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

Комментарии

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

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

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

Воспроизведение в фоновом режиме позволяет приложению выполнять другой код во время воспроизведения звуков.

Дополнительные сведения см. в разделе Воспроизведение звуков.

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

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

См. также раздел

Применяется к