MediaPlayer.RenderSubtitlesToSurface Método

Definición

Espacio de nombres:

Windows.Media.Playback

Sobrecargas

RenderSubtitlesToSurface(IDirect3DSurface)	Solicita al sistema que represente el texto del subtítulo actual en el IDirect3DSurface proporcionado.
RenderSubtitlesToSurface(IDirect3DSurface, Rect)	Solicita al sistema que represente el texto del subtítulo actual en el rectángulo de destino especificado dentro del IDirect3DSurface proporcionado.

RenderSubtitlesToSurface(IDirect3DSurface)

Solicita al sistema que represente el texto del subtítulo actual en el IDirect3DSurface proporcionado.

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

Parámetros

destination

IDirect3DSurface

Objeto que implementa IDirect3DSurface en el que se representa el texto del subtítulo.

Devoluciones

Boolean

bool

True si el sistema representa los subtítulos en la superficie; en caso contrario, false.

Atributos

OverloadAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 Fall Creators Update (se introdujo en la versión 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v5.0)

Comentarios

Controla el evento SubtitleFrameChanged para recibir una notificación de que el contenido del subtítulo ha cambiado. Compruebe el valor devuelto para ver si se representaron los subtítulos. Si el método devuelve false, no se representaron subtítulos. En este caso, puede decidir ocultar la superficie de representación de subtítulos en la interfaz de usuario.

Para poder usar esta característica, debes colocar MediaPlayer en modo de servidor de fotogramas estableciendo IsVideoFrameServerEnabled en true, y el contenido multimedia de reproducción debe tener al menos una pista de metadatos cronometrada que tenga su modo de presentación establecido en PlatformPresented con una llamada a MediaPlaybackTimedMetadataTrackList.SetPresentationMode. Para obtener más información sobre el uso de MediaPlayer en el modo de servidor de fotogramas, consulta Reproducir audio y vídeo con MediaPlayer. Para obtener más información sobre cómo trabajar con pistas de metadatos, vea Elementos multimedia, listas de reproducción y pistas.

RenderSubtitlesToSurface(IDirect3DSurface, Rect)

Solicita al sistema que represente el texto del subtítulo actual en el rectángulo de destino especificado dentro del IDirect3DSurface proporcionado.

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

Parámetros

destination

IDirect3DSurface

Objeto que implementa IDirect3DSurface en el que se representa el texto del subtítulo.

targetRectangle

Rect

Rectángulo dentro de la superficie proporcionada en la que se representan los subtítulos.

Devoluciones

Boolean

bool

True si el sistema representa los subtítulos en la superficie; en caso contrario, false.

Atributos

OverloadAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 Fall Creators Update (se introdujo en la versión 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v5.0)

Comentarios

Tenga en cuenta que este método es menos eficaz que la otra sobrecarga de RenderSubtitleToSurface, pero permite usar la misma superficie para representar vídeo y subtítulos en lugar de requerir una superficie independiente para los subtítulos.

Controla el evento SubtitleFrameChanged para recibir una notificación de que el contenido del subtítulo ha cambiado. Compruebe el valor devuelto para ver si se representaron los subtítulos.

Para poder usar esta característica, debes colocar MediaPlayer en modo de servidor de fotogramas estableciendo IsVideoFrameServerEnabled en true, y el contenido multimedia de reproducción debe tener al menos una pista de metadatos cronometrada que tenga su modo de presentación establecido en PlatformPresented con una llamada a MediaPlaybackTimedMetadataTrackList.SetPresentationMode. Para obtener más información sobre el uso de MediaPlayer en el modo de servidor de fotogramas, consulta Reproducir audio y vídeo con MediaPlayer. Para obtener más información sobre cómo trabajar con pistas de metadatos, vea Elementos multimedia, listas de reproducción y pistas.