MediaPlayer.RenderSubtitlesToSurface Methode

Definition

Namespace:

Windows.Media.Playback

Ü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 Boolean

Parameter

destination

IDirect3DSurface

Das Objekt, das IDirect3DSurface implementiert, in das der Untertiteltext gerendert wird.

Gibt zurück

Boolean

bool

True, wenn das System Untertitel auf der Oberfläche gerendert hat; andernfalls false.

Attribute

OverloadAttribute

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.

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 Boolean

Parameter

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

Boolean

bool

True, wenn das System Untertitel auf der Oberfläche gerendert hat; andernfalls false.

Attribute

OverloadAttribute

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.