このサンプル アプリケーションでは、システムによって提供される既定の減衰動作を示し、ダッキング イベントをオプトアウトし、ダッキング イベントの受信時にカスタム処理を実装するメディア プレーヤーを実装することで、ストリームの減衰を示します。 このサンプルは 、DuckingCaptureSample と組み合わせて使用する必要があります。 ダッキングまたはストリーム減衰の詳細については、「既定のダッキング エクスペリエンスの 」を参照してください。
このトピックには、次のセクションが含まれています。
形容
このサンプルでは、次の機能を示します。
- メディア ファイルを再生する DirectShow。
- ストリーム管理とダッキング イベントの処理のための WASAPI を します。
必要条件
| 積 | バージョン |
|---|---|
| Windows SDK の | Windows 7 |
| Visual Studio | 2008 |
サンプルのダウンロード
このサンプルは、次の場所にあります。
| 場所 | パス/URL |
|---|---|
| Windows SDK | \Program Files\Microsoft SDK\Windows\v7.0\Samples\Multimedia\Audio\DuckingMediaPlayer\... |
サンプルのビルド
DuckingMediaPlayer サンプルをビルドするには、次の手順に従います。
- Visual Studio 2008 でDuckingMediaPlayer.slnを開きます。
- ウィンドウ内から、デバッグ またはリリース ソリューション構成 選択し、メニュー バーから ビルド メニューを選択し、ビルド オプションを選択します。 SDK の CMD シェルから Visual Studio を開かない場合、Visual Studio は SDK ビルド環境にアクセスできません。 その場合、プロジェクト ファイル DuckingMediaPlayer.vcproj で使用される環境変数 MSSdk を明示的に設定しない限り、サンプルはビルドされません。
サンプルの実行
アプリケーションを正常にビルドすると、実行可能ファイル (DuckingMediaPlayer.exe) が生成されます。 これを実行するには、[デバッグ 開始] または [デバッグなしで開始] [デバッグ] メニューから選択するか、コマンド ウィンドウに「DuckingMediaPlayer」と入力します。
ダッキングのデモンストレーションを表示するには、DuckingMediaPlayer と DuckingCaptureSample を同時に実行する必要があります。 DuckingCaptureSample は通信ストリームを開き、ダッキング イベントを生成するようにシステムに通知します。 ダッキング イベントが発生すると、DuckingMediaPlayer がシステムによって通知され、メディア プレーヤーはユーザーが要求したアクションを実行します。
ダッキング動作を無効にするには:
- [DuckingCaptureSample] ウィンドウで、[既定の入力デバイス を使用] を選択し、[開始] をクリックして通信デバイスからキャプチャ セッションを開始します。
- DuckingMediaPlayer で、再生するメディア ファイルを選択し、ダッキング からオプトアウトダッキング オプションを指定します。
メディア ファイルが中断されずに再生されていることに注意してください。 通信ストリームが開かれたときにシステムによって生成されるイベントは無視されます。
システムによって提供される既定のダッキング動作を示すには、次の操作を行います。
- コントロール パネルから サウンド オプションを選択します。 [通信] タブで、[他のサウンドの音量を 80%減らす] を選択します。
- [DuckingCaptureSample] ウィンドウで、[既定の入力デバイス を使用] を選択し、[開始] をクリックして通信デバイスからキャプチャ セッションを開始します。
- DuckingMediaPlayer で、ダッキング オプションを選択せずに、再生するメディア ファイルを選択します。
- DuckingCaptureSample ウィンドウで、通信ストリーム 停止 をクリックします。
DuckingCaptureSample が通信ストリームを開くと、DuckingMediaPlayer によって再生されるメディア ファイルは中断されずに再生されますが、ボリューム レベルは低下します。 通信セッションが停止すると、ボリュームは元の設定にリセットされます。 このストリーム減衰動作は、システムによって実装される既定のダッキング動作です。
メディア プレーヤーによって実装されたカスタマイズされたダッキング動作を表示するには:
- [DuckingCaptureSample] ウィンドウで、[既定の入力デバイス を使用] を選択し、[開始] をクリックして通信デバイスからキャプチャ セッションを開始します。
- DuckingMediaPlayer で、再生するメディア ファイルを選択し、ダック で一時停止ダッキング オプションを指定します。
- DuckingCaptureSample ウィンドウで、通信ストリーム 停止 をクリックします。
DuckingCaptureSample が通信ストリームを開くと、DuckingMediaPlayer によって再生されるメディア ファイルが一時停止されます。 通信セッションが停止すると、再生が再開されます。 このストリーム減衰動作は、メディア プレーヤーによって実装されるダッキング動作です。
DuckingMediaPlayer では、各アプリケーションのボリューム制御をボリューム ミキサーと統合する方法も示します。
ストリーム減衰機能の詳細については、「既定のダッキング エクスペリエンスの 」を参照してください。
関連トピック
-
コア オーディオ API を使用する SDK サンプルを する