MediaPlayer.SubtitleFrameChanged Événement

Définition

Espace de noms:

Windows.Media.Playback

Se produit lorsque le contenu du sous-titre actuel a changé alors que MediaPlayer est en mode serveur frame.

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

Type d'événement

TypedEventHandler<MediaPlayer,Object>

TypedEventHandler<MediaPlayer,IInspectable>

Configuration requise pour Windows

Famille d’appareils	Windows 10 Fall Creators Update (introduit dans 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v5.0)

Remarques

Dans le gestionnaire de cet événement, vous pouvez appeler l’une des surcharges de RenderSubtitlesToSurface pour demander que le système restitue les sous-titres actuels sur le IDirect3DSurface fourni. Si cette méthode retourne false, aucun sous-titre n’a été rendu. Dans ce cas, vous pouvez choisir de masquer la surface de rendu de sous-titre jusqu’à la prochaine levée de l’événement.

Pour que cet événement soit déclenché, vous devez placer MediaPlayer en mode serveur frame en définissant IsVideoFrameServerEnabled sur true, et le contenu multimédia en lecture doit avoir au moins une piste de métadonnées chronométrée dont le mode de présentation a été défini sur PlatformPresented avec un appel à MediaPlaybackTimedMetadataTrackList.SetPresentationMode. Pour plus d’informations sur l’utilisation de MediaPlayer en mode serveur frame, consultez Lire de l’audio et de la vidéo avec MediaPlayer. Pour plus d’informations sur l’utilisation des pistes de métadonnées, consultez Éléments multimédias, playlists et pistes.