My.Computer.Audio.Play メソッド

[アーティクル]
08/16/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 メソッドは .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 フォームアプリケーション内だけで実行できます。

ファイル名は、使用中のシステムに置かれた .wav サウンドファイルの名前であることが必要です。

サウンドファイルを簡単に管理するために、アプリケーションリソースとして格納することをお勧めします。それにより、My.Resources オブジェクトを使ってファイルにアクセスできるようになります。

必要条件

名前空間 : Microsoft.VisualBasic.Devices

クラス : Audio

アセンブリ : Visual Basic ランタイムライブラリ (Microsoft.VisualBasic.dll 内)

使用可能なプロジェクトの種類

プロジェクトの種類	使用可/不可
Windows アプリケーション	可
クラスライブラリ	可
コンソールアプリケーション	可
Windows コントロールライブラリ	可
Web コントロールライブラリ	不可
Windows サービス	可
Web サイト	不可

アクセス許可

次のアクセス許可が必要になる可能性があります。

アクセス許可	説明
FileIOPermission	ファイルとフォルダへのアクセス許可を制御します。関連する列挙値 : Unrestricted。
SecurityPermission	コードに適用されたセキュリティアクセス許可のセットを記述します。関連する列挙値 : ControlThread。