MediaPlayer.SubtitleFrameChanged イベント

定義

名前空間:

Windows.Media.Playback

MediaPlayer がフレーム サーバー モードのときに、現在のサブタイトル コンテンツが変更されたときに発生します。

// Register
event_token SubtitleFrameChanged(TypedEventHandler<MediaPlayer, IInspectable const&> const& handler) const;

// Revoke with event_token
void SubtitleFrameChanged(event_token const* cookie) const;

// Revoke with event_revoker
MediaPlayer::SubtitleFrameChanged_revoker SubtitleFrameChanged(auto_revoke_t, TypedEventHandler<MediaPlayer, IInspectable const&> const& handler) const;

public event TypedEventHandler<MediaPlayer,object> SubtitleFrameChanged;

function onSubtitleFrameChanged(eventArgs) { /* Your code */ }
mediaPlayer.addEventListener("subtitleframechanged", onSubtitleFrameChanged);
mediaPlayer.removeEventListener("subtitleframechanged", onSubtitleFrameChanged);
- or -
mediaPlayer.onsubtitleframechanged = onSubtitleFrameChanged;

Public Custom Event SubtitleFrameChanged As TypedEventHandler(Of MediaPlayer, Object) 

イベントの種類

TypedEventHandler<MediaPlayer,Object>

TypedEventHandler<MediaPlayer,IInspectable>

Windows の要件

デバイス ファミリ	Windows 10 Fall Creators Update (10.0.16299.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v5.0 で導入)

注釈

このイベントのハンドラーでは、 RenderSubtitlesToSurface のいずれかのオーバーロードを呼び出して、指定された IDirect3DSurface に現在のサブタイトルをレンダリングするようにシステムに要求できます。 このメソッドが false を返す場合、サブタイトルはレンダリングされませんでした。 この場合は、次にイベントが発生するまでサブタイトルレンダリングサーフェスを非表示にすることができます。

このイベントを発生させるには、IsVideoFrameServerEnabled を true に設定して MediaPlayer をフレーム サーバー モードにする必要があります。また、再生中のメディア コンテンツには、プレゼンテーション モードが PlatformPresented に設定され、MediaPlaybackTimedMetadataTrackList.SetPresentationMode の呼び出しで少なくとも 1 つのタイムメタデータ トラックが必要です。 フレーム サーバー モードでの MediaPlayer の使用の詳細については、「 MediaPlayer でオーディオとビデオを再生する」を参照してください。 メタデータ トラックの操作の詳細については、「 メディアアイテム、プレイリスト、トラック」を参照してください。