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

如此 如果系统将字幕呈现到表面;否则为 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

如此 如果系统将字幕呈现到表面;否则为 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 播放音频和视频。 有关使用元数据轨道的详细信息，请参阅 媒体项、播放列表和曲目。