MediaPlayer クラス

定義

名前空間:

System.Windows.Media

アセンブリ:

PresentationCore.dll

描画のためにメディアの再生を提供します。

C#

public class MediaPlayer : System.Windows.Media.Animation.Animatable

継承

Object

DispatcherObject

DependencyObject

Freezable

Animatable

MediaPlayer

例

方法: VideoDrawing を使用してメディアを再生する

注釈

このクラスのインスタンスは拡張アプリケーション マークアップ言語 (XAML) で宣言できますが、コードを使用せずにメディアを読み込んで再生することはできません。 XAML でのみメディアを再生するには、 を使用します MediaElement。 また、XAML でインスタンスを宣言する場合、実際には、 プロパティのプロパティ要素構文を埋めるのが唯一の Player 実用的な用途です。

アプリケーションでメディアを配布するときに、プロジェクト リソースとしてメディア ファイルを使うことはできません。 プロジェクト ファイルで、メディアの種類を Content に設定し、CopyToOutputDirectory を PreserveNewest または Always に設定する必要があります。

MediaPlayer 独立モードまたはクロックモード:プレーヤーを駆動しているものに応じて、2つの異なるモードで使用することができます。 独立モードでは、 MediaPlayer はイメージに似ていますが、 メソッドによって開かれたメディアが再生を Open 駆動します。 Clock モードでは、 MediaPlayer はアニメーションのターゲットと考えることができるため、再生を制御するタイミング ツリーに対応する Timeline エントリと Clock エントリが含まれます。 メディア モードの詳細については、「 マルチメディアの概要」を参照してください。

MediaPlayer は、 とは異なり MediaElement 、アプリケーションのユーザー インターフェイス (UI) に直接追加できるコントロールではありません。 を使用して読み込まれたメディアをMediaPlayer表示するには、 または DrawingContext をVideoDrawing使用する必要があります。

コンストラクター

MediaPlayer()

MediaPlayer クラスの新しいインスタンスを初期化します。

プロパティ

Balance	左右のスピーカーのボリュームのバランスを取得または設定します。
BufferingProgress	コンテンツをストリーミングするためのバッファリングが完了した割合を取得します。
CanFreeze	オブジェクトを変更不可能にできるかどうかを示す値を取得します。 (継承元 Freezable)
CanPause	メディアを一時停止できるかどうかを示す値を取得します。
Clock	再生される MediaClock に関連付けられている MediaTimeline を取得または設定します。
DependencyObjectType	このインスタンスの DependencyObjectType CLR 型をラップする を取得します。 (継承元 DependencyObject)
Dispatcher	この Dispatcher が関連付けられている DispatcherObject を取得します。 (継承元 DispatcherObject)
DownloadProgress	リモート サーバーに配置されているコンテンツのダウンロードの進行状況の割合を取得します。
HasAnimatedProperties	1 つ以上の AnimationClock オブジェクトが、このオブジェクトの任意の依存関係プロパティに関連付けられているかどうかを示す値を取得または設定します。 (継承元 Animatable)
HasAudio	メディアにオーディオ出力が含まれているかどうかを示す値を取得します。
HasVideo	メディアにビデオ出力が含まれているかどうかを示す値を取得します。
IsBuffering	メディアがバッファリング中かどうかを示す値を取得します。
IsFrozen	オブジェクトが変更可能かどうかを示す値を取得します。 (継承元 Freezable)
IsMuted	メディアがミュートされているかどうかを示す値を取得します。
IsSealed	このインスタンスが現在シールされている (読み取り専用である) かどうかを示す値を取得します。 (継承元 DependencyObject)
NaturalDuration	メディアの自然な継続時間を取得します。
NaturalVideoHeight	ビデオの高さ (ピクセル単位) を取得します。
NaturalVideoWidth	ビデオの幅 (ピクセル単位) を取得します。
Position	メディアの現在位置を取得または設定します。
ScrubbingEnabled	スクラビングが有効かどうかを示す値を取得または設定します。
Source	メディアの Uri を取得します。
SpeedRatio	メディアの再生の速度比率を取得または設定します。
Volume	メディアのボリュームを取得または設定します。

