MediaPlayer.RenderSubtitlesToSurface 方法

定義

命名空間:

Windows.Media.Playback

多載

RenderSubtitlesToSurface(IDirect3DSurface)	要求系統將目前的副標題文字轉譯為提供的 IDirect3DSurface。
RenderSubtitlesToSurface(IDirect3DSurface, Rect)	要求系統將目前的副標題文字轉譯為所提供 IDirect3DSurface內的指定目標矩形。

RenderSubtitlesToSurface(IDirect3DSurface)

要求系統將目前的副標題文字轉譯為提供的 IDirect3DSurface。

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

參數

destination

IDirect3DSurface

實作轉譯副標題文字之 IDirect3DSurface 的物件。

傳回

Boolean

bool

如果系統將副標題轉譯到表面，則為 True;否則為 false。

屬性

OverloadAttribute

Windows 需求

裝置系列	Windows 10 Fall Creators Update (已於 10.0.16299.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v5.0 引進)

備註

處理 SubtitleFrameChanged 事件，以接收子標題內容已變更的通知。 檢查傳回值，以查看是否轉譯副標題。 如果方法傳回 false，則不會轉譯任何副標題。 在此情況下，您可能會決定隱藏 UI 中的副標題轉譯介面。

若要使用這項功能，您必須藉由將IsVideoFrameServerEnabled設定為true，將MediaPlayer放入畫面伺服器模式，而且播放的媒體內容至少必須有一個已設定為PlatformPresented且已呼叫MediaPlaybackTimedMetadataTrackList.SetPresentationMode的計時中繼資料播放軌。 如需在畫面伺服器模式中使用 MediaPlayer 的詳細資訊，請參閱 使用 MediaPlayer 播放音訊和視訊。 如需使用中繼資料播放軌的詳細資訊，請參閱 媒體專案、播放清單和曲目。

RenderSubtitlesToSurface(IDirect3DSurface, Rect)

要求系統將目前的副標題文字轉譯為所提供 IDirect3DSurface內的指定目標矩形。

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

參數

destination

IDirect3DSurface

實作轉譯副標題文字之 IDirect3DSurface 的物件。

targetRectangle

Rect

所提供介面內的矩形，其中轉譯子標題。

傳回

Boolean

bool

如果系統將副標題轉譯到表面，則為 True;否則為 false。

屬性

OverloadAttribute

Windows 需求

裝置系列	Windows 10 Fall Creators Update (已於 10.0.16299.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v5.0 引進)

備註

請注意，這個方法比 RenderSubtitleToSurface的其他多載效率低，但可讓您使用相同的表面來轉譯視訊和副標題，而不需要使用個別的副標題介面。

處理 SubtitleFrameChanged 事件，以接收子標題內容已變更的通知。 檢查傳回值，以查看是否轉譯副標題。

若要使用這項功能，您必須藉由將IsVideoFrameServerEnabled設定為true，將MediaPlayer放入畫面伺服器模式，而且播放的媒體內容至少必須有一個已設定為PlatformPresented且已呼叫MediaPlaybackTimedMetadataTrackList.SetPresentationMode的計時中繼資料播放軌。 如需在畫面伺服器模式中使用 MediaPlayer 的詳細資訊，請參閱 使用 MediaPlayer 播放音訊和視訊。 如需使用中繼資料播放軌的詳細資訊，請參閱 媒體專案、播放清單和曲目。