MediaPlayer.RenderSubtitlesToSurface Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| 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
Значение true, если система отрисовывает субтитры на поверхности; в противном случае — false.
- Атрибуты
Требования к 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
Прямоугольник в пределах предоставленной поверхности, в которой отображаются субтитры.
Возвращаемое значение
bool
Значение true, если система отрисовывает субтитры на поверхности; в противном случае — false.
- Атрибуты
Требования к 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. Дополнительные сведения о работе с дорожками метаданных см. в разделе Элементы мультимедиа, списки воспроизведения и дорожки.