次の方法で共有


MediaPlayer を使ったオーディオとビデオの再生

この記事では、MediaPlayer クラスを使用してユニバーサル Windows アプリでメディアを再生する方法を示します。 Windows 10 バージョン 1607 で、メディア再生 API が大幅に強化されました。これには、バックグラウンド オーディオ向けの簡素化された単一プロセス設計、システム メディア トランスポート コントロール (SMTC) との自動統合、複数のメディア プレーヤーを同期する機能、Windows.UI.Composition サーフェスにビデオ フレームをレンダリングする機能、コンテンツでメディアの中断を作成およびスケジュールするための簡単なインターフェイスなどが含まれます。 これらの強化機能を活用できるように、メディアを再生するためのベスト プラクティスとして、メディア再生に MediaElement の代わりに MediaPlayer クラスを使うことが推奨されます。 軽量の XAML コントロールである MediaPlayerElement が導入され、XAML ページのメディア コンテンツをレンダリングできるようになりました。 MediaElement によって提供される再生コントロールと状態 API の多くは、新しい MediaPlaybackSession オブジェクトを通じて利用できるようになりました。 MediaElement は下位互換性をサポートするために今後も動作しますが、このクラスには新しい機能は追加されません。

この記事では、一般的なメディア再生アプリで使う MediaPlayer の機能について説明します。 MediaPlayer は、すべてのメディア項目のコンテナーとして MediaSource クラスを使います。 このクラスを使うと、すべて同じインターフェイスを使って、ローカル ファイル、メモリ ストリーム、ネットワーク ソースなど、さまざまなソースからメディアを読み込んで再生できます。 MediaPlaybackItemMediaPlaybackList など、MediaSource と共に使用できる上位レベルのクラスもあります。これらは、プレイリストや、複数のオーディオ、ビデオ、メタデータ トラックでメディア ソースを管理する機能など、より高度な機能を提供します。 MediaSource および関連 API について詳しくは、「メディア項目、プレイリスト、トラック」をご覧ください。

注意

Windows 10 N および Windows 10 KN エディションには、再生用の MediaPlayer を使用するために必要なメディア機能が含まれません。 これらの機能は手動でインストールすることができます。 詳細については、「Windows 10 N エディションおよび Windows 10 KN エディション用の Media Feature Pack」を参照してください。

MediaPlayer でメディア ファイルを再生する

MediaPlayer を使った基本的なメディア再生は非常に簡単に実装できます。 まず、MediaPlayer クラスの新しいインスタンスを作成します。 アプリは、複数の MediaPlayer のインスタンスを同時にアクティブにすることができます。 次に、プレイヤーの Source プロパティを、MediaSourceMediaPlaybackItemMediaPlaybackList など、IMediaPlaybackSource を実装するオブジェクトに設定します。 この例では、アプリのローカル ストレージにあるファイルから MediaSource が作成された後、MediaPlaybackItem がソースから作成されて、プレイヤーの Source プロパティに割り当てられます。

MediaElement とは異なり、MediaPlayer は既定では自動的に再生を開始しません。 再生を開始するには、Play を呼び出すか、AutoPlay プロパティを true に設定するか、またはユーザーが組み込みのメディア コントロールを使って再生を開始するのを待ちます。

mediaPlayer = new MediaPlayer();
mediaPlayer.Source = MediaSource.CreateFromUri(new Uri("ms-appx:///Assets/example_video.mkv"));
mediaPlayer.Play();

