次の方法で共有


MediaPlayer クラス

定義

再生、一時停止、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
属性
実装

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)

MediaPlayerMediaPlayerSurface オブジェクトを取得します。これにより、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

オーディオの音量が変更されたときに発生します。

適用対象