MediaPlayer.RenderSubtitlesToSurface Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| RenderSubtitlesToSurface(IDirect3DSurface) |
Anforderungen an das System, den aktuellen Untertiteltext in der bereitgestellten IDirect3DSurface zu rendern. |
| RenderSubtitlesToSurface(IDirect3DSurface, Rect) |
Anforderungen an das System, den aktuellen Untertiteltext im angegebenen Zielrechteck innerhalb der bereitgestellten IDirect3DSurface zu rendern. |
RenderSubtitlesToSurface(IDirect3DSurface)
Anforderungen an das System, den aktuellen Untertiteltext in der bereitgestellten IDirect3DSurface zu rendern.
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 BooleanParameter
- destination
- IDirect3DSurface
Das Objekt, das IDirect3DSurface implementiert, in das der Untertiteltext gerendert wird.
Gibt zurück
bool
True, wenn das System Untertitel auf der Oberfläche gerendert hat; andernfalls false.
- Attribute
Windows-Anforderungen
| Gerätefamilie |
Windows 10 Fall Creators Update (eingeführt in 10.0.16299.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v5.0)
|
Hinweise
Behandeln Sie das SubtitleFrameChanged-Ereignis , um eine Benachrichtigung zu erhalten, dass sich der Untertitelinhalt geändert hat. Überprüfen Sie den Rückgabewert, um festzustellen, ob Untertitel gerendert wurden. Wenn die Methode false zurückgibt, wurden keine Untertitel gerendert. In diesem Fall können Sie entscheiden, die Renderoberfläche für Untertitel auf der Benutzeroberfläche auszublenden.
Um dieses Feature verwenden zu können, müssen Sie den MediaPlayer in den Frameservermodus versetzen, indem Sie IsVideoFrameServerEnabled auf true festlegen, und für den wiedergegebenen Medieninhalt muss mindestens eine zeitbasierte Metadatenspur vorhanden sein, deren Präsentationsmodus auf PlatformPresented mit einem Aufruf von MediaPlaybackTimedMetadataTrackList.SetPresentationMode festgelegt wurde. Weitere Informationen zur Verwendung von MediaPlayer im Frameservermodus finden Sie unter Wiedergeben von Audio und Video mit MediaPlayer. Weitere Informationen zum Arbeiten mit Metadatenspuren finden Sie unter Medienelemente, Wiedergabelisten und Titel.
Gilt für:
RenderSubtitlesToSurface(IDirect3DSurface, Rect)
Anforderungen an das System, den aktuellen Untertiteltext im angegebenen Zielrechteck innerhalb der bereitgestellten IDirect3DSurface zu rendern.
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 BooleanParameter
- destination
- IDirect3DSurface
Das Objekt, das IDirect3DSurface implementiert, in das der Untertiteltext gerendert wird.
- targetRectangle
- Rect
Das Rechteck innerhalb der bereitgestellten Oberfläche, auf der die Untertitel gerendert werden.
Gibt zurück
bool
True, wenn das System Untertitel auf der Oberfläche gerendert hat; andernfalls false.
- Attribute
Windows-Anforderungen
| Gerätefamilie |
Windows 10 Fall Creators Update (eingeführt in 10.0.16299.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v5.0)
|
Hinweise
Beachten Sie, dass diese Methode weniger effizient ist als die andere Überladung von RenderSubtitleToSurface, aber sie ermöglicht es Ihnen, dieselbe Oberfläche zum Rendern von Videos und Untertiteln zu verwenden, anstatt eine separate Oberfläche für Untertitel zu benötigen.
Behandeln Sie das SubtitleFrameChanged-Ereignis , um eine Benachrichtigung zu erhalten, dass sich der Untertitelinhalt geändert hat. Überprüfen Sie den Rückgabewert, um festzustellen, ob Untertitel gerendert wurden.
Um dieses Feature verwenden zu können, müssen Sie den MediaPlayer in den Frameservermodus versetzen, indem Sie IsVideoFrameServerEnabled auf true festlegen, und für den wiedergegebenen Medieninhalt muss mindestens eine zeitbasierte Metadatenspur vorhanden sein, deren Präsentationsmodus auf PlatformPresented mit einem Aufruf von MediaPlaybackTimedMetadataTrackList.SetPresentationMode festgelegt wurde. Weitere Informationen zur Verwendung von MediaPlayer im Frameservermodus finden Sie unter Wiedergeben von Audio und Video mit MediaPlayer. Weitere Informationen zum Arbeiten mit Metadatenspuren finden Sie unter Medienelemente, Wiedergabelisten und Titel.