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를 반환하면 자막이 렌더링되지 않습니다. 이 경우 UI에서 자막 렌더링 화면을 숨기도록 결정할 수 있습니다.

이 기능을 사용하려면 IsVideoFrameServerEnabled를 true로 설정하여 MediaPlayer를 프레임 서버 모드로 전환해야 하며, 재생 중인 미디어 콘텐츠에는 MediaPlaybackTimedMetadataTrackList.SetPresentationMode를 호출하여 프레젠테이션 모드가 PlatformPresented로 설정된 시간 제한 메타데이터 트랙이 하나 이상 있어야 합니다. 프레임 서버 모드에서 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 이벤트를 처리하여 자막 콘텐츠가 변경되었다는 알림을 받습니다. 반환 값을 확인하여 자막이 렌더링되었는지 확인합니다.

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

적용 대상