MediaPlayer.RenderSubtitlesToSurface Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 BooleanParámetros
- destination
- IDirect3DSurface
Objeto que implementa IDirect3DSurface en el que se representa el texto del subtítulo.
Devoluciones
bool
True si el sistema representa los subtítulos en la superficie; en caso contrario, false.
- Atributos
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.
Se aplica a
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 BooleanPará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
bool
True si el sistema representa los subtítulos en la superficie; en caso contrario, false.
- Atributos
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.