アプリが MediaPlayer を使って実行されたときは、Close メソッド (C# で Dispose に投影される) を呼び出して、プレーヤーで使われるリソースをクリーンアップしてください。

mediaPlayer.Dispose();

MediaPlayerElement を使って XAML でビデオをレンダリングする

メディアを XAML で表示せずに MediaPlayer で再生することはできますが、多くのメディア再生アプリは XAML ページでメディアをレンダリングします。 これを行うには、軽量な MediaPlayerElement コントロールを使います。 MediaElement と同様に、MediaPlayerElement でも組み込みのトランスポート コントロールを表示するかどうかを指定することができます。

<MediaPlayerElement x:Name="_mediaPlayerElement" AreTransportControlsEnabled="False" HorizontalAlignment="Stretch"  Grid.Row="0"/>

SetMediaPlayer を呼び出して、要素がバインドされている MediaPlayer インスタンスを設定することができます。

_mediaPlayerElement.SetMediaPlayer(mediaPlayer);

MediaPlayerElement での再生ソースを設定することもできます。その場合、要素は自動的に MediaPlayer プロパティを使ってアクセスできる新しい MediaPlayer インスタンスを作成します。

Note

MediaPlayerElement プロパティを設定すると、基になる MediaPlayer に対応するプロパティが設定されます。 MediaPlayerElement プロパティを使用する代わりに、基になる MediaPlayer を直接使用することもできます。 同等の MediaPlayerElement プロパティを使用できる場合MediaPlayerを直接使用すると、予期しない動作が発生する可能性があることに注意してください。 これは、MediaPlayerElement が基になる MediaPlayer に対して発生するすべてのことを認識していないためです。 たとえば、ソースを MediaPlayer に直接設定した場合、 MediaPlayerElement Source プロパティは変更を反映しません。 このため、 MediaPlayerElement プロパティを使用するか、基になる MediaPlayer を直接使用する場合に一貫性を持つ必要があります。

_mediaPlayerElement.Source = MediaSource.CreateFromUri(new Uri("ms-appx:///Assets/example_video.mkv"));
mediaPlayer = _mediaPlayerElement.MediaPlayer;
mediaPlayer.Play();

Note

IsEnabled を false に設定して、MediaPlayerMediaPlaybackCommandManager を無効にすると、MediaPlayerElement で提供される MediaPlayerTransportControls の間のリンクが解除されます。このため組み込みトランスポート コントロールはプレーヤーの再生を自動的に制御しなくなります。 代わりに、独自のコントロールを実装して、MediaPlayer を制御する必要があります。

MediaPlayerは、MediaPlayerElementが破棄されたとき、または新しい MediaPlayerSetMediaPlayer を使用して設定されたときにMediaPlayerElement からデタッチされます。 デタッチすると、MediaPlayerElementは、基になるMediaPlayerMediaPlayerElement によって作成されたか、SetMediaPlayer を使用して設定されたかによって異なる方法で処理されます。

MediaPlayerMediaPlayerElement によって作成された場合、MediaPlayerClose が適切にされます。 MediaPlayerMediaPlayerElement SetMediaPlayer を使用して設定されている場合は、MediaPlayerが適切に閉じられるようにする必要があります。 そうしないと、 MediaPlayer で致命的な再生エラーが発生する可能性があります。 次のコード スニペットは、コード内で適切にデタッチして閉じる方法を示しています。

// Get a reference to the current media source.
IMediaPlaybackSource _mediaPlayerElement = _mediaPlayerElement.Source;

// Pause playback if able.
if (mediaPlayer.PlaybackSession.CanPause)
{
    mediaPlayer.Pause();
}

// Disconnect the MediaPlayer from its source. This can be done by setting 
// the MediaPlayerElement Source property to null or by directly setting the
// source to null on the underlying MediaPlayer.
_mediaPlayerElement.Source = null;

// Disconnect the MediaPlayer from MediaPlayerElement.
_mediaPlayerElement.SetMediaPlayer(null);

// Dispose of the MediaPlayer or Source if they're no longer needed.
if (source is MediaSource mediaSource)
{
    mediaSource.Dispose();
}

mediaPlayer.Dispose();

MediaPlayer の一般的なタスク

このセクションでは、MediaPlayer の一部の機能の使用方法を示します。

オーディオ カテゴリの設定

MediaPlayerAudioCategory プロパティを MediaPlayerAudioCategory 列挙値のいずれかの値に設定して、再生しているメディアの種類をシステムに知らせます。 ゲームでは、別のアプリケーションがバックグラウンドで音楽を再生する場合にゲームの音楽が自動的にミュートされるように、ゲームの音楽ストリームを GameMedia として分類してください。 音楽またはビデオ アプリケーションでは、ストリームの優先順位が GameMedia ストリームより高くなるように、ストリームを Media または Movie として分類してください。

mediaPlayer.AudioCategory = MediaPlayerAudioCategory.Media;

特定のオーディオ エンドポイントへの出力

既定では、MediaPlayer からのオーディオ出力はシステムの既定のオーディオ エンドポイントに送られますが、MediaPlayer が出力用に使う特定のオーディオ エンドポイントを指定することもできます。 次の例では、 MediaDevice.GetAudioRenderSelector は、デバイスのオーディオ レンダリング カテゴリを一意に識別する文字列を返します。 次に、DeviceInformation メソッドの FindAllAsync を呼び出して、選択した種類の利用可能なデバイスの一覧を取得します。 プログラムを使ってどのデバイスを使うかを判断することも、返されたデバイスを ComboBox に追加してユーザーにデバイスの選択をゆだねることもできます。

string audioSelector = MediaDevice.GetAudioRenderSelector();
var outputDevices = await DeviceInformation.FindAllAsync(audioSelector);
foreach (var device in outputDevices)
{
    var deviceItem = new ComboBoxItem();
    deviceItem.Content = device.Name;
    deviceItem.Tag = device;
    _audioDeviceComboBox.Items.Add(deviceItem);
}

デバイス コンボ ボックスの SelectionChanged イベントで、MediaPlayerAudioDevice プロパティが選択されたデバイスに設定されます。これは、ComboBoxItemTag プロパティに格納されていました。

private void _audioDeviceComboBox_SelectionChanged(object sender, SelectionChangedEventArgs e)
{
    DeviceInformation selectedDevice = (DeviceInformation)((ComboBoxItem)_audioDeviceComboBox.SelectedItem).Tag;
    if (selectedDevice != null)
    {
        mediaPlayer.AudioDevice = selectedDevice;
    }
}

再生セッション

この記事の前の方で説明したように、MediaElement クラスによって公開される関数の多くは MediaPlaybackSession クラスに移されました。 これには、現在の再生位置、プレーヤーが一時停止しているか再生中か、現在の再生速度など、プレーヤーの再生状態に関する情報が含まれています。 MediaPlaybackSession は、再生中のコンテンツの現在のバッファリングおよびダウンロードの状態や、現在再生中のビデオ コンテンツの自然なサイズと縦横比などの状態が変わったときに通知するイベントもいくつか提供します。

次の例は、コンテンツを 10 秒前にスキップするボタン クリック ハンドラーを実装する方法を示しています。 まず、プレイヤーの MediaPlaybackSession オブジェクトが PlaybackSession プロパティで取得されます。 次に、Position プロパティが現在の再生位置に 10 秒加えた位置に設定されます。

private void _skipForwardButton_Click(object sender, RoutedEventArgs e)
{
    var session = mediaPlayer.PlaybackSession;
    session.Position = session.Position + TimeSpan.FromSeconds(10);
}

次の例は、セッションの PlaybackRate プロパティを設定して通常の再生速度と 2 倍の速度を切り替えるトグル ボタンを示しています。

private void _speedToggleButton_Checked(object sender, RoutedEventArgs e)
{
    mediaPlayer.PlaybackSession.PlaybackRate = 2.0;
}
private void _speedToggleButton_Unchecked(object sender, RoutedEventArgs e)
{
    mediaPlayer.PlaybackSession.PlaybackRate = 1.0;
}

Windows 10 バージョン 1803 以降では、MediaPlayer でビデオが表示される回転を 90 度単位で設定できます。

mediaPlayer.PlaybackSession.PlaybackRotation = MediaRotation.Clockwise90Degrees;

予期されたバッファー処理と予期しないバッファー処理の検出

前のセクションで説明した MediaPlaybackSession オブジェクトでは、BufferingStartedBufferingEnded という 2 つのイベントによって、現在再生中のメディアファイルが開始および停止した時点を検出します。 これにより、バッファー処理が行われていることを UI を更新の更新によってユーザーに表示できます。 初期バッファー処理は、メディア ファイルが最初に開かれたとき、またはユーザーが再生リスト内の新しい項目に切り替えたときに発生する予期されるバッファー処理です。 予期しないバッファー処理は、ネットワーク速度が低下したとき、またはコンテンツを提供するコンテンツ管理システムに、技術的な問題が起こった場合に発生する可能性があります。 RS3 以降では、BufferingStarted イベントを使用して、バッファー処理イベントが予期されたものか、それとも予期しないイベントであって、再生が中断されるのかを判断できます。 この情報は、アプリまたはメディア配信サービスのテレメトリ データとして使用できます。

バッファー処理の状態通知を受け取るには、BufferingStarted イベントと BufferingEnded イベントのハンドラーを登録します。

mediaPlayer.PlaybackSession.BufferingStarted += MediaPlaybackSession_BufferingStarted;
mediaPlayer.PlaybackSession.BufferingEnded += MediaPlaybackSession_BufferingEnded;

BufferingStartedイベント ハンドラーで、このイベントに渡されたイベント引数を MediaPlaybackSessionBufferingStartedEventArgs オブジェクトにキャストし、IsPlaybackInterruption プロパティを確認します。 この値が true の場合、イベントをトリガーしたバッファー処理は予期しないものであり、再生が中断されます。 そうでない場合は、予想された初期バッファー処理です。

private void MediaPlaybackSession_BufferingStarted(MediaPlaybackSession sender, object args)
{
    MediaPlaybackSessionBufferingStartedEventArgs bufferingStartedEventArgs = args as MediaPlaybackSessionBufferingStartedEventArgs;
    if (bufferingStartedEventArgs != null && bufferingStartedEventArgs.IsPlaybackInterruption)
    {
        // update the playback quality telemetry report to indicate that
        // playback was interrupted
    }

    // update the UI to indicate that playback is buffering
}
private void MediaPlaybackSession_BufferingEnded(MediaPlaybackSession sender, object args)
{
    // update the UI to indicate that playback is no longer buffering
}

ビデオのピンチおよびズーム

MediaPlayer では、ビデオ コンテンツの中にレンダリングするソースの四角形を指定して、効果的にビデオを拡大することができます。 指定する四角形は、正規化された四角形 (0,0,1,1) を基準とします。0,0 はフレームの左上、1,1 はフレームの全幅と全高です。 たとえば、ビデオを 4 分割した右上の領域がレンダリングされるようにズーム四角形を設定するには、四角形 (.5,0,.5,.5) を指定します。 ソースの四角形が正規化された四角形 (0,0,1,1) の内部にあるように値を確認することが重要です。 この範囲外の値を設定しようとすると、例外がスローされます。

マルチタッチ ジェスチャを使ってピンチおよびズームを実装するには、まずどのジェスチャをサポートするかを指定する必要があります。 この例では、拡大縮小と移動のジェスチャが要求されています。 サブスクライブしているジェスチャのいずれかが発生すると、ManipulationDelta イベントが発生します。 ズームをフレーム全体にリセットするために、DoubleTapped イベントが使用されます。

_mediaPlayerElement.ManipulationMode = ManipulationModes.Scale | ManipulationModes.TranslateX | ManipulationModes.TranslateY;
_mediaPlayerElement.ManipulationDelta += _mediaPlayerElement_ManipulationDelta;
_mediaPlayerElement.DoubleTapped += _mediaPlayerElement_DoubleTapped;

次に、現在のズーム ソースの四角形を格納する Rect オブジェクトを宣言します。

Rect _sourceRect = new Rect(0, 0, 1, 1);

ManipulationDelta ハンドラーは、ズーム四角形の拡大縮小または移動を調整します。 デルタ スケールの値が 1 でない場合、それはユーザーがピンチ ジェスチャを実行したことを意味します。 値が 1 より大きい場合、コンテンツを拡大するにはソースの四角形を小さくする必要があります。 値が 1 より小さい場合、縮小するにはソースの四角形を大きくする必要があります。 新しいスケール値を設定する前に、結果の四角形がチェックされ、全体が (0,0,1,1) の範囲内にあることが確認されます。

スケール値が 1 の場合、移動ジェスチャが処理されます。 四角形は、ジェスチャのピクセル数をコントロールの幅と高さで割った値だけ移動されます。 ここでも、結果の四角形がチェックされ、(0,0,1,1) の範囲内にあることが確認されます。

最後に、MediaPlaybackSessionNormalizedSourceRect が新たに調整された四角形に設定され、レンダリングするビデオ フレーム内の領域が指定されます。

private void _mediaPlayerElement_ManipulationDelta(object sender, ManipulationDeltaRoutedEventArgs e)
{

    if (e.Delta.Scale != 1)
    {
        var halfWidth = _sourceRect.Width / 2;
        var halfHeight = _sourceRect.Height / 2;

        var centerX = _sourceRect.X + halfWidth;
        var centerY = _sourceRect.Y + halfHeight;

        var scale = e.Delta.Scale;
        var newHalfWidth = (_sourceRect.Width * e.Delta.Scale) / 2;
        var newHalfHeight = (_sourceRect.Height * e.Delta.Scale) / 2;

        if (centerX - newHalfWidth > 0 && centerX + newHalfWidth <= 1.0 &&
            centerY - newHalfHeight > 0 && centerY + newHalfHeight <= 1.0)
        {
            _sourceRect.X = centerX - newHalfWidth;
            _sourceRect.Y = centerY - newHalfHeight;
            _sourceRect.Width *= e.Delta.Scale;
            _sourceRect.Height *= e.Delta.Scale;
        }
    }
    else
    {
        var translateX = -1 * e.Delta.Translation.X / _mediaPlayerElement.ActualWidth;
        var translateY = -1 * e.Delta.Translation.Y / _mediaPlayerElement.ActualHeight;

        if (_sourceRect.X + translateX >= 0 && _sourceRect.X + _sourceRect.Width + translateX <= 1.0 &&
            _sourceRect.Y + translateY >= 0 && _sourceRect.Y + _sourceRect.Height + translateY <= 1.0)
        {
            _sourceRect.X += translateX;
            _sourceRect.Y += translateY;
        }
    }

    mediaPlayer.PlaybackSession.NormalizedSourceRect = _sourceRect;
}

DoubleTapped イベント ハンドラーで、ビデオ フレーム全体がレンダリングされるようにソースの四角形が (0,0,1,1) に戻されます。

private void _mediaPlayerElement_DoubleTapped(object sender, DoubleTappedRoutedEventArgs e)
{
    _sourceRect = new Rect(0, 0, 1, 1);
    mediaPlayer.PlaybackSession.NormalizedSourceRect = _sourceRect;
}

このセクションでは、タッチ入力について説明しています。 タッチパッドはポインター イベントを送信し、操作イベントは送信しません。

ポリシーベースの再生品質低下の処理

状況によっては、システムが、パフォーマンスの問題ではなく、ポリシーに基づいて、メディア項目の再生品質を低下させることがあります。これは解像度の低下 (圧縮) などの形で行われます。 たとえば、符号なしのビデオ ドライバーを使用して再生されている場合、システムによってビデオが低下する可能性があります。 MediaPlaybackSession.GetOutputDegradationPolicyState を呼び出して、このポリシー ベースの低下が発生しているかどうかを判断し、ユーザーに警告したり、テレメトリの目的の理由を記録したりすることができます。

次の例では、プレイヤーが新しいメディア項目を開いたときに発生する MediaPlayer.MediaOpened イベントのハンドラーの実装を示します。 ハンドラーに渡された MediaPlayer に対して GetOutputDegradationPolicyStateが呼び出されます。 VideoConstrictionReason の値は、ビデオが圧縮されているポリシー上の理由を示します。 以下の例では、値が None 以外の場合、テレメトリの目的で低下理由をログに記録します。 この例ではまた、ビデオが圧縮されていて、いずれにしても高品位で表示されないときに、データ使用量を節減するために、現在再生中の AdaptiveMediaSource のビットレートを最低帯域幅に設定する方法が示されています。 AdaptiveMediaSource の使用方法について詳しくは、「アダプティブ ストリーミング」をご覧ください。

private void MediaPlayer_MediaOpened(MediaPlayer sender, object args)
{
    MediaPlaybackSessionOutputDegradationPolicyState info = sender.PlaybackSession.GetOutputDegradationPolicyState();

    if (info.VideoConstrictionReason != MediaPlaybackSessionVideoConstrictionReason.None)
    {
        // Switch to lowest bitrate to save bandwidth
        adaptiveMediaSource.DesiredMaxBitrate = adaptiveMediaSource.AvailableBitrates[0];

        // Log the degradation reason or show a message to the user
        System.Diagnostics.Debug.WriteLine("Logging constriction reason: " + info.VideoConstrictionReason);
    }
}

MediaPlayerSurface を使って、Windows.UI.Composition サーフェスにビデオをレンダリングする

Windows 10 バージョン 1607 以降では、 MediaPlayer を使用してビデオを ICompositionSurface にレンダリングできます。これにより、プレーヤーは Windows.UI.Composition 名前空間の API と相互運用できます。 コンポジション フレームワークを使うと、XAML と低レベルの DirectX グラフィックス API の間のビジュアル レイヤーでグラフィックスを操作することができます。 これにより、任意の XAML コントロールにビデオをレンダリングするようなシナリオが可能になります。 コンポジション API の使い方について詳しくは、「ビジュアル レイヤー」をご覧ください。

次の例に、ビデオ プレーヤーのコンテンツを Canvas コントロールにレンダリングする方法を示します。 この例でのメディア プレーヤー固有の呼び出しは、SetSurfaceSizeGetSurface です。 SetSurfaceSize は、コンテンツのレンダリングに割り当てるバッファのサイズをシステムに伝えます。 GetSurface は引数として Compositor を受け取り、 MediaPlayerSurface クラスのインスタンスを取得します。 このクラスは、サーフェスを作成するために使われる MediaPlayerCompositor へのアクセスを提供し、CompositionSurface プロパティを通じてサーフェス自体を公開します。

この例の残りのコードでは、ビデオをレンダリングする SpriteVisual を作成し、そのサイズをビジュアルを表示するキャンバス要素のサイズに設定します。 次に、MediaPlayerSurface から CompositionBrush が作成され、ビジュアルの Brush プロパティに割り当てられます。 そして、ContainerVisual が作成され、そのビジュアル ツリーの一番上に SpriteVisual が挿入されます。 最後に、SetElementChildVisual を呼び出してコンテナー ビジュアルを Canvas に割り当てます。

mediaPlayer.SetSurfaceSize(new Size(_compositionCanvas.ActualWidth, _compositionCanvas.ActualHeight));

var compositor = ElementCompositionPreview.GetElementVisual(this).Compositor;
MediaPlayerSurface surface = mediaPlayer.GetSurface(compositor);

SpriteVisual spriteVisual = compositor.CreateSpriteVisual();
spriteVisual.Size =
    new System.Numerics.Vector2((float)_compositionCanvas.ActualWidth, (float)_compositionCanvas.ActualHeight);

CompositionBrush brush = compositor.CreateSurfaceBrush(surface.CompositionSurface);
spriteVisual.Brush = brush;

ContainerVisual container = compositor.CreateContainerVisual();
container.Children.InsertAtTop(spriteVisual);

ElementCompositionPreview.SetElementChildVisual(_compositionCanvas, container);

MediaTimelineController を使って複数のプレイヤー全体でコンテンツを同期する

この記事で前に説明したように、アプリは複数の MediaPlayer オブジェクトを一度にアクティブにすることができます。 既定では、作成する MediaPlayer はそれぞれ独立して動作します。 コメント トラックからビデオへの同期などの一部のシナリオでは、複数のプレーヤーの状態、再生位置、および再生速度を同期することもできます。 Windows 10 バージョン 1607 以降では、MediaTimelineController クラスを使ってこの動作を実装できます。

再生コントロールを実装する

次の例は、MediaTimelineController を使って MediaPlayer の 2 つのインスタンスを制御する方法を示しています。 まず、MediaPlayer の各インスタンスがインスタンス化され、Source がメディア ファイルに設定されます。 次に、新しい MediaTimelineController が作成されます。 MediaPlayer ごとに、IsEnabled プロパティを false に設定することで、各プレーヤー関連付けられている MediaPlaybackCommandManager が無効にされます。 次に、TimelineController プロパティがタイムライン コント ローラー オブジェクトに設定されます。

MediaTimelineController _mediaTimelineController;
mediaPlayer = new MediaPlayer();
mediaPlayer.Source = MediaSource.CreateFromUri(new Uri("ms-appx:///Assets/example_video.mkv"));
_mediaPlayerElement.SetMediaPlayer(mediaPlayer);


_mediaPlayer2 = new MediaPlayer();
_mediaPlayer2.Source = MediaSource.CreateFromUri(new Uri("ms-appx:///Assets/example_video_2.mkv"));
_mediaPlayerElement2.SetMediaPlayer(_mediaPlayer2);

_mediaTimelineController = new MediaTimelineController();

mediaPlayer.CommandManager.IsEnabled = false;
mediaPlayer.TimelineController = _mediaTimelineController;

_mediaPlayer2.CommandManager.IsEnabled = false;
_mediaPlayer2.TimelineController = _mediaTimelineController;

注意MediaPlaybackCommandManager は、MediaPlayer とシステム メディア トランスポート コントロール (SMTC) の間の自動統合を提供しますが、この自動統合は MediaTimelineController で制御されるメディア プレイヤーでは使うことはできません。 そのため、プレーヤーのタイムライン コント ローラーを設定する前に、メディア プレイヤーのコマンド マネージャーを無効にする必要があります。 そうしないと、"オブジェクトの現在の状態により、メディア タイムライン コントローラーのアタッチがブロックされています。" というメッセージが表示され、例外がスローされます。SMTC とのメディア プレーヤーの統合の詳細については、「システム メディア トランスポート コントロールとの統合」を参照してください。 MediaTimelineController 使っている場合は、SMTC を手動で制御できます。 詳しくは、「システム メディア トランスポート コントロールの手動制御」をご覧ください。

1 つ以上のメディア プレーヤーに MediaTimelineController をアタッチしている場合は、コント ローラーによって公開されているメソッドを使って再生状態を制御できます。 次の例では、Start を呼び出して、メディアの開始部で関連付けられたすべてのメディア プレーヤーの再生を開始します。

private void PlayButton_Click(object sender, RoutedEventArgs e)
{
    _mediaTimelineController.Start();
}

この例は、アタッチされたすべてのメディア プレーヤーの一時停止と再開を示しています。

private void PauseButton_Click(object sender, RoutedEventArgs e)
{
    if(_mediaTimelineController.State == MediaTimelineControllerState.Running)
    {
        _mediaTimelineController.Pause();
        _pauseButton.Content = "Resume";
    }
    else
    {
        _mediaTimelineController.Resume();
        _pauseButton.Content = "Pause";
    }
}

接続されているすべてのメディア プレーヤーを早送りするには、再生速度を 1 より大きい値に設定します。

private void FastForwardButton_Click(object sender, RoutedEventArgs e)
{
    _mediaTimelineController.ClockRate = 2.0;
}

次の例は、スライダー コントロールを使って、接続されているメディア プレーヤーの 1 つのコンテンツの再生時間を基準としてタイムライン コント ローラーの現在の再生位置を表示する方法を示しています。 まず、新しい MediaSource が作成され、メディア ソースの OpenOperationCompleted のハンドラーが登録されます。

var mediaSource = MediaSource.CreateFromUri(new Uri("ms-appx:///Assets/example_video.mkv"));
mediaSource.OpenOperationCompleted += MediaSource_OpenOperationCompleted;
mediaPlayer.Source = mediaSource;
_mediaPlayerElement.SetMediaPlayer(mediaPlayer);

OpenOperationCompleted ハンドラーは、メディア ソースのコンテンツの再生時間を検出する契機になります。 再生時間が決定されると、Slider コントロールの最大値がメディア項目の合計秒数に設定されます。 RunAsync の呼び出しの中で値を設定して、UI スレッドで実行されていることを確認します。

TimeSpan _duration;
private async void MediaSource_OpenOperationCompleted(MediaSource sender, MediaSourceOpenOperationCompletedEventArgs args)
{
    _duration = sender.Duration.GetValueOrDefault();

    await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () =>
    {
        _positionSlider.Minimum = 0;
        _positionSlider.Maximum = _duration.TotalSeconds;
        _positionSlider.StepFrequency = 1;
    }); 
}

