MediaPlayer クラス

リファレンス

定義

名前空間:: Windows.Media.Playback

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

再生、一時停止、fast-forward、巻き戻し、ボリュームなどのメディア再生機能にアクセスできます。

public ref class MediaPlayer sealed

public ref class MediaPlayer sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class MediaPlayer final

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(196608, "Windows.Foundation.UniversalApiContract")]
class MediaPlayer final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class MediaPlayer

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(196608, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaPlayer : System.IDisposable

function MediaPlayer()

Public NotInheritable Class MediaPlayer

Public NotInheritable Class MediaPlayer
Implements IDisposable

継承: Object Platform::Object IInspectable MediaPlayer

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ActivatableAttribute

実装: IClosable IDisposable

Windows の要件

デバイスファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

ドキュメントのメディア再生セクションには、アプリにメディア再生機能を追加するための詳細なガイダンスを提供するハウツー記事が含まれています。次の表に、使用可能な記事の一部を示します。

トピック	説明
MediaPlayer を使ったオーディオとビデオの再生	UWP アプリのメディア再生システムの新機能と機能強化を活用する方法について説明します。
メディア項目、プレイリスト、トラック	MediaSource クラスを使用する方法について説明します。このクラスは、ローカルファイルやリモートファイルなどのさまざまなソースからメディアを参照および再生するための一般的な方法を提供し、基になるメディア形式に関係なく、メディアデータにアクセスするための共通モデルを公開します。
システムメディアトランスポートコントロールとの統合	アプリを System Media Transport Controls (SMTC) と統合する方法について説明します。
システムでサポートされているタイミングが設定されたメタデータのキュー	メディアファイルまたはストリームに埋め込まれる可能性があるタイミングメタデータのいくつかの形式を利用する方法について説明します。
メディアの中断の作成、スケジュール、管理	メディア再生アプリのメディア中断を作成、スケジュール、管理する方法について説明します。
バックグラウンドでのメディアの再生	アプリがフォアグラウンドからバックグラウンドに移動したときにメディアが引き続き再生されるようにアプリを構成する方法について説明します。
アダプティブストリーミング	アダプティブストリーミングマルチメディアコンテンツの再生をユニバーサル Windows プラットフォーム (UWP) アプリに追加する方法について説明します。
メディアのキャスト	ユニバーサル Windows アプリからリモートデバイスにメディアをキャストする方法について説明します。
PlayReady DRM	PlayReady で保護されたメディアコンテンツをユニバーサル Windows プラットフォーム (UWP) アプリに追加する方法について説明します。

メディア再生の SDK サンプル

次の SDK サンプルでは、Windows 10 の UWP アプリで利用できるメディア再生機能が示されています。コンテキスト内でメディア再生 API を使用する方法を確認したり、独自のアプリを作成し始める場合は、以下のサンプルをご利用ください。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1511	10586	AddAudioEffect
1511	10586	RemoveAllEffects
1607	14393	AddVideoEffect
1607	14393	AudioBalance
1607	14393	AudioDevice
1607	14393	BreakManager
1607	14393	CommandManager
1607	14393	GetAsCastingSource
1607	14393	GetSurface
1607	14393	IsMutedChanged
1607	14393	PlaybackSession
1607	14393	RealTimePlayback
1607	14393	SetSurfaceSize
1607	14393	SourceChanged
1607	14393	StepBackwardOneFrame
1607	14393	StepForwardOneFrame
1607	14393	立体ビデオレンダリングモード
1607	14393	TimelineController
1607	14393	TimelineControllerPositionOffset
1703	15063	CopyFrameToStereoscopicVideoSurfaces
1703	15063	CopyFrameToVideoSurface(IDirect3DSurface)
1703	15063	CopyFrameToVideoSurface(IDirect3DSurface,Rect)
1703	15063	IsVideoFrameServerEnabled
1703	15063	VideoFrameAvailable
1709	16299	RenderSubtitlesToSurface(IDirect3DSurface)
1709	16299	RenderSubtitlesToSurface(IDirect3DSurface,Rect)
1709	16299	SubtitleFrameChanged
1803	17134	AudioStateMonitor

コンストラクター

MediaPlayer()

MediaPlayer オブジェクトの新しいインスタンスを初期化します。

プロパティ

AudioBalance	ステレオスピーカー間のボリュームの比率を取得または設定します。
AudioCategory	現在再生中のオーディオの種類を取得または設定します。
AudioDevice	オーディオをレンダリングするために MediaPlayer によって使用されるオーディオデバイスを表す DeviceInformation オブジェクトを取得または設定します。
AudioDeviceType	オーディオの再生に使用されるデバイスの主な使用状況を表す値を取得または設定します。
AudioStateMonitor	UWP アプリがアプリのオーディオストリームのいずれかが現在ミュートされているか、システムによってボリュームが減っているかを判断できるようにする AudioStateMonitor オブジェクトを取得します。
AutoPlay	メディアの読み込み後に再生が自動的に開始されるかどうかを示すブール値を取得または設定します。
BreakManager	MediaPlayer に関連付けられている MediaBreakManager を取得します。これにより、プレーヤーのメディア区切りの情報と制御が提供されます。
BufferingProgress	メディアコンテンツに対して完了したバッファリングの量をパーセンテージで表して取得します。注意 MediaPlayer.BufferingProgress は、バージョン 1607 Windows 10後に変更または使用できない場合があります。代わりに、 MediaPlayer.PlaybackSession プロパティを使用して MediaPlaybackSession オブジェクトを取得し、 MediaPlaybackSession.BufferingProgress プロパティを使用します。
CanPause	メディアを一時停止できるかどうかを示すブール値を取得します。注意 MediaPlayer.CanPause は、バージョン 1607 Windows 10後に変更または使用できない場合があります。代わりに、 MediaPlayer.PlaybackSession プロパティを使用して MediaPlaybackSession オブジェクトを取得し、 MediaPlaybackSession.CanPause プロパティを使用します。
CanSeek	メディアが特定の位置へのシークをサポートしているかどうかを示すブール値を取得します。注意 MediaPlayer.CanSeek は、バージョン 1607 Windows 10後に変更または使用できない場合があります。代わりに、 MediaPlayer.PlaybackSession プロパティを使用して MediaPlaybackSession オブジェクトを取得し、 MediaPlaybackSession.CanSeek プロパティを使用します。
CommandManager	MediaPlayer に関連付けられている MediaPlaybackCommandManager を取得します。このプロパティは、の動作を指定し、システムメディアトランスポートコントロールからイベントを受信します。
CurrentState	メディア再生の現在の状態を取得します。注意 MediaPlayer.CurrentState は、バージョン 1607 Windows 10後に変更または使用できない場合があります。代わりに、 MediaPlayer.PlaybackSession プロパティを使用して MediaPlaybackSession オブジェクトを取得し、 MediaPlaybackSession.PlaybackState プロパティを使用します。
IsLoopingEnabled	メディアが繰り返しループで再生されるかどうかを示すブール値を取得または設定します。
IsMuted	オーディオがミュートされているかどうかを示すブール値を取得または設定します。
IsProtected	コンテンツがデジタル著作権管理システムによって保護されているかどうかを示すブール値を取得します。注意 MediaPlayer.IsProtected は、バージョン 1607 Windows 10後に変更または使用できない場合があります。代わりに、 MediaPlayer.PlaybackSession プロパティを使用して MediaPlaybackSession オブジェクトを取得し、 IsProtected プロパティを使用します。
IsVideoFrameServerEnabled	MediaPlayer インスタンスに対してビデオフレームサーバーモードが有効かどうかを示す値を取得します。
NaturalDuration	PlaybackRate を適用せずに、メディアの実際の期間を取得します。注意 MediaPlayer.NaturalDuration は、バージョン 1607 Windows 10後に変更または使用できない場合があります。代わりに、 MediaPlayer.PlaybackSession プロパティを使用して MediaPlaybackSession オブジェクトを取得し、 MediaPlaybackSession.NaturalDuration プロパティを使用します。
PlaybackMediaMarkers	メディアのタイムラインマーカーのコレクションを取得します。注意 MediaPlayer.PlaybackMediaMarkers は、バージョン 1607 Windows 10後に変更または使用できない場合があります。代わりに、 MediaPlaybackItem.TimedMetadataTracks を使用してデータまたはテキストキューを管理します。詳細については、「 MediaSource を使用したメディア再生」を参照してください。
PlaybackRate	再生速度を比率で表す値を取得または設定します。注意 MediaPlayer.PlaybackRate は、バージョン 1607 Windows 10後に変更または使用できない場合があります。代わりに、 MediaPlayer.PlaybackSession プロパティを使用して MediaPlaybackSession オブジェクトを取得し、 MediaPlaybackSession.PlaybackRate プロパティを使用します。
PlaybackSession	現在の再生セッションの状態に関する情報を提供し、再生セッションの状態の変化に応答するためのイベントを提供する MediaPlayer に関連付けられている MediaPlaybackSession を取得します。
Position	メディア内の再生位置を取得または設定します。注意 MediaPlayer.Position は、バージョン 1607 Windows 10後に変更または使用できない場合があります。代わりに、 MediaPlayer.PlaybackSession プロパティを使用して MediaPlaybackSession オブジェクトを取得し、 MediaPlaybackSession.Position プロパティを使用します。
ProtectionManager	メディアのコンテンツ保護マネージャーを取得または設定します。
RealTimePlayback	ライブストリーミングビデオなどのリアルタイムシナリオ用に MediaPlayer を構成する値を取得または設定します。
Source	メディアプレーヤーの再生ソースを設定します。
StereoscopicVideoRenderMode	現在の立体レンダリングモードを示す値を取得または設定します。
SystemMediaTransportControls	MediaPlayer の再生のユーザー制御を有効にし、アプリがシステム UI で現在再生されているコンテンツに関する情報を表示できるようにする SystemMediaTransportControls クラスのインスタンスを取得します。
TimelineController	MediaPlayer に関連付けられている MediaTimelineController を取得または設定します。 1 つのタイムラインコントロールで複数の MediaPlayer インスタンスを操作するには、このプロパティを使用します。
TimelineControllerPositionOffset	MediaPlayer に関連付けられている MediaTimelineController の位置に適用されるオフセットを取得または設定します。
Volume	メディア再生用のオーディオボリュームを取得または設定します。

メソッド

AddAudioEffect(String, Boolean, IPropertySet)	MediaPlayer の再生ストリームにオーディオ効果を追加します。
AddVideoEffect(String, Boolean, IPropertySet)	ビデオ効果をメディア再生に適用します。
Close()	MediaPlayer を閉じ、関連付けられているリソースを破棄します。
CopyFrameToStereoscopicVideoSurfaces(IDirect3DSurface, IDirect3DSurface)	MediaPlayer によって現在表示されているビデオフレームを、立体ビデオフレームの左目と右目のコンテンツを表す 2 つの指定された IDirect3DSurface オブジェクトにコピーします。
CopyFrameToVideoSurface(IDirect3DSurface)	MediaPlayer から指定された IDirect3DSurface に現在のビデオフレームをコピーします。
CopyFrameToVideoSurface(IDirect3DSurface, Rect)	MediaPlayer から現在のビデオフレームを、指定された IDirect3DSurface 内の指定したターゲット四角形にコピーします。
Dispose()	アンマネージリソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。
GetAsCastingSource()	MediaPlayer を表す CastingSource を取得します。これにより、メディアを他のデバイスにキャストできます。
GetSurface(Compositor)	MediaPlayer の MediaPlayerSurface オブジェクトを取得します。これにより、XAML フレームワークに依存することなく、コンポジターを使用してプレーヤーのコンテンツをレンダリングできます。
Pause()	メディアの再生を一時停止します。
Play()	メディアの再生を開始します。
RemoveAllEffects()	MediaPlayer の再生ストリームからすべての効果を削除します。
RenderSubtitlesToSurface(IDirect3DSurface)	指定された IDirect3DSurface に現在のサブタイトルテキストをレンダリングするようにシステムに要求します。
RenderSubtitlesToSurface(IDirect3DSurface, Rect)	指定された IDirect3DSurface 内の指定したターゲット四角形に現在のサブタイトルテキストをレンダリングするようにシステムに要求します。
SetFileSource(IStorageFile)	メディアソースをファイルに設定します。注意 mediaPlayer.SetFileSource は、Windows 10後に変更または使用できない場合があります。代わりに MediaPlayer.Source を使用してください。
SetMediaSource(IMediaSource)	再生するメディアソースを設定します。注意 mediaPlayer.SetMediaSource は、Windows 10後に変更または使用できない場合があります。代わりに MediaPlayer.Source を使用してください。
SetStreamSource(IRandomAccessStream)	メディアソースをストリームに設定します。注意 mediaPlayer.SetMediaSource は、Windows 10後に変更または使用できない場合があります。代わりに MediaPlayer.Source を使用してください。
SetSurfaceSize(Size)	GetSurface によって返されるコンポジションサーフェスのサイズを設定します。
SetUriSource(Uri)	メディアへのパスを設定します。注意 mediaPlayer.SetUriSource は、Windows 10後に変更または使用できない場合があります。代わりに MediaPlayer.Source を使用してください。
StepBackwardOneFrame()	MediaPlayer の再生位置を 0.042 秒後方に移動させます。これは、再生されるコンテンツの実際のフレームレートに関係なく、24 fps の 1 フレームに対応します。
StepForwardOneFrame()	MediaPlayer を現在のメディア内で 1 フレーム進めます。

イベント

BufferingEnded	バッファリングが終了したときに発生します。注意 MediaPlayer.BufferingEnded は、バージョン 1607 Windows 10後に変更または使用できない場合があります。代わりに、 MediaPlayer.PlaybackSession プロパティを使用して MediaPlaybackSession オブジェクトを取得し、 MediaPlaybackSession.BufferingEnded イベントを使用します。
BufferingStarted	バッファリングが開始されたときに発生します。注意 MediaPlayer.BufferingStarted は、バージョン 1607 Windows 10後に変更または使用できない場合があります。代わりに、 MediaPlayer.PlaybackSession プロパティを使用して MediaPlaybackSession オブジェクトを取得し、 MediaPlaybackSession.BufferingStarted イベントを使用します。
CurrentStateChanged	メディアプレーヤーの状態が変更されたときに発生します。注意 MediaPlayer.CurrentStateChanged は、バージョン 1607 Windows 10後に変更または使用できない場合があります。代わりに、 MediaPlayer.PlaybackSession プロパティを使用して MediaPlaybackSession オブジェクトを取得し、 MediaPlaybackSession.PlaybackStateChanged イベントを使用します。
IsMutedChanged	MediaPlayer の現在のミュート状態が変更されたときに発生します。
MediaEnded	メディアの再生が完了したときに発生します。
MediaFailed	エラーが検出されると発生します。
MediaOpened	メディアが開かれたときに発生します。
MediaPlayerRateChanged	メディアの再生速度が変更されたときに発生します。注意 MediaPlayer.MediaPlayerRateChanged は、バージョン 1607 Windows 10後に変更または使用できない場合があります。代わりに、 MediaPlayer.PlaybackSession プロパティを使用して MediaPlaybackSession オブジェクトを取得し、 MediaPlaybackSession.PlaybackRateChanged イベントを使用します。
PlaybackMediaMarkerReached	再生中にメディアマーカーに到達したときに発生します。注意 MediaPlayer.PlaybackMediaMarkerReached は、バージョン 1607 Windows 10後に変更または使用できない場合があります。代わりに、 MediaPlaybackItem.TimedMetadataTracks を使用してデータまたはテキストキューを管理します。詳細については、「 MediaSource を使用したメディア再生」を参照してください。
SeekCompleted	シーク操作が完了したときに発生します。注意 MediaPlayer.SeekCompleted は、バージョン 1607 Windows 10後に変更または使用できない場合があります。代わりに、 MediaPlayer.PlaybackSession プロパティを使用して MediaPlaybackSession オブジェクトを取得し、 MediaPlaybackSession.SeekCompleted イベントを使用します。
SourceChanged	MediaPlayer のメディアソースが変更されたときに発生します。
SubtitleFrameChanged	MediaPlayer がフレームサーバーモードのときに、現在のサブタイトルコンテンツが変更されたときに発生します。
VideoFrameAvailable	IsVideoFrameServerEnabled が true に設定され、新しいビデオフレームが処理に使用できる場合に発生します。
VolumeChanged	オーディオの音量が変更されたときに発生します。

適用対象