MediaPlayer.RenderSubtitlesToSurface Méthode

Définition

Espace de noms:

Windows.Media.Playback

Surcharges

RenderSubtitlesToSurface(IDirect3DSurface)	Demandes pour que le système restitue le texte actuel du sous-titre à l’IDirect3DSurface fourni.
RenderSubtitlesToSurface(IDirect3DSurface, Rect)	Demandes pour que le système restitue le texte actuel du sous-titre au rectangle cible spécifié dans le IDirect3DSurface fourni.

RenderSubtitlesToSurface(IDirect3DSurface)

Demandes pour que le système restitue le texte actuel du sous-titre à l’IDirect3DSurface fourni.

public:
 virtual bool RenderSubtitlesToSurface(IDirect3DSurface ^ destination) = RenderSubtitlesToSurface;

/// [Windows.Foundation.Metadata.Overload("RenderSubtitlesToSurface")]
bool RenderSubtitlesToSurface(IDirect3DSurface const& destination);

[Windows.Foundation.Metadata.Overload("RenderSubtitlesToSurface")]
public bool RenderSubtitlesToSurface(IDirect3DSurface destination);

function renderSubtitlesToSurface(destination)

Public Function RenderSubtitlesToSurface (destination As IDirect3DSurface) As Boolean

Paramètres

destination

IDirect3DSurface

Objet qui implémente IDirect3DSurface dans lequel le texte du sous-titre est affiché.

Retours

Boolean

bool

True si le système a rendu les sous-titres à la surface ; sinon, false.

Attributs

OverloadAttribute

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

Gérez l’événement SubtitleFrameChanged pour recevoir une notification indiquant que le contenu du sous-titre a changé. Vérifiez la valeur de retour pour voir si les sous-titres ont été rendus. Si la méthode retourne false, aucun sous-titre n’a été rendu. Dans ce cas, vous pouvez décider de masquer la surface de rendu de sous-titre dans votre interface utilisateur.

Pour utiliser cette fonctionnalité, vous devez placer MediaPlayer en mode serveur frame en définissant IsVideoFrameServerEnabled sur true, et le contenu multimédia de 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.

RenderSubtitlesToSurface(IDirect3DSurface, Rect)

Demandes pour que le système restitue le texte actuel du sous-titre au rectangle cible spécifié dans le IDirect3DSurface fourni.

public:
 virtual bool RenderSubtitlesToSurface(IDirect3DSurface ^ destination, Rect targetRectangle) = RenderSubtitlesToSurface;

/// [Windows.Foundation.Metadata.Overload("RenderSubtitlesToSurfaceWithTargetRectangle")]
bool RenderSubtitlesToSurface(IDirect3DSurface const& destination, Rect const& targetRectangle);

[Windows.Foundation.Metadata.Overload("RenderSubtitlesToSurfaceWithTargetRectangle")]
public bool RenderSubtitlesToSurface(IDirect3DSurface destination, Rect targetRectangle);

function renderSubtitlesToSurface(destination, targetRectangle)

Public Function RenderSubtitlesToSurface (destination As IDirect3DSurface, targetRectangle As Rect) As Boolean

Paramètres

destination

IDirect3DSurface

Objet qui implémente IDirect3DSurface dans lequel le texte du sous-titre est affiché.

targetRectangle

Rect

Rectangle dans la surface fournie dans laquelle les sous-titres sont rendus.

Retours

Boolean

bool

True si le système a rendu les sous-titres à la surface ; sinon, false.

Attributs

OverloadAttribute

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

Notez que cette méthode est moins efficace que l’autre surcharge de RenderSubtitleToSurface, mais elle vous permet d’utiliser la même surface pour le rendu de la vidéo et des sous-titres plutôt que d’exiger une surface distincte pour les sous-titres.

Gérez l’événement SubtitleFrameChanged pour recevoir une notification indiquant que le contenu du sous-titre a changé. Vérifiez la valeur de retour pour voir si les sous-titres ont été rendus.

Pour utiliser cette fonctionnalité, vous devez placer MediaPlayer en mode serveur frame en définissant IsVideoFrameServerEnabled sur true, et le contenu multimédia de 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.