次に、タイムライン コント ローラーの PositionChanged イベントのハンドラーを登録します。 これは 1 秒間に 4 回程度、システムによって定期的に呼び出されます。

_mediaTimelineController.PositionChanged += _mediaTimelineController_PositionChanged;

PositionChanged のハンドラーで、タイムライン コント ローラーの現在位置を反映するようにスライダーの値が更新されます。

private async void _mediaTimelineController_PositionChanged(MediaTimelineController sender, object args)
{
    if (_duration != TimeSpan.Zero)
    {
        await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () =>
        {
            _positionSlider.Value = sender.Position.TotalSeconds / (float)_duration.TotalSeconds;
        });
    }
}

タイムラインの位置から再生位置をオフセットする

場合によっては、タイムライン コント ローラーに関連付けられている 1 つ以上のメディア プレーヤーの再生位置に、他のプレーヤーからのオフセットを付けたいことがあります。 これを行うには、オフセットを付ける MediaPlayer オブジェクトの TimelineControllerPositionOffset プロパティを設定します。 次の例では、2 つのメディア プレーヤーのコンテンツの再生時間を使って、項目の長さを加えるか差し引くように 2 つのスライダー コントロールの最小値と最大値を設定しています。

_timelineOffsetSlider1.Minimum = -1 * _duration.TotalSeconds;
_timelineOffsetSlider1.Maximum = _duration.TotalSeconds;
_timelineOffsetSlider1.StepFrequency = 1;

_timelineOffsetSlider2.Minimum = -1 * _duration2.TotalSeconds;
_timelineOffsetSlider2.Maximum = _duration2.TotalSeconds;
_timelineOffsetSlider2.StepFrequency = 1;

各スライダーの ValueChanged イベントで、各プレーヤーの TimelineControllerPositionOffset が対応する値に設定されます。

private void _timelineOffsetSlider1_ValueChanged(object sender, RangeBaseValueChangedEventArgs e)
{
    mediaPlayer.TimelineControllerPositionOffset = TimeSpan.FromSeconds(_timelineOffsetSlider1.Value);
}

private void _timelineOffsetSlider2_ValueChanged(object sender, RangeBaseValueChangedEventArgs e)
{
    _mediaPlayer2.TimelineControllerPositionOffset = TimeSpan.FromSeconds(_timelineOffsetSlider2.Value);
}

プレーヤーのオフセット値が負の再生位置にマップされる場合は、オフセットがゼロになるまでクリップは一時停止のままになり、その後に再生が開始されます。 同様に、オフセット値がメディア項目の再生時間を超える再生位置にマップされる場合は、1 つのメディア プレーヤーがそのコンテンツの最後に達したときのように最終フレームが表示されます。

MediaPlayer を使った球面ビデオの再生

