オーディオ ビデオ再生

AudioVideoPlayback のアプリケーション プログラミング インターフェイス (API) は、オーディオ ファイルとビデオ ファイルの基本的な再生と単純な制御を実現する。詳細については、「Microsoft.DirectX.AudioVideoPlayback」のマネージ コード リファレンスを参照すること。

ビデオ ファイル (オーディオを含むビデオ ファイルも) の再生には、Video クラスを使う。オーディオのみのファイルを再生するには、Audio クラスを使う。ビデオ ファイルを再生する場合、Audio クラスを使ってオーディオ プロパティを制御することもできる。SeekPositionFlags 列挙はシーク操作を制御し、StateFlags 列挙にはメディア ファイルの状態 (再生、ポーズ、停止) を示すフラグがある。

• ビデオ ファイルの再生
• オーディオ ファイルの再生

ビデオ ファイルの再生

ビデオ ファイルを再生するには、まず始めに Video クラスのインスタンスを作成する。次の C# のサンプル コードにあるように、Video コンストラクタを使ってファイル名を指定できる。また、ファイル名を指定して Open メソッドを呼び出すという方法もある。

using Microsoft.DirectX.AudioVideoPlayback;
public class MyVideoPlayer : System.Windows.Forms.Form
{
    /* ... */
    private void OpenFile()
    {
        try
        {
            Video ourVideo = new Video("C:\\Example.avi");
            /* ... */
        }
    }
    /* ... */
}

ビデオが含まれていないファイルを開こうとした場合、Video オブジェクトは例外を発行する。次に、Video オブジェクトのビデオ ウィンドウを保持する親ウィンドウをアプリケーション側で指定する。

ourVideo.Owner = this;  // 'this' refers to the application's Form object.

Play メソッド、Pause メソッド、Stop メソッドを呼び出して、再生を制御する。たとえば、次のイベント ハンドラは再生を停止する。

private void mnuStop_Click(object sender, System.EventArgs e)
{
    if (ourVideo != null)
    {
        ourVideo.Stop();
        }
}

再生ウィンドウのサイズを設定するには、Size プロパティを設定する。このプロパティは System.Drawing.Size オブジェクトを次のようにして取得する。

ourVideo.Size = new Size(480, 320);

オリジナルのビデオ サイズは DefaultSize プロパティを調査することで取得できる。ビデオ ファイルにオーディオ データが含まれている場合、Video.Audio プロパティは Audio オブジェクトを返す。このオブジェクトを使って、オーディオの音量またはステレオのバランスを設定できる。ファイルにオーディオが含まれていない場合、これらのプロパティを設定すると例外が発生する。次に示すように、コードの前後で try ブロックを使う。

try
{
    Video.Audio.Volume = 100;
}

オーディオ ファイルの再生

Audio オブジェクトは Video に似ているが、Volume や Balance といった、オーディオに関するプロパティをサポートしている点が異なる。オーディオ ファイルを再生するには、次の C# のサンプル コードにあるように、Audio コンストラクタを使ってファイル名を指定する。また、ファイル名を指定して Open メソッドを呼び出すという方法もある。

Audio ourAudio = new Audio("C:\MyAudioFile.wav");