Partilhar via


MediaPlayer.RenderSubtitlesToSurface Método

Definição

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

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.

Aplica-se a

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

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.

Aplica-se a