Windows 10 Version 1703 以降、MediaPlayer は、球面ビデオ再生のための正距円筒図法をサポートしています。 球面ビデオ コンテンツは、ビデオ エンコードがサポートされている限り、MediaPlayer がビデオを表示するという点において、通常の平面ビデオと同じです。 ビデオが正距円筒図法を使用することを指定するメタデータ タグを含む球面ビデオの場合、MediaPlayer は、指定された視野とビューの向きを使ってビデオを表示できます。 これにより、ヘッド マウント ディスプレイによる仮想現実ビデオの再生や、ユーザーがマウスまたはキーボード入力で球面ビデオ コンテンツ内でパンできるようにするなどのシナリオが実現されます。

球面ビデオを再生するには、この記事で既に説明したビデオ コンテンツを再生するための手順を使用します。 1 つ追加される手順は、MediaPlayer.MediaOpened イベントのハンドラーを登録することです。 このイベントにより、球面ビデオの再生パラメーターが有効化され、制御できるようになります。

mediaPlayer = new MediaPlayer();
mediaPlayer.MediaOpened += _mediaPlayer_MediaOpened;
mediaPlayer.Source = MediaSource.CreateFromUri(new Uri("ms-appx:///Assets/example_video_spherical.mp4"));
_mediaPlayerElement.SetMediaPlayer(mediaPlayer);
mediaPlayer.Play();

