Windows Media 9 シリーズ - Windows Media Player と Windows Media エンコーダのプラグイン構築

2002 年 11 月

はじめに

Microsoft Windows Media Player 9 シリーズと Windows Media エンコーダ 9 シリーズの機能を拡張する上で、プラグインは欠かせない要素です。ユーザーは新たな再生エクスペリエンスを得られ、サードパーティにとっては収益増加のチャンスが増えます。開発者は、プラグインを作成して提供するにあたり、Windows Media Player 9 シリーズと Windows Media エンコーダ 9 シリーズのソフトウェア開発キット (SDK) を使用しますが、Microsoft DirectX® Media Object (DMO) に基づいた特定のプラグインでは DirectX SDK を使用する必要があります。

概要

このドキュメントでは、Microsoft® Windows Media® Player 9 シリーズと Windows Media エンコーダ 9 シリーズ用に作成できる、多種多様なプラグインについて説明します。このドキュメントは、Component Object Model (COM) テクノロジの基礎を理解している読者を対象とします。

この文書には、プラグインの作成と使用の詳細を説明した以下のトピックが含まれます。

プラグインを作成する理由プラグインの作成をお勧めする、ビジネス面の理由をいくつかご紹介します。
新しい種類のプラグインについて Windows Media Player 9 シリーズと Windows Media エンコーダ 9 シリーズ SDK を使用して作成できる、新しい種類のプラグインについて説明します。
プラグインとユーザーの対話方法ユーザーがプラグインを有効にする方法と、オプションのプロパティページを使ってプラグインを構成する方法について説明します。
詳細情報この文書で述べる各種 SDK へのリンク、ならびにプラグインの登録情報を掲載しています。

トップに戻る

プラグインを作成する理由

プラグインは、サードパーティが収益を創出し、構築済みプラットフォームと製品を結びつけるための優れた方法となります。

次の一覧では、プラグインの作成をお勧めする理由をいくつか挙げています。

セールスチャンス。 ユーザーがサードパーティ製プラグインを積極的に購入するようになります。さまざまなデジタル信号処理 (DSP) プラグイン、DVD デコーダプラグイン、MP3 エンコーダプラグインが市場で成功を収めています。
インストールベースの大きさ。全世界の数百万のユーザーが、Windows Media Player と Windows Media エンコーダをインストールしています。これは多数の潜在的な顧客を獲得できることを意味します。
継続的なサービス収益。 Windows Media Player 内に含まれたプラグインを活用して、Windows Media Player を追加サービスの提供に利用することができます。たとえば、ユーザーインターフェイスプラグインを使用して、DSP プラグインを構成することや、ビデオのホットスポットなどの機能を提供するレンダリングプラグインと DSP プラグインを相互運用することができます。

トップに戻る

新しい種類のプラグインについて

以前のバージョンの Windows Media Player SDK では、視覚エフェクト、MP3 エンコーダ、DVD エンコーダのカスタムプラグインの作成が可能でした。Windows Media Player 9 シリーズ SDK は、新しいプラグインアーキテクチャによって、その他の種類のプラグインも作成できるようになりました。作成できるのは次のような種類のプラグインです。

ユーザーインターフェイスプラグイン。Player の [プレイビュー] ウィンドウに新機能を追加します。 [ビデオと視覚エフェクト] ウィンドウ、[拡張設定] ウィンドウ、[メディアの情報] ウィンドウ、または独立したウィンドウを表示するプラグインを作成することや、表示可能なユーザーインターフェイスを公開しないバックグラウンドプラグインを作成することができます。
DSP プラグイン。 Player によってレンダリングされる前に、オーディオとビデオのデータを変更または処理します。DSP プラグインは DMO をベースにしており、COM インターフェイス経由で Player と接続されます。
レンダリングプラグイン。Windows Media ストリームに含まれたカスタムデータをレンダリングおよびデコード (必要な場合) します。レンダリングプラグインも DMO をベースとしており、 COM インターフェイス経由で Player と接続されます。

Windows Media Player SDK には Windows Media Player プラグインウィザードが含まれており、標準実装の詳細を処理するだけで、プラグインを簡単に作成できるようになります。プラグインウィザードを使用してプラグインを作成すると、基本実装の詳細を気にかけずに済むので、プラグインのロジック実装に関する開発作業に専念できます。

次の種類のプラグインを使用して、Windows Media エンコーダ機能を拡張することもできます。

変換プラグイン。圧縮されていないオーディオとビデオのサンプルを、圧縮前に修正します。変換プラグインは DMO または Microsoft DirectShow® の変換フィルタをベースにしており、ラッパープラグインによって COM インターフェイス経由でアクセスされます。

ユーザーインターフェイスプラグイン
次の 5 種類のユーザーインターフェイスプラグインは、Windows Media Player 機能を拡張します。

