MediaPlayer.RenderSubtitlesToSurface Método

Definição

Namespace:

Windows.Media.Playback

Sobrecargas

RenderSubtitlesToSurface(IDirect3DSurface)	Solicitações para que o sistema renderize o texto do subtítulo atual para o IDirect3DSurface fornecido.
RenderSubtitlesToSurface(IDirect3DSurface, Rect)	Solicitações para que o sistema renderize o texto do subtítulo atual para o retângulo de destino especificado dentro do IDirect3DSurface fornecido.

RenderSubtitlesToSurface(IDirect3DSurface)

Solicitações para que o sistema renderize o texto do subtítulo atual para o IDirect3DSurface fornecido.

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

O objeto que implementa IDirect3DSurface no qual o texto do subtítulo é renderizado.

Retornos

Boolean

bool

True se o sistema renderizar legendas para a superfície; caso contrário, false.

Atributos

OverloadAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 Fall Creators Update (introduzida na 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v5.0)

Comentários

Manipule o evento SubtitleFrameChanged para receber uma notificação de que o conteúdo do subtítulo foi alterado. Verifique o valor retornado para ver se as legendas foram renderizadas. Se o método retornar false, nenhuma legenda será renderizada. Nesse caso, você pode decidir ocultar a superfície de renderização de legenda na interface do usuário.

Para usar esse recurso, você deve colocar o MediaPlayer no modo de servidor de quadro definindo IsVideoFrameServerEnabled como true e o conteúdo da mídia de reprodução deve ter pelo menos uma faixa de metadados cronometrada que tenha seu modo de apresentação definido como PlatformPresented com uma chamada para MediaPlaybackTimedMetadataTrackList.SetPresentationMode. Para obter mais informações sobre como usar o MediaPlayer no modo de servidor de quadros, consulte Reproduzir áudio e vídeo com MediaPlayer. Para obter mais informações sobre como trabalhar com faixas de metadados, consulte Itens de mídia, playlists e faixas.

RenderSubtitlesToSurface(IDirect3DSurface, Rect)

Solicitações para que o sistema renderize o texto do subtítulo atual para o retângulo de destino especificado dentro do IDirect3DSurface fornecido.

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

O objeto que implementa IDirect3DSurface no qual o texto do subtítulo é renderizado.

targetRectangle

Rect

O retângulo dentro da superfície fornecida na qual as legendas são renderizadas.

Retornos

Boolean

bool

True se o sistema renderizar legendas para a superfície; caso contrário, false.

Atributos

OverloadAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 Fall Creators Update (introduzida na 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v5.0)

Comentários

Observe que esse método é menos eficiente do que a outra sobrecarga de RenderSubtitleToSurface, mas permite que você use a mesma superfície para renderizar vídeos e legendas em vez de exigir uma superfície separada para legendas.

Manipule o evento SubtitleFrameChanged para receber uma notificação de que o conteúdo do subtítulo foi alterado. Verifique o valor retornado para ver se as legendas foram renderizadas.

Para usar esse recurso, você deve colocar o MediaPlayer no modo de servidor de quadro definindo IsVideoFrameServerEnabled como true e o conteúdo da mídia de reprodução deve ter pelo menos uma faixa de metadados cronometrada que tenha seu modo de apresentação definido como PlatformPresented com uma chamada para MediaPlaybackTimedMetadataTrackList.SetPresentationMode. Para obter mais informações sobre como usar o MediaPlayer no modo de servidor de quadros, consulte Reproduzir áudio e vídeo com MediaPlayer. Para obter mais informações sobre como trabalhar com faixas de metadados, consulte Itens de mídia, playlists e faixas.