MediaPlayer.RenderSubtitlesToSurface 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| 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를 반환하면 자막이 렌더링되지 않습니다. 이 경우 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
자막이 렌더링되는 제공된 표면 내의 사각형입니다.
반환
bool
True이면 시스템에서 자막을 표면에 렌더링합니다. 그렇지 않으면 false입니다.
- 특성
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를 사용하여 오디오 및 비디오 재생을 참조하세요. 메타데이터 트랙 작업에 대한 자세한 내용은 미디어 항목, 재생 목록 및 트랙을 참조하세요.