ディスプレイプラグイン。このプラグインを使用すると、さまざまな情報を表示できます。たとえば、表示領域プラグインは現在再生しているアイテムの情報を取得し、関連記事、インタビュー、レビューなどを表示します。
設定プラグイン。グラフィックイコライザやビデオ設定コントロールと類似したカスタムコントロールを表示します。
メタデータプラグイン。 現在の再生メディアアイテムに関する情報、シンプルなコントロール、追加情報へのハイパーリンクを表示します。
ウィンドウプラグイン。 ユーザーが [プレイビュー] 領域外へ切り替えたときや、別のユーザーインターフェイスプラグインを有効にしたときにも、プラグインの提供する情報やコントロールを表示したままにしておく場合に有益です。
バックグラウンドプラグイン。 ユーザー入力を必要としない、自動的なサービスを提供します。プロパティページを実装していない限り、バックグラウンドプラグインはユーザーインターフェイスを持ちません。

次の図は、上記のユーザーインターフェイスプラグインが Windows Media Player のどの場所に表示されるかを示しています。

User interface plug-ins in the Player

図 1. Player のユーザーインターフェイスプラグイン

すべてのユーザーインターフェイスプラグインは、中核の Windows Media Player アプリケーションプログラミングインターフェイス (API) へのポインタを使って、Player のオブジェクトモデルへアクセスします。これにより、Windows Media Player の [メディアライブラリ]、現在の再生リスト、Player のコントロール、イベントなどの中核機能を利用できるようになります。

ユーザーインターフェイスプラグインを作成するときは、IWMPPluginUI のみを実装する必要があります。この API は、同じく実装が必要な複数のメソッドを公開します。 Windows Media Player プラグインウィザードを使用している場合、基本実装は自動的に実行されます。

ユーザーインターフェイスプラグインは、フルモードの Player と、Windows Media Player 9 シリーズに対応したオペレーティングシステムでサポートされます。

DSP プラグイン
DSP プラグインは、Windows Media Player がレンダリングする前に、オーディオまたはビデオデータを処理します。たとえば、オーディオストリームにエコー効果を追加したり、カラーのビデオストリームをグレースケールに変換して、再生中のユーザーコンテンツを変更することができます。

DSP プラグインは、すべての Windows Media ファイル、MP3 ファイル、AVI および WAV ファイル、ならびに CD で動作します。ローカルにコピーされたコンテンツを除き、デジタル著作権管理 (DRM) で保護されたコンテンツでは一切動作しません。また DVD でも動作しません。

DSP プラグインを作成するときは、IMediaObject と IWMPPluginEnable という 2 つの API を実装する必要があります。先に述べたように、DSP プラグインは DMO をベースとしており、フォーマットネゴシエーションとデータ処理は IMediaObject インターフェイスで管理されます。 IWMPPluginEnable インターフェイスは、プラグインが Windows Media Player で有効になっているかどうかを示す値を格納します。

ユーザーがプラグインの動作を変更できるようにするため、プロパティページを作成する場合、IPropertyPage と ISpecifyPropertyPages インターフェイスを実装しなければなりません。

Windows Media Player プラグインウィザードは、オーディオまたはビデオの DSP プラグイン用の基本実装を提供します。

DSP プラグインは、フルモードの Windows Media Player、スキン、および組み込みコントロールでサポートされます。Windows Media Player 9 シリーズ対応のオペレーティングシステムであれば、このプラグインはサポートされます。

レンダリングプラグイン
レンダリングプラグインは任意のデータストリームを Player から受信し、そのデータをレンダリングします。そのため、実質的にあらゆるフォーマットのデータを Player にレンダリングし、表示することができます。たとえば、ユーザーがクリックすることでビデオの再生エクスペリエンスを変更できるビデオの「ホットスポット」を、レンダリングプラグインを使用して作成することができます。ホットスポットのような任意のデータストリームは、Windows Media フォーマット 9 シリーズ SDK をベースとするオーサリングツールを使用して、Windows Media ファイルに書き込まなければなりません。

レンダリングプラグインを作成するときは、IMediaObject、IWMPNodeRealEstate、IWMPNodeWindowed、IWMPNodeWindowless、IWMPPlugin、IWMPWindowMessageSink の 6 つのインターフェイスを実装する必要があります。レンダリングプラグインも DMO をベースにしており、IMediaObject インターフェイスはレンダリングプラグインのフォーマットネゴシエーションとデータ処理を管理します。IWMPNodeRealEstate インターフェイスは、レンダリング領域に関連した応答を要求し、受信するために使用されます。 Player はウィンドウモードまたはウィンドウレスモードいずれのデータもレンダリングできるので、レンダリングプラグインは IWMPNodeWindowed と IWMPNodeWindowless インターフェイスの両方を実装しなければなりません。 IWMPNodeWindowed インターフェイスは、オーナーウィンドウの指定と取得を行い、IWMPNodeWindowless インターフェイスはウィンドウレスモードの描画を開始します。また IWMPPlugin インターフェイスは、Player との接続を管理します。最後に、IWMPWindowMessageSink はプラグインがウィンドウレスモードのときに、Microsoft Windows® のメッセージを受信します。

プロパティページへユーザーがアクセスできるようにするには、IPropertyPage と ISpecifyPropertyPages インターフェイスを実装しなければなりません。

Windows Media Player プラグインウィザードは、オーディオファイルの再生中にテキストを表示する、サンプルのレンダリングプラグインを作成します。

