MediaPlayer.SubtitleFrameChanged Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит при изменении текущего содержимого подзаголовка, когда MediaPlayer находится в режиме сервера фреймов.
// Register
event_token SubtitleFrameChanged(TypedEventHandler<MediaPlayer, IInspectable const&> const& handler) const;
// Revoke with event_token
void SubtitleFrameChanged(event_token const* cookie) const;
// Revoke with event_revoker
MediaPlayer::SubtitleFrameChanged_revoker SubtitleFrameChanged(auto_revoke_t, TypedEventHandler<MediaPlayer, IInspectable const&> const& handler) const;
public event TypedEventHandler<MediaPlayer,object> SubtitleFrameChanged;
function onSubtitleFrameChanged(eventArgs) { /* Your code */ }
mediaPlayer.addEventListener("subtitleframechanged", onSubtitleFrameChanged);
mediaPlayer.removeEventListener("subtitleframechanged", onSubtitleFrameChanged);
- or -
mediaPlayer.onsubtitleframechanged = onSubtitleFrameChanged;
Public Custom Event SubtitleFrameChanged As TypedEventHandler(Of MediaPlayer, Object)
Тип события
TypedEventHandler<MediaPlayer,IInspectable>
Требования к Windows
Семейство устройств |
Windows 10 Fall Creators Update (появилось в 10.0.16299.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v5.0)
|
Комментарии
В обработчике для этого события можно вызвать одну из перегрузок RenderSubtitlesToSurface , чтобы запросить, чтобы система отрисовыла текущие субтитры в предоставленном IDirect3DSurface. Если этот метод возвращает значение false, подзаголовки не отображаются. В этом случае можно скрыть область отображения субтитров до следующего появления события.
Чтобы вызвать это событие, необходимо поместить MediaPlayer в режим сервера фреймов, задав для параметра IsVideoFrameServerEnabledзначение true, а воспроизводимое содержимое мультимедиа должно содержать по крайней мере одну дорожку метаданных с повременным временем, в режиме презентации которой задано значение PlatformPresented с вызовом MediaPlaybackTimedMetadataTrackList.SetPresentationMode. Дополнительные сведения об использовании MediaPlayer в режиме сервера кадров см. в разделе Воспроизведение звука и видео с помощью MediaPlayer. Дополнительные сведения о работе с дорожками метаданных см. в статье Элементы мультимедиа, списки воспроизведения и дорожки.