MediaPlayer.RenderSubtitlesToSurface Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 BooleanParamètres
- destination
- IDirect3DSurface
Objet qui implémente IDirect3DSurface dans lequel le texte du sous-titre est affiché.
Retours
bool
True si le système a rendu les sous-titres à la surface ; sinon, false.
- Attributs
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.
S’applique à
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 BooleanParamè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
bool
True si le système a rendu les sous-titres à la surface ; sinon, false.
- Attributs
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.