Share via


MediaPlayer.SubtitleFrameChanged Ereignis

Definition

Tritt auf, wenn sich der aktuelle Untertitelinhalt geändert hat, während sich der MediaPlayer im Frameservermodus befindet.

// 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) 

Ereignistyp

Windows-Anforderungen

Gerätefamilie
Windows 10 Fall Creators Update (eingeführt in 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v5.0)

Hinweise

Im Handler für dieses Ereignis können Sie eine der Überladungen von RenderSubtitlesToSurface aufrufen, um anzufordern, dass das System die aktuellen Untertitel für die bereitgestellte IDirect3DSurface rendert. Wenn diese Methode false zurückgibt, wurden keine Untertitel gerendert. In diesem Fall können Sie die Renderoberfläche des Untertitels ausblenden, bis das Ereignis das nächste Mal ausgelöst wird.

Damit dieses Ereignis ausgelöst wird, müssen Sie den MediaPlayer in den Frameservermodus versetzen, indem Sie IsVideoFrameServerEnabled auf true festlegen, und der wiedergabende Medieninhalt muss mindestens eine zeitbasierte Metadatenspur aufweisen, für die der Präsentationsmodus mit einem Aufruf von MediaPlaybackTimedMetadataTrackList.SetPresentationMode auf PlatformPresented festgelegt wurde. Weitere Informationen zur Verwendung von MediaPlayer im Frameservermodus finden Sie unter Wiedergeben von Audio und Video mit MediaPlayer. Weitere Informationen zum Arbeiten mit Metadatenspuren finden Sie unter Medienelemente, Wiedergabelisten und Titel.

Gilt für: