MediaPlayer.RenderSubtitlesToSurface Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 BooleanParâmetros
- destination
- IDirect3DSurface
O objeto que implementa IDirect3DSurface no qual o texto do subtítulo é renderizado.
Retornos
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 BooleanParâ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
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.