MediaOpened ハンドラーで、最初に PlaybackSession.SphericalVideoProjection.FrameFormat プロパティを調べて、新しく開かれたメディア項目のフレーム形式を確認します。 この値が SphericaVideoFrameFormat.Equirectangular である場合、システムは自動的にビデオ コンテンツを投影できます。 最初に、PlaybackSession.SphericalVideoProjection.IsEnabled プロパティを true に設定します。 メディア プレーヤーがビデオ コンテンツを投影する際に使用するビューの向きや視野などのプロパティを調整することもできます。 この例では、HorizontalFieldOfViewInDegrees プロパティを設定することによって、120 度という広い視野の値を設定しています。

ビデオ コンテンツが球面でも、正距円筒図法以外の形式である場合は、メディア プレーヤーのフレーム サーバー モードを使用して個々のフレームを受信し、処理することで、独自の投影アルゴリズムを実装できます。

private void _mediaPlayer_MediaOpened(MediaPlayer sender, object args)
{
    if (sender.PlaybackSession.SphericalVideoProjection.FrameFormat == SphericalVideoFrameFormat.Equirectangular)
    {
        sender.PlaybackSession.SphericalVideoProjection.IsEnabled = true;
        sender.PlaybackSession.SphericalVideoProjection.HorizontalFieldOfViewInDegrees = 120;

    }
    else if (sender.PlaybackSession.SphericalVideoProjection.FrameFormat == SphericalVideoFrameFormat.Unsupported)
    {
        // If the spherical format is unsupported, you can use frame server mode to implement a custom projection
    }
}

次のコード例は、左右の方向キーを使って球面ビデオのビューの向きを調整する方法を示しています。

protected override void OnKeyDown(KeyRoutedEventArgs e)
{
    if (mediaPlayer.PlaybackSession.SphericalVideoProjection.FrameFormat != SphericalVideoFrameFormat.Equirectangular)
    {
        return;
    }

    switch (e.Key)
    {
        case Windows.System.VirtualKey.Right:
            mediaPlayer.PlaybackSession.SphericalVideoProjection.ViewOrientation *= Quaternion.CreateFromYawPitchRoll(.1f, 0, 0);
            break;
        case Windows.System.VirtualKey.Left:
            mediaPlayer.PlaybackSession.SphericalVideoProjection.ViewOrientation *= Quaternion.CreateFromYawPitchRoll(-.1f, 0, 0);
            break;
    }
}

アプリでビデオの再生リストをサポートしている場合、UI で球面ビデオを含む再生項目の識別が必要になることがあります。 メディアの再生リストについて詳しくは、「メディア項目、プレイリスト、トラック」の記事をご覧ください。 次の例では、新しい再生リストの作成、項目の追加、MediaPlaybackItem.VideoTracksChanged イベント (メディア項目のビデオ トラックを解決するときに発生する) のハンドラーの登録の方法を示します。

var playbackList = new MediaPlaybackList();
var item = new MediaPlaybackItem(MediaSource.CreateFromUri(new Uri("ms-appx:///Assets/RIFTCOASTER HD_injected.mp4")));
item.VideoTracksChanged += Item_VideoTracksChanged;
playbackList.Items.Add(item);
mediaPlayer.Source = playbackList;

VideoTracksChangedイベント ハンドラーで、VideoTrack.GetEncodingProperties を呼び出すことによって、追加されたビデオ トラックのエンコード プロパティを取得します。 エンコード プロパティの SphericalVideoFrameFormat プロパティが、SphericaVideoFrameFormat.None 以外の値である場合、ビデオ トラックには球面ビデオが含まれており、選択した場合は適切に UI を更新できます。

private void Item_VideoTracksChanged(MediaPlaybackItem sender, IVectorChangedEventArgs args)
{
    if (args.CollectionChange != CollectionChange.ItemInserted)
    {
        return;
    }
    foreach (var videoTrack in sender.VideoTracks)
    {
        if (videoTrack.GetEncodingProperties().SphericalVideoFrameFormat != SphericalVideoFrameFormat.None)
        {
            // Optionally indicate in the UI that this item contains spherical video
        }
    }
}

