MediaPlayer.SubtitleFrameChanged 이벤트

정의

네임스페이스:

Windows.Media.Playback

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,Object>

TypedEventHandler<MediaPlayer,IInspectable>

Windows 요구 사항

디바이스 패밀리	Windows 10 Fall Creators Update (10.0.16299.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v5.0에서 도입되었습니다.)

설명

이 이벤트에 대한 처리기에서 RenderSubtitlesToSurface 의 오버로드 중 하나를 호출하여 시스템이 제공된 IDirect3DSurface에 현재 자막을 렌더링하도록 요청할 수 있습니다. 이 메서드가 false를 반환하면 자막이 렌더링되지 않습니다. 이 경우 다음에 이벤트가 발생할 때까지 자막 렌더링 화면을 숨기도록 선택할 수 있습니다.

이 이벤트를 발생하려면 IsVideoFrameServerEnabled를 true로 설정하여 MediaPlayer를 프레임 서버 모드로 전환해야 하며, 재생 중인 미디어 콘텐츠에는 MediaPlaybackTimedMetadataTrackList.SetPresentationMode를 호출하여 프레젠테이션 모드가 PlatformPresented로 설정된 시간이 지정된 메타데이터 트랙이 하나 이상 있어야 합니다. 프레임 서버 모드에서 MediaPlayer를 사용하는 방법에 대한 자세한 내용은 MediaPlayer를 사용하여 오디오 및 비디오 재생을 참조하세요. 메타데이터 트랙 작업에 대한 자세한 내용은 미디어 항목, 재생 목록 및 트랙을 참조하세요.