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，則不會轉譯任何副標題。 在此情況下，您可以選擇隱藏子標題轉譯介面，直到下次引發事件為止。

若要引發此事件，您必須將 MediaPlayer 設定為 true，並將 IsVideoFrameServerEnabled 設定為 true，而且播放的媒體內容必須至少有一個已設定其簡報模式設定為 PlatformPresented 且呼叫 MediaPlaybackTimedMetadataTrackList.SetPresentationMode的定時中繼資料播放軌。 如需在畫面伺服器模式中使用 MediaPlayer 的詳細資訊，請參閱 使用 MediaPlayer 播放音訊和視訊。 如需使用中繼資料播放軌的詳細資訊，請參閱 媒體專案、播放清單和曲目。