MediaPlayer.RenderSubtitlesToSurface 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
| 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 的对象。
返回
bool
如此 如果系统将字幕呈现到表面;否则为 false。
- 属性
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
提供图面中的矩形，其中呈现字幕。
返回
bool
如此 如果系统将字幕呈现到表面;否则为 false。
- 属性
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 播放音频和视频。 有关使用元数据轨道的详细信息，请参阅 媒体项、播放列表和曲目。