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, то субтитры не отображались. В этом случае вы можете скрыть поверхность отображения субтитров в пользовательском интерфейсе.

Чтобы использовать эту функцию, необходимо поместить MediaPlayer в режим сервера фреймов, задав для параметра IsVideoFrameServerEnabled значение true, а воспроизводимое содержимое мультимедиа должно иметь по крайней мере одну дорожку метаданных с заданным временем, в режиме презентации которого задано значение 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 для получения уведомления об изменении содержимого субтитров. Проверьте возвращаемое значение, чтобы узнать, были ли отрисованы субтитры.

Чтобы использовать эту функцию, необходимо поместить MediaPlayer в режим сервера фреймов, задав для параметра IsVideoFrameServerEnabled значение true, а воспроизводимое содержимое мультимедиа должно иметь по крайней мере одну дорожку метаданных с заданным временем, в режиме презентации которого задано значение PlatformPresented с вызовом MediaPlaybackTimedMetadataTrackList.SetPresentationMode. Дополнительные сведения об использовании MediaPlayer в режиме сервера кадров см. в разделе Воспроизведение звука и видео с помощью MediaPlayer. Дополнительные сведения о работе с дорожками метаданных см. в разделе Элементы мультимедиа, списки воспроизведения и дорожки.