My.Computer.Audio.Play 메서드

아티클
08/20/2008

업데이트: 2007년 11월

.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 메서드는 파일(location), 바이트 배열(data) 또는 스트림(stream)으로 저장된 .wav 사운드 파일을 재생합니다.

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