MediaPlayer.RenderSubtitlesToSurface Metode

Definisi

Ruang nama:

Windows.Media.Playback

Overload

RenderSubtitlesToSurface(IDirect3DSurface)	Permintaan sistem untuk merender teks subtitel saat ini ke IDirect3DSurface yang disediakan.
RenderSubtitlesToSurface(IDirect3DSurface, Rect)	Permintaan sistem untuk merender teks subtitel saat ini ke persegi target yang ditentukan dalam IDirect3DSurface yang disediakan.

RenderSubtitlesToSurface(IDirect3DSurface)

Permintaan sistem untuk merender teks subtitel saat ini ke IDirect3DSurface yang disediakan.

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

Parameter

destination

IDirect3DSurface

Objek yang mengimplementasikan IDirect3DSurface tempat teks subtitel dirender.

Mengembalikan

Boolean

bool

True jika sistem merender subtitel ke permukaan; jika tidak salah.

Atribut

OverloadAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 Fall Creators Update (diperkenalkan dalam 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v5.0)

Keterangan

Tangani peristiwa SubtitleFrameChanged untuk menerima pemberitahuan bahwa konten subtitel telah berubah. Periksa nilai yang dikembalikan untuk melihat apakah subtitel dirender. Jika metode mengembalikan false, maka tidak ada subtitel yang dirender. Dalam hal ini Anda dapat memutuskan untuk menyembunyikan permukaan render subtitel di UI Anda.

Untuk menggunakan fitur ini, Anda harus menempatkan MediaPlayer ke mode server bingkai dengan mengatur IsVideoFrameServerEnabled ke true, dan konten media yang diputar harus memiliki setidaknya satu trek metadata berwaktu yang memiliki mode presentasinya diatur ke PlatformPresented dengan panggilan ke MediaPlaybackTimedMetadataTrackList.SetPresentationMode. Untuk informasi selengkapnya tentang menggunakan MediaPlayer dalam mode server bingkai, lihat Memutar audio dan video dengan MediaPlayer. Untuk informasi selengkapnya tentang bekerja dengan trek metadata, lihat Item media, daftar putar, dan trek.

RenderSubtitlesToSurface(IDirect3DSurface, Rect)

Permintaan sistem untuk merender teks subtitel saat ini ke persegi target yang ditentukan dalam IDirect3DSurface yang disediakan.

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

Parameter

destination

IDirect3DSurface

Objek yang mengimplementasikan IDirect3DSurface tempat teks subtitel dirender.

targetRectangle

Rect

Persegi panjang dalam permukaan yang disediakan di mana subtitel dirender.

Mengembalikan

Boolean

bool

True jika sistem merender subtitel ke permukaan; jika tidak salah.

Atribut

OverloadAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 Fall Creators Update (diperkenalkan dalam 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v5.0)

Keterangan

Perhatikan bahwa metode ini kurang efisien daripada kelebihan beban RenderSubtitleToSurface lainnya, tetapi memungkinkan Anda menggunakan permukaan yang sama untuk merender video dan subtitel daripada membutuhkan permukaan terpisah untuk subtitel.

Tangani peristiwa SubtitleFrameChanged untuk menerima pemberitahuan bahwa konten subtitel telah berubah. Periksa nilai yang dikembalikan untuk melihat apakah subtitel dirender.

Untuk menggunakan fitur ini, Anda harus menempatkan MediaPlayer ke mode server bingkai dengan mengatur IsVideoFrameServerEnabled ke true, dan konten media yang diputar harus memiliki setidaknya satu trek metadata berwaktu yang memiliki mode presentasinya diatur ke PlatformPresented dengan panggilan ke MediaPlaybackTimedMetadataTrackList.SetPresentationMode. Untuk informasi selengkapnya tentang menggunakan MediaPlayer dalam mode server bingkai, lihat Memutar audio dan video dengan MediaPlayer. Untuk informasi selengkapnya tentang bekerja dengan trek metadata, lihat Item media, daftar putar, dan trek.