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 的计时元数据轨。 有关在帧服务器模式下使用 MediaPlayer 的详细信息，请参阅 使用 MediaPlayer 播放音频和视频。 有关使用元数据轨的详细信息，请参阅 媒体项、播放列表和曲目。