レンダリングプラグインは、フルモードの Player、スキン、および組み込みコントロールでサポートされます。Windows Media Player 9 シリーズに対応したオペレーティングシステムであれば、このプラグインをサポートします。

変換プラグイン
変換プラグインは、圧縮されていないオーディオとビデオのサンプルを圧縮前に修正します。たとえば、透かし、ビデオコメントの追加、指紋認証、カスタムのオーディオ/ビデオ処理などのタスクを実行できます。

変換プラグインは DMO または変換フィルタをベースとしており、ラッパープラグインを介して Windows Media エンコーダへアクセスします。 Windows Media エンコーダでサポートする入力種類は変更できますが、プラグインあたり 1 種類のメディアしか変更できません。たとえば、ファイル内のオーディオストリームとビデオストリームの両方を変更する場合、2 種類の変換プラグインを別々に作成しなければなりません。

変換プラグインを作成するときは、IMediaObject インターフェイスを実装する必要があります。プラグインを作成して、登録した後は、IWMEncTransformPluginInfoManager と IWMEncPluginInfo インターフェイスを使用して、プラグイン情報を管理および取得することができます。

Windows Media エンコーダ 9 シリーズに対応したオペレーティングシステムであれば、変換プラグインをサポートします。

トップに戻る

プラグインとユーザーの対話方法

Windows Media Player プラグインは WindowsMedia.com

からダウンロードできます。あるいは、Windows Media Player の [メディアガイド] 機能を使用したダウンロードが可能です。 [ツール] メニューの [プラグイン] をポイントし、[プラグインのダウンロード] をクリックするか、または [オプション] ダイアログボックスの [プラグイン] タブをクリックします。

Windows Media Player と Windows Media エンコーダのプラグインをインストールするには、プラグインをコンピュータに適切に登録するため、インストールプログラムを使用する必要があります。

Windows Media Player のプラグインをインストールした後は、[プラグイン] タブにあるチェックボックスを使用して、プラグインの有効または無効を切り替えることができます。 [ツール] メニューから [プラグイン] をポイントし、プラグイン名をクリックしても、有効と無効の切り替えが可能です。プラグインがプロパティページを使用している場合がありますが、このページにも [プラグイン] タブからアクセスできます。

Windows Media エンコーダのプラグインをインストールした後は、[セッションプロパティ] ダイアログボックスの [プラグイン] タブを使用して、プラグインを登録しなければなりません。プラグインの登録後は、プラグインをクリックして、現在のプラグイン一覧に移動させることができます。この一覧のプラグインの順序は、コンテンツの処理方法によって決まります。

トップに戻る

詳細情報

作成したプラグインの情報を Windows Media プラグインポータルに登録することができます。 mpplugin@microsoft.com まで電子メールメッセージをお送りください。
Windows Media Player、Windows Media エンコーダ、Windows Media フォーマット、および DirectX SDK は MSDN® Online からダウンロードできます。
Creating a Windows Media Services Logging Plug-in の記事
Windows Media Player 9 シリーズを使ったカスタマイズ Web 環境の作成の記事

法的な注意
このドキュメントに記載されている情報は、このドキュメントの発行時点におけるマイクロソフトの見解を反映したものです。変化する市場状況に対応する必要があるため、このドキュメントは、記載された内容の実現に関するマイクロソフトの確約とはみなされないものとします。また、発行以降に発表される情報の正確性に関して、マイクロソフトはいかなる保証もいたしません。

このホワイトペーパーは情報提供のみを目的としており、明示または黙示に関わらず、これらの情報についてマイクロソフトはいかなる責任も負わないものとします。

お客様ご自身の責任において、適用されるすべての著作権関連法規に従ったご使用を願います。このドキュメントのいかなる部分も、米国 Microsoft Corporation の書面による許諾を受けることなく、その目的を問わず、どのような形態であっても、複製または譲渡、検索システムへの格納および公開をすることは禁じられています。ここでいう形態とは、複写や記録など、電子的な、または物理的なすべての手段を含みます。ただしこれは、著作権法上のお客様の権利を制限するものではありません。

マイクロソフトは、このドキュメントに記載されている内容に関し、特許、特許申請、商標、著作権、またはその他の無体財産権を有する場合があります。別途マイクロソフトのライセンス契約上に明示の規定のない限り、このドキュメントはこれらの特許、商標、著作権、またはその他の無体財産権に関する権利をお客様に許諾するものではありません。

© 2003 Microsoft Corporation. All rights reserved.

マイクロソフト、MS-DOS、Windows、Windows Media、Windows NT、ActiveSync、ActiveX、Direct3D、DirectDraw、DirectInput、DirectMusic、DirectPlay、DirectShow、DirectSound、DirectX、FrontPage、JScript、Microsoft Press、MSN、NetShow、Outlook、PowerPoint、SQL Server、Visual Basic、Visual C++、Visual InterDev、Visual J++、Visual Studio、WebTV、Win32、および Win32s は、米国 Microsoft Corporation の米国およびその他の国における登録商標または商標です。

記載されている会社名、製品名には、各社の商標のものもあります。

トップに戻る