メソッド

ApplyAnimationClock(DependencyProperty, AnimationClock)	AnimationClock を指定した DependencyProperty に適用します。 プロパティが既にアニメーション化されている場合は、SnapshotAndReplace ハンドオフ動作が使用されます。 (継承元 Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	AnimationClock を指定した DependencyProperty に適用します。 プロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。 (継承元 Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	指定された DependencyProperty にアニメーションを適用します。 アニメーションは、次のフレームがレンダリングされるときに開始されます。 指定されたプロパティが既にアニメーション化されている場合は、SnapshotAndReplace ハンドオフ動作が使用されます。 (継承元 Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	指定された DependencyProperty にアニメーションを適用します。 アニメーションは、次のフレームがレンダリングされるときに開始されます。 指定したプロパティが既にアニメーション化されている場合は、指定した HandoffBehavior が使用されます。 (継承元 Animatable)
CheckAccess()	呼び出し元のスレッドがこの DispatcherObject にアクセスできるかどうかを確認します。 (継承元 DispatcherObject)
ClearValue(DependencyProperty)	プロパティのローカル値をクリアします。 クリアするプロパティは DependencyProperty 識別子で指定されます。 (継承元 DependencyObject)
ClearValue(DependencyPropertyKey)	読み取り専用プロパティのローカル値を消去します。 消去するプロパティは、DependencyPropertyKey で指定します。 (継承元 DependencyObject)
Clone()	この Animatable の変更可能な複製を作成し、このオブジェクトの値の詳細コピーを作成します。 このメソッドは、このオブジェクトの依存関係プロパティをコピーするときに、リソースの参照とデータ バインディングはコピーしますが (ただし、これらは解決されなくなっている場合があります)、アニメーションやその現在の値はコピーしません。 (継承元 Animatable)
CloneCore(Freezable)	このインスタンスを指定された MediaPlayer の詳細なコピーにします。 このメソッドは、依存関係プロパティをコピーするときにリソース参照とデータ バインディングをコピーしますが (ただし、これらは解決されなくなる場合があります)、アニメーションやその現在の値はコピーしません。
CloneCurrentValue()	Freezable の現在の値を使用して、変更可能な複製 (詳細コピー) を作成します。 (継承元 Freezable)
CloneCurrentValueCore(Freezable)	現在のプロパティ値を使用して、このインスタンスを、指定した MediaPlayer の変更可能な詳細コピーにします。 リソース参照、データ バインディング、アニメーションはコピーされませんが、それらの現在値はコピーされます。
Close()	基になるメディアを閉じます。
CoerceValue(DependencyProperty)	指定した依存関係プロパティの値を強制します。 これは、呼び出し元の DependencyObject の依存関係プロパティのプロパティ メタデータで指定されている CoerceValueCallback 関数を呼び出すことによって実現されます。 (継承元 DependencyObject)
CreateInstance()	Freezable クラスの新しいインスタンスを初期化します。 (継承元 Freezable)
CreateInstanceCore()	新しい MediaPlayer のインスタンスを作成します。
Equals(Object)	指定した DependencyObject が現在の DependencyObject と等しいかどうかを判断します。 (継承元 DependencyObject)
Freeze()	現在のオブジェクトを変更不可能にし、その IsFrozen プロパティを true に設定します。 (継承元 Freezable)
FreezeCore(Boolean)	Animatable オブジェクトを変更不可能な状態にするか、変更不可能な状態にできるかどうかを判断します。 (継承元 Animatable)
GetAnimationBaseValue(DependencyProperty)	指定した DependencyProperty のアニメーション化されていない値を返します。 (継承元 Animatable)
GetAsFrozen()	基本プロパティ値 (アニメーション化されていない値) を使用して、Freezable の 固定されたコピーを作成します。 コピーが固定されているため、参照によって任意の固定されたサブオブジェクトがコピーされます。 (継承元 Freezable)
GetAsFrozenCore(Freezable)	このインスタンスを、指定した MediaPlayer オブジェクトの複製にします。
GetCurrentValueAsFrozen()	現在のプロパティ値を使用して、Freezable の固定されたコピーを作成します。 コピーが固定されているため、参照によって任意の固定されたサブオブジェクトがコピーされます。 (継承元 Freezable)
GetCurrentValueAsFrozenCore(Freezable)	現在のインスタンスを、指定した Freezable の固定された複製にします。 オブジェクトに、アニメーション化された依存関係プロパティが存在する場合、現在アニメーション化されている値がコピーされます。 (継承元 Freezable)
GetHashCode()	この DependencyObject のハッシュ コードを取得します。 (継承元 DependencyObject)
GetLocalValueEnumerator()	どの依存関係プロパティがこの DependencyObject 上にローカルに設定された値を持つかを確認するための、専用の列挙子を作成します。 (継承元 DependencyObject)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetValue(DependencyProperty)	DependencyObject のこのインスタンスにある依存関係プロパティの現在の有効値を返します。 (継承元 DependencyObject)
InvalidateProperty(DependencyProperty)	指定した依存関係プロパティの有効値を再評価します。 (継承元 DependencyObject)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
OnChanged()	現在の Freezable オブジェクトの変更時に呼び出されます。 (継承元 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	設定されたばかりの DependencyObjectType データ メンバーに対して、適切なコンテキスト ポインターが確立されていることを確認します。 (継承元 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	このメンバーは、Windows Presentation Foundation (WPF) インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	OnPropertyChanged(DependencyPropertyChangedEventArgs) の DependencyObject 実装をオーバーライドして、さらに型 Freezable の変化する依存関係プロパティへの応答として任意の Changed ハンドラーも呼び出します。 (継承元 Freezable)
Open(Uri)	メディアを再生するために指定された Uri を開きます。
Pause()	メディアの再生を一時停止します。
Play()	メディアを現在の Position から再生します。
ReadLocalValue(DependencyProperty)	ローカルの依存関係プロパティの値を返します (存在する場合)。 (継承元 DependencyObject)
ReadPreamble()	MediaPlayer が有効なスレッドからアクセスされていることを確認します。
SetCurrentValue(DependencyProperty, Object)	依存関係プロパティ値のソースを変更せずにその値を設定します。 (継承元 DependencyObject)
SetValue(DependencyProperty, Object)	依存関係プロパティ識別子を指定して、該当する依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
SetValue(DependencyPropertyKey, Object)	依存関係プロパティの DependencyPropertyKey 識別子で指定した読み取り専用の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
ShouldSerializeProperty(DependencyProperty)	シリアル化プロセスが、指定された依存関係プロパティの値をシリアル化する必要があるかどうかを示す値を返します。 (継承元 DependencyObject)
Stop()	メディアの再生を停止します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
VerifyAccess()	呼び出し元のスレッドがこの DispatcherObject にアクセスできるように強制します。 (継承元 DispatcherObject)
WritePostscript()	Freezable の Changed イベントを発生させ、その OnChanged() メソッドを呼び出します。 Freezable から派生するクラスは、依存関係プロパティとして格納されていないクラス メンバーを変更するすべての API の終了時に、このメソッドを呼び出す必要があります。 (継承元 Freezable)
WritePreamble()	MediaPlayer が固定されておらず、有効なスレッド コンテキストからアクセスされていることを確認します。

イベント

BufferingEnded	バッファリングが終了したときに発生します。
BufferingStarted	バッファリングが開始されたときに発生します。
Changed	Freezable、またはこれに含まれているオブジェクトが変更されると発生します。 (継承元 Freezable)
MediaEnded	メディアの再生が完了したときに発生します。
MediaFailed	エラーが検出されると発生します。
MediaOpened	メディアが開かれたときに発生します。
ScriptCommand	メディアでスクリプト コマンドが検出されると発生します。

適用対象

こちらもご覧ください

• Drawing
• VideoDrawing
• DrawingContext