MediaPlayer.RenderSubtitlesToSurface Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 BooleanParametri
- destination
- IDirect3DSurface
Oggetto che implementa IDirect3DSurface in cui viene eseguito il rendering del testo del sottotitolo.
Restituisce
bool
True se il sistema ha eseguito il rendering dei sottotitoli sulla superficie; in caso contrario false.
- Attributi
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.
Si applica a
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 BooleanParametri
- 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
bool
True se il sistema ha eseguito il rendering dei sottotitoli sulla superficie; in caso contrario false.
- Attributi
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.