MediaPlayer.RenderSubtitlesToSurface Metodo

Definizione

Spazio dei nomi:

Windows.Media.Playback

Overload

RenderSubtitlesToSurface(IDirect3DSurface)	Richiede al sistema di eseguire il rendering del testo del sottotitolo corrente nell'oggetto IDirect3DSurface specificato.
RenderSubtitlesToSurface(IDirect3DSurface, Rect)	Richiede al sistema di eseguire il rendering del testo del sottotitolo corrente nel rettangolo di destinazione specificato all'interno dell'oggetto IDirect3DSurface specificato.

RenderSubtitlesToSurface(IDirect3DSurface)

Richiede al sistema di eseguire il rendering del testo del sottotitolo corrente nell'oggetto IDirect3DSurface specificato.

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

Parametri

destination

IDirect3DSurface

Oggetto che implementa IDirect3DSurface in cui viene eseguito il rendering del testo del sottotitolo.

Restituisce

Boolean

bool

True se il sistema ha eseguito il rendering dei sottotitoli sulla superficie; in caso contrario false.

Attributi

OverloadAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 Fall Creators Update (è stato introdotto in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v5.0)

Commenti

Gestire l'evento SubtitleFrameChanged per ricevere una notifica che indica che il contenuto del sottotitolo è stato modificato. Controllare il valore restituito per verificare se è stato eseguito il rendering dei sottotitoli. Se il metodo restituisce false, non viene eseguito il rendering dei sottotitoli. In questo caso è possibile decidere di nascondere la superficie di rendering del sottotitolo nell'interfaccia utente.

Per usare questa funzionalità, devi posizionare MediaPlayer in modalità server frame impostando IsVideoFrameServerEnabled su true e il contenuto multimediale in riproduzione deve avere almeno una traccia di metadati temporizzata con la modalità presentazione impostata su PlatformPresented con una chiamata a MediaPlaybackTimedMetadataTrackList.SetPresentationMode. Per altre informazioni sull'uso di MediaPlayer in modalità server frame, vedi Riprodurre audio e video con MediaPlayer. Per altre informazioni sull'uso delle tracce di metadati, vedi Elementi multimediali, playlist e tracce.

RenderSubtitlesToSurface(IDirect3DSurface, Rect)

Richiede al sistema di eseguire il rendering del testo del sottotitolo corrente nel rettangolo di destinazione specificato all'interno dell'oggetto IDirect3DSurface specificato.

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

Parametri

destination

IDirect3DSurface

Oggetto che implementa IDirect3DSurface in cui viene eseguito il rendering del testo del sottotitolo.

targetRectangle

Rect

Rettangolo all'interno della superficie specificata in cui viene eseguito il rendering dei sottotitoli.

Restituisce

Boolean

bool

True se il sistema ha eseguito il rendering dei sottotitoli sulla superficie; in caso contrario false.

Attributi

OverloadAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 Fall Creators Update (è stato introdotto in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v5.0)

Commenti

Si noti che questo metodo è meno efficiente rispetto all'altro overload di RenderSubtitleToSurface, ma consente di usare la stessa superficie per il rendering di video e sottotitoli invece di richiedere una superficie separata per i sottotitoli.

Gestire l'evento SubtitleFrameChanged per ricevere una notifica che indica che il contenuto del sottotitolo è stato modificato. Controllare il valore restituito per verificare se è stato eseguito il rendering dei sottotitoli.

Per usare questa funzionalità, devi posizionare MediaPlayer in modalità server frame impostando IsVideoFrameServerEnabled su true e il contenuto multimediale in riproduzione deve avere almeno una traccia di metadati temporizzata con la modalità presentazione impostata su PlatformPresented con una chiamata a MediaPlaybackTimedMetadataTrackList.SetPresentationMode. Per altre informazioni sull'uso di MediaPlayer in modalità server frame, vedi Riprodurre audio e video con MediaPlayer. Per altre informazioni sull'uso delle tracce di metadati, vedi Elementi multimediali, playlist e tracce.