フレーム サーバー モードでの MediaPlayer の使用

Windows 10 Version 1703 以降では、フレーム サーバー モードで MediaPlayer を使用できます。 このモードでは、MediaPlayer は、関連付けられている MediaPlayerElement にフレームを自動的には表示しません。 代わりに、アプリが、MediaPlayer から IDirect3DSurface を実装するオブジェクトに現在のフレームをコピーします。 この機能により実現される主要なシナリオは、MediaPlayer によって提供されるビデオ フレームをピクセル シェーダーを使用して処理することです。 処理後、アプリが XAML Image コントロールでフレームを表示するなどの方法で、各フレームを表示します。

次の例では、新しい MediaPlayer が初期化され、ビデオ コンテンツが読み込まれます。 次に、VideoFrameAvailable のハンドラーが登録されます。 MediaPlayer オブジェクトの IsVideoFrameServerEnabled プロパティを true に設定することによって、フレーム サーバー モードが有効になります。 最後に、Play の呼び出しによってメディアの再生が開始されます。

mediaPlayer = new MediaPlayer();
mediaPlayer.Source = MediaSource.CreateFromUri(new Uri("ms-appx:///Assets/example_video.mkv"));
mediaPlayer.VideoFrameAvailable += mediaPlayer_VideoFrameAvailable;
mediaPlayer.IsVideoFrameServerEnabled = true;
mediaPlayer.Play();

次の例は、Win2D を使用してビデオの各フレームに単純なぼかし効果を追加し、処理されたフレームを XAML Image コントロールで表示する VideoFrameAvailable ハンドラーを示しています。

VideoFrameAvailable ハンドラーが呼び出されるたびに、CopyFrameToVideoSurface メソッドを使用して、フレームの内容が IDirect3DSurface にコピーされます。 CopyFrameToStereoscopicVideoSurfaces を使用して 3D コンテンツを 2 つのサーフェスにコピーし、左目用と右目用のコンテンツを個別に処理することもできます。 IDirect3DSurface を実装するオブジェクトを取得するため、この例では、SoftwareBitmap を作成し、そのオブジェクトを使って、必要なインターフェイスを実装する Win2D CanvasBitmap を作成します。 CanvasImageSourceImage コントロールのソースとして使用できる Win2D オブジェクトであるため、新しいオブジェクトを作成し、コンテンツを表示する Image のソースとして設定しています。 次に、CanvasDrawingSession が作成されます。 これは、Win2D でぼかし効果のレンダリングに使用されます。

必要なオブジェクトがすべてインスタンス化されると、CopyFrameToVideoSurface が呼び出され、MediaPlayer から CanvasBitmap に現在のフレームがコピーされます。 次に、Win2D GaussianBlurEffectが作成され、操作のソースとして CanvasBitmap が設定されます。 最後に、CanvasDrawingSession.DrawImage が呼び出され、ぼかし効果が適用されたソース画像が、Image コントロールに関連付けられた CanvasImageSource に描画され、それが UI に描画されます。

private async void mediaPlayer_VideoFrameAvailable(MediaPlayer sender, object args)
{
    CanvasDevice canvasDevice = CanvasDevice.GetSharedDevice();

    await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () =>
    {
        if(frameServerDest == null)
        {
            // FrameServerImage in this example is a XAML image control
            frameServerDest = new SoftwareBitmap(BitmapPixelFormat.Rgba8, (int)FrameServerImage.Width, (int)FrameServerImage.Height, BitmapAlphaMode.Ignore);
        }
        if(canvasImageSource == null)
        {
            canvasImageSource = new CanvasImageSource(canvasDevice, (int)FrameServerImage.Width, (int)FrameServerImage.Height, DisplayInformation.GetForCurrentView().LogicalDpi);//96); 
            FrameServerImage.Source = canvasImageSource;
        }

        using (CanvasBitmap inputBitmap = CanvasBitmap.CreateFromSoftwareBitmap(canvasDevice, frameServerDest))
        using (CanvasDrawingSession ds = canvasImageSource.CreateDrawingSession(Windows.UI.Colors.Black))
        {

            mediaPlayer.CopyFrameToVideoSurface(inputBitmap);

            var gaussianBlurEffect = new GaussianBlurEffect
            {
                Source = inputBitmap,
                BlurAmount = 5f,
                Optimization = EffectOptimization.Speed
            };

            ds.DrawImage(gaussianBlurEffect);

        }
    });
}

private void FrameServerSubtitlesButton_Click(object sender, RoutedEventArgs e)
{

    mediaPlayer = new MediaPlayer();
    var source = MediaSource.CreateFromUri(new Uri("ms-appx:///Assets/example_video.mkv"));
    var item = new MediaPlaybackItem(source);

    item.TimedMetadataTracksChanged += Item_TimedMetadataTracksChanged;


    mediaPlayer.Source = item;
    mediaPlayer.VideoFrameAvailable += mediaPlayer_VideoFrameAvailable_Subtitle;
    mediaPlayer.IsVideoFrameServerEnabled = true;
    mediaPlayer.Play();

    mediaPlayer.IsMuted = true;

}

private void Item_TimedMetadataTracksChanged(MediaPlaybackItem sender, IVectorChangedEventArgs args)
{
    if(sender.TimedMetadataTracks.Count > 0)
    {
        sender.TimedMetadataTracks.SetPresentationMode(0, TimedMetadataTrackPresentationMode.PlatformPresented);
    }
}

private async void mediaPlayer_VideoFrameAvailable_Subtitle(MediaPlayer sender, object args)
{
    CanvasDevice canvasDevice = CanvasDevice.GetSharedDevice();

    await Dispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal, () =>
    {
        if (frameServerDest == null)
        {
            // FrameServerImage in this example is a XAML image control
            frameServerDest = new SoftwareBitmap(BitmapPixelFormat.Rgba8, (int)FrameServerImage.Width, (int)FrameServerImage.Height, BitmapAlphaMode.Ignore);
        }
        if (canvasImageSource == null)
        {
            canvasImageSource = new CanvasImageSource(canvasDevice, (int)FrameServerImage.Width, (int)FrameServerImage.Height, DisplayInformation.GetForCurrentView().LogicalDpi);//96); 
            FrameServerImage.Source = canvasImageSource;
        }

        using (CanvasBitmap inputBitmap = CanvasBitmap.CreateFromSoftwareBitmap(canvasDevice, frameServerDest))
        {
            using (CanvasDrawingSession ds = canvasImageSource.CreateDrawingSession(Windows.UI.Colors.Black))
            {

                mediaPlayer.CopyFrameToVideoSurface(inputBitmap);

                //Rect subtitleTargetRect = new Rect(0, 0, inputBitmap.Bounds.Width, inputBitmap.Bounds.Bottom * .1);
                Rect subtitleTargetRect = new Rect(0, 0, 100, 100);

                mediaPlayer.RenderSubtitlesToSurface(inputBitmap);//, subtitleTargetRect);

                //var gaussianBlurEffect = new GaussianBlurEffect
                //{
                //    Source = inputBitmap,
                //    BlurAmount = 5f,
                //    Optimization = EffectOptimization.Speed
                //};

                //ds.DrawImage(gaussianBlurEffect);

                ds.DrawImage(inputBitmap);
            }
        }
    });
}

Win2D について詳しくは、Win2D の GitHub リポジトリをご覧ください。 上記のサンプル コードを試すには、次の手順でプロジェクトにWin2D NuGet パッケージを追加する必要があります。

効果のプロジェクトへの Win2D NuGet パッケージの追加するには

  1. ソリューション エクスプローラーで、プロジェクトを右クリックし、 [NuGet パッケージの管理] を選択します。
  2. ウィンドウの上部で [参照] タブをクリックします。
  3. 検索ボックスに「Win2D」と入力します。
  4. [Win2D.uwp] を選択し、右のウィンドウで [インストール] を選択します。
  5. [変更の確認] ダイアログに、インストールするパッケージが表示されます。 [OK] をクリックします。
  6. パッケージのライセンスに同意します。

システムによるオーディオ レベルの変更を検出して対応する

Windows 10、バージョン 1803 以降では、現在 MediaPlayer で再生されているオーディオ レベルが、システムによって低下した場合やミュートされた場合に、アプリがそれを検出できます。 たとえば、アラームが鳴っているときに、システムがオーディオ再生レベルを下げることがあります ("ダッキング" と呼ばれます)。 アプリ マニフェストで backgroundMediaPlayback 機能が宣言されていない場合、アプリがバックグラウンドに移動すると、システムによってアプリがミュートされます。 AudioStateMonitor クラスを使用すると、オーディオ ストリームの音量がシステムによって変更されたときに、イベントを受け取るように登録できます。 その MediaPlayer のオーディオ レベルがシステムによって変更されたときに通知を受け取るには、MediaPlayerAudioStateMonitor プロパティにアクセスし、SoundLevelChanged イベントのハンドラーを登録します。

mediaPlayer.AudioStateMonitor.SoundLevelChanged += AudioStateMonitor_SoundLevelChanged;

SoundLevelChangedイベントを処理するときは、再生中のコンテンツの種類に応じてさまざまな方法を取ることができます。 たとえば現在音楽を再生中の場合は、ボリュームがダッキングされている間も、そのまま音楽を再生し続けることが考えられます。 しかしポッドキャストを再生中の場合は、ユーザーがコンテンツを聞き逃さないように、ダッキングされている間、再生を一時停止するのが普通です。

以下の例では、現在再生されているコンテンツがポッドキャストかどうかを追跡する変数を宣言しています。この変数は、MediaPlayer のコンテンツを選択するときに、アプリによって適切な値に設定されるものと想定します。 またオーディオ レベルが変更されたためにプログラムによって再生が一時停止された場合に、それを追跡するクラス変数も作成しています。

bool isPodcast;
bool isPausedDueToAudioStateMonitor;

SoundLevelChanged イベント ハンドラーで、AudioStateMonitor センダーの SoundLevel プロパティを確認すると、新しいサウンド レベルを判定できます。 以下の例では、新しいサウンド レベルがフル音量かどうか、つまりシステムが音量のミュートまたはダッキングを停止したかどうか、またはサウンド レベルは低いままだが、ポッドキャスト以外のコンテンツを再生しているかどうかを確認しています。 これらのいずれかが true で、コンテンツがプログラムによって一時停止されている場合、再生が再開されます。 新しいサウンド レベルがミュートされている場合、または現在のコンテンツがポッドキャストでサウンド レベルが低い場合は、再生が一時停止され、一時停止がプログラムによって開始されたことを追跡するように変数が設定されます。

private void AudioStateMonitor_SoundLevelChanged(Windows.Media.Audio.AudioStateMonitor sender, object args)
{
    if ((sender.SoundLevel == SoundLevel.Full) || (sender.SoundLevel == SoundLevel.Low && !isPodcast))
    {
        if (isPausedDueToAudioStateMonitor)
        {
            mediaPlayer.Play();
            isPausedDueToAudioStateMonitor = false;
        }
    }
    else if ((sender.SoundLevel == SoundLevel.Muted) ||
         (sender.SoundLevel == SoundLevel.Low && isPodcast))
    {
        if (mediaPlayer.PlaybackSession.PlaybackState == MediaPlaybackState.Playing)
        {
            mediaPlayer.Pause();
            isPausedDueToAudioStateMonitor = true;
        }
    }

}

オーディオがシステムによってダッキングされている場合でも、再生を一時停止するか続行するかをユーザーが選択することがあります。 以下の例では、再生と一時停止ボタンのイベント ハンドラーを示します。 一時停止ボタンのクリック ハンドラーでは、再生がプログラムによって既に一時停止されている場合、この変数を更新して、ユーザーがコンテンツを一時停止したことを示します。 再生ボタンのクリック ハンドラーでは、再生を再開し、追跡変数をクリアします。

private void PauseButton_User_Click(object sender, RoutedEventArgs e)
{
    if (isPausedDueToAudioStateMonitor)
    {
        isPausedDueToAudioStateMonitor = false;
    }
    else
    {
        mediaPlayer.Pause();
    }
}

public void PlayButton_User_Click()
{
    isPausedDueToAudioStateMonitor = false;
    mediaPlayer.Play();
}