MediaPlayer Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan akses ke fungsi pemutaran media seperti putar, jeda, maju cepat, putar balik, dan volume.
public ref class MediaPlayer sealed
public ref class MediaPlayer sealed : IClosable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class MediaPlayer final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(196608, "Windows.Foundation.UniversalApiContract")]
class MediaPlayer final : IClosable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class MediaPlayer
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(196608, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaPlayer : System.IDisposable
function MediaPlayer()
Public NotInheritable Class MediaPlayer
Public NotInheritable Class MediaPlayer
Implements IDisposable
- Warisan
- Atribut
- Penerapan
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Keterangan
Bagian Pemutaran media dari dokumentasi berisi artikel petunjuk yang menyediakan panduan terperinci untuk menambahkan fitur pemutaran media ke aplikasi Anda. Tabel berikut ini mencantumkan beberapa artikel yang tersedia.
Topik | Deskripsi |
---|---|
Memutar audio dan video dengan MediaPlayer | Menunjukkan kepada Anda cara memanfaatkan fitur dan peningkatan baru pada sistem pemutaran media untuk aplikasi UWP. |
Item media, daftar putar, dan trek | Menunjukkan kepada Anda cara menggunakan kelas MediaSource , yang menyediakan cara umum untuk mereferensikan dan memutar kembali media dari sumber yang berbeda seperti file lokal atau jarak jauh dan mengekspos model umum untuk mengakses data media, terlepas dari format media yang mendasar. |
Mengintegrasikan dengan Kontrol Transportasi Media Sistem | Menunjukkan cara mengintegrasikan aplikasi Anda dengan System Media Transport Controls (SMTC). |
Istime metadata berwaktu yang didukung sistem | Menjelaskan cara memanfaatkan beberapa format metadata berwaktu yang mungkin disematkan dalam file atau aliran media. |
Membuat, menjadwalkan, dan mengelola jeda media | Menunjukkan cara membuat, menjadwalkan, dan mengelola jeda media ke aplikasi pemutaran media Anda. |
Putar media di latar belakang | Menunjukkan cara mengonfigurasi aplikasi sehingga media terus diputar saat aplikasi Berpindah dari latar depan ke latar belakang. |
Streaming Adaptif | Menjelaskan cara menambahkan pemutaran konten multimedia streaming adaptif ke aplikasi Platform Windows Universal (UWP). |
Transmisi media | Menunjukkan kepada Anda cara mentransmisian media ke perangkat jarak jauh dari aplikasi Universal Windows. |
PlayReady DRM | Menjelaskan cara menambahkan konten media yang dilindungi PlayReady ke aplikasi Platform Windows Universal (UWP) Anda. |
Sampel SDK pemutaran media
Sampel SDK berikut menunjukkan fitur pemutaran media yang tersedia untuk aplikasi UWP di Windows 10. Gunakan sampel ini untuk melihat API pemutaran media yang digunakan dalam konteks atau sebagai titik awal untuk aplikasi Anda sendiri.
- Sampel streaming adaptif
- Sampel Audio Latar Belakang
- Sampel Transportasi Media Sistem
- Sampel Pemutaran Video 360 derajat
- Sampel pemutaran media latar belakang
- Sampel sinkronisasi pemutaran video
Riwayat versi
Versi Windows | Versi SDK | Nilai ditambahkan |
---|---|---|
1511 | 10586 | TambahkanAudioEffect |
1511 | 10586 | RemoveAllEffects |
1607 | 14393 | AddVideoEffect |
1607 | 14393 | AudioBalance |
1607 | 14393 | AudioDevice |
1607 | 14393 | BreakManager |
1607 | 14393 | CommandManager |
1607 | 14393 | GetAsCastingSource |
1607 | 14393 | GetSurface |
1607 | 14393 | IsMutedChanged |
1607 | 14393 | PlaybackSession |
1607 | 14393 | RealTimePlayback |
1607 | 14393 | SetSurfaceSize |
1607 | 14393 | SourceChanged |
1607 | 14393 | StepBackwardOneFrame |
1607 | 14393 | StepForwardOneFrame |
1607 | 14393 | StereoscopicVideoRenderMode |
1607 | 14393 | TimelineController |
1607 | 14393 | TimelineControllerPositionOffset |
1703 | 15063 | CopyFrameToStereoscopicVideoSurfaces |
1703 | 15063 | CopyFrameToVideoSurface(IDirect3DSurface) |
1703 | 15063 | CopyFrameToVideoSurface(IDirect3DSurface,Rect) |
1703 | 15063 | IsVideoFrameServerEnabled |
1703 | 15063 | VideoFrameAvailable |
1709 | 16299 | RenderSubtitlesToSurface(IDirect3DSurface) |
1709 | 16299 | RenderSubtitlesToSurface(IDirect3DSurface,Rect) |
1709 | 16299 | SubtitleFrameChanged |
1803 | 17134 | AudioStateMonitor |
Konstruktor
MediaPlayer() |
Menginisialisasi instans baru objek MediaPlayer . |
Properti
AudioBalance |
Mendapatkan atau menetapkan rasio volume di seluruh speaker stereo. |
AudioCategory |
Mendapatkan atau mengatur jenis audio yang saat ini sedang diputar. |
AudioDevice |
Mendapatkan atau mengatur objek DeviceInformation yang mewakili perangkat audio yang digunakan oleh MediaPlayer untuk merender audio. |
AudioDeviceType |
Mendapatkan atau menetapkan nilai yang menjelaskan penggunaan utama perangkat yang digunakan untuk memutar audio. |
AudioStateMonitor |
Mendapatkan objek AudioStateMonitor yang memungkinkan aplikasi UWP menentukan apakah salah satu aliran audio aplikasi saat ini sedang dibisukan atau volumenya dikurangi oleh sistem. |
AutoPlay |
Mendapatkan atau menetapkan nilai Boolean yang menunjukkan apakah pemutaran secara otomatis dimulai setelah media dimuat. |
BreakManager |
Mendapatkan MediaBreakManager yang terkait dengan MediaPlayer, yang menyediakan informasi tentang dan kontrol atas jeda media untuk pemutar. |
BufferingProgress |
Mendapatkan jumlah buffering yang diselesaikan untuk konten media, yang dinyatakan sebagai persentase. Catatan MediaPlayer.BufferingProgress dapat diubah atau tidak tersedia setelah Windows 10, versi 1607. Sebagai gantinya, gunakan properti MediaPlayer.PlaybackSession untuk mendapatkan objek MediaPlaybackSession lalu gunakan properti MediaPlaybackSession.BufferingProgress . |
CanPause |
Mendapatkan nilai Boolean yang menunjukkan apakah media dapat dijeda. Catatan MediaPlayer.CanPause dapat diubah atau tidak tersedia setelah Windows 10, versi 1607. Sebagai gantinya, gunakan properti MediaPlayer.PlaybackSession untuk mendapatkan objek MediaPlaybackSession lalu gunakan properti MediaPlaybackSession.CanPause . |
CanSeek |
Mendapatkan nilai Boolean yang menunjukkan apakah media mendukung pencarian ke posisi tertentu. Catatan MediaPlayer.CanSeek dapat diubah atau tidak tersedia setelah Windows 10, versi 1607. Sebagai gantinya, gunakan properti MediaPlayer.PlaybackSession untuk mendapatkan objek MediaPlaybackSession lalu gunakan properti MediaPlaybackSession.CanSeek . |
CommandManager |
Mendapatkan MediaPlaybackCommandManager yang terkait dengan MediaPlayer, yang menentukan perilaku dan menerima peristiwa dari Kontrol Transportasi Media Sistem. |
CurrentState |
Mendapatkan status pemutaran media saat ini. Catatan MediaPlayer.CurrentState dapat diubah atau tidak tersedia setelah Windows 10, versi 1607. Sebagai gantinya, gunakan properti MediaPlayer.PlaybackSession untuk mendapatkan objek MediaPlaybackSession lalu gunakan properti MediaPlaybackSession.PlaybackState . |
IsLoopingEnabled |
Mendapatkan atau menetapkan nilai Boolean yang menunjukkan apakah media akan diputar dalam perulangan berulang. |
IsMuted |
Mendapatkan atau mengatur nilai Boolean yang menunjukkan apakah audio dimatikan suaranya. |
IsProtected |
Mendapatkan nilai Boolean yang menunjukkan apakah konten dilindungi oleh sistem manajemen hak digital. Catatan MediaPlayer.IsProtected dapat diubah atau tidak tersedia setelah Windows 10, versi 1607. Sebagai gantinya, gunakan properti MediaPlayer.PlaybackSession untuk mendapatkan objek MediaPlaybackSession lalu gunakan properti IsProtected . |
IsVideoFrameServerEnabled |
Mendapatkan nilai yang menunjukkan apakah mode server bingkai video diaktifkan untuk instans MediaPlayer . |
NaturalDuration |
Dapatkan durasi media yang sebenarnya tanpa menerapkan PlaybackRate. Catatan MediaPlayer.NaturalDuration dapat diubah atau tidak tersedia setelah Windows 10, versi 1607. Sebagai gantinya, gunakan properti MediaPlayer.PlaybackSession untuk mendapatkan objek MediaPlaybackSession lalu gunakan properti MediaPlaybackSession.NaturalDuration . |
PlaybackMediaMarkers |
Mendapatkan pengumpulan penanda garis waktu untuk media. Catatan MediaPlayer.PlaybackMediaMarkers dapat diubah atau tidak tersedia setelah Windows 10, versi 1607. Sebagai gantinya, gunakan MediaPlaybackItem.TimedMetadataTracks untuk mengelola tanda data atau teks. Untuk informasi selengkapnya, lihat Pemutaran media dengan MediaSource. |
PlaybackRate |
Mendapatkan atau menetapkan laju pemutaran, yang dinyatakan sebagai rasio. Catatan MediaPlayer.PlaybackRate dapat diubah atau tidak tersedia setelah Windows 10, versi 1607. Sebagai gantinya, gunakan properti MediaPlayer.PlaybackSession untuk mendapatkan objek MediaPlaybackSession lalu gunakan properti MediaPlaybackSession.PlaybackRate . |
PlaybackSession |
Mendapatkan MediaPlaybackSession yang terkait dengan MediaPlayer, yang menyediakan informasi tentang status sesi pemutaran saat ini dan menyediakan peristiwa untuk merespons perubahan status sesi pemutaran. |
Position |
Mendapatkan atau mengatur posisi pemutaran dalam media. Catatan MediaPlayer.Position dapat diubah atau tidak tersedia setelah Windows 10, versi 1607. Sebagai gantinya, gunakan properti MediaPlayer.PlaybackSession untuk mendapatkan objek MediaPlaybackSession lalu gunakan properti MediaPlaybackSession.Position . |
ProtectionManager |
Mendapatkan atau mengatur manajer perlindungan konten untuk media. |
RealTimePlayback |
Mendapatkan atau menetapkan nilai yang mengonfigurasi MediaPlayer untuk skenario real-time seperti video streaming langsung. |
Source |
Menyetel sumber pemutaran pemutar media. |
StereoscopicVideoRenderMode |
Mendapatkan atau menetapkan nilai yang menunjukkan mode render stereoskopis saat ini. |
SystemMediaTransportControls |
Mendapatkan instans kelas SystemMediaTransportControls untuk memungkinkan kontrol pengguna pemutaran MediaPlayer dan untuk memungkinkan aplikasi menampilkan informasi tentang konten yang saat ini diputar di UI sistem. |
TimelineController |
Mendapatkan atau mengatur MediaTimelineController yang terkait dengan MediaPlayer. Gunakan properti ini untuk memanipulasi beberapa instans MediaPlayer dengan satu kontrol garis waktu. |
TimelineControllerPositionOffset |
Mendapatkan atau mengatur offset yang diterapkan ke posisi MediaTimelineController yang terkait dengan MediaPlayer. |
Volume |
Mendapatkan atau mengatur volume audio untuk pemutaran media. |
Metode
AddAudioEffect(String, Boolean, IPropertySet) |
Menambahkan efek audio ke aliran pemutaran MediaPlayer. |
AddVideoEffect(String, Boolean, IPropertySet) |
Menerapkan efek video ke pemutaran media. |
Close() |
Menutup MediaPlayer dan membuang sumber daya terkait. |
CopyFrameToStereoscopicVideoSurfaces(IDirect3DSurface, IDirect3DSurface) |
Menyalin bingkai video yang saat ini ditampilkan oleh MediaPlayer ke dua objek IDirect3DSurface yang disediakan yang mewakili mata kiri dan konten mata kanan bingkai video stereoskopis. |
CopyFrameToVideoSurface(IDirect3DSurface) |
Menyalin bingkai video saat ini dari MediaPlayer ke IDirect3DSurface yang disediakan. |
CopyFrameToVideoSurface(IDirect3DSurface, Rect) |
Menyalin bingkai video saat ini dari MediaPlayer ke persegi target yang ditentukan dalam IDirect3DSurface yang disediakan. |
Dispose() |
Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola. |
GetAsCastingSource() |
Mendapatkan CastingSource yang mewakili MediaPlayer, yang memungkinkan medianya untuk ditransfer ke perangkat lain. |
GetSurface(Compositor) |
Mendapatkan objek MediaPlayerSurface untuk MediaPlayer, yang memungkinkan Anda merender konten pemutar menggunakan Compositor tanpa mengandalkan kerangka kerja XAML. |
Pause() |
Menjeda pemutaran media. |
Play() |
Memulai pemutaran media. |
RemoveAllEffects() |
Menghapus semua efek dari aliran pemutaran MediaPlayer. |
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. |
SetFileSource(IStorageFile) |
Atur sumber media ke file. Catatan MediaPlayer.SetFileSource dapat diubah atau tidak tersedia setelah Windows 10. Gunakan MediaPlayer.Source sebagai gantinya. |
SetMediaSource(IMediaSource) |
Menyetel sumber media untuk pemutaran. Catatan MediaPlayer.SetMediaSource dapat diubah atau tidak tersedia setelah Windows 10. Gunakan MediaPlayer.Source sebagai gantinya. |
SetStreamSource(IRandomAccessStream) |
Mengatur sumber media ke aliran. Catatan MediaPlayer.SetMediaSource dapat diubah atau tidak tersedia setelah Windows 10. Gunakan MediaPlayer.Source sebagai gantinya. |
SetSurfaceSize(Size) |
Mengatur ukuran permukaan komposisi yang dikembalikan oleh GetSurface. |
SetUriSource(Uri) |
Menyetel jalur ke media. Catatan MediaPlayer.SetUriSource dapat diubah atau tidak tersedia setelah Windows 10. Gunakan MediaPlayer.Source sebagai gantinya. |
StepBackwardOneFrame() |
Menyebabkan posisi pemutaran MediaPlayer bergerak mundur sebesar .042 detik, yang sesuai dengan satu bingkai pada 24 fps, terlepas dari kecepatan bingkai aktual konten yang diputar. |
StepForwardOneFrame() |
Menyebabkan MediaPlayer bergerak maju di media saat ini dengan satu bingkai. |
Acara
BufferingEnded |
Terjadi ketika buffering telah selesai. Catatan MediaPlayer.BufferingEnded dapat diubah atau tidak tersedia setelah Windows 10, versi 1607. Sebagai gantinya, gunakan properti MediaPlayer.PlaybackSession untuk mendapatkan objek MediaPlaybackSession lalu gunakan peristiwa MediaPlaybackSession.BufferingEnded . |
BufferingStarted |
Terjadi ketika buffering telah dimulai. Catatan MediaPlayer.BufferingStarted dapat diubah atau tidak tersedia setelah Windows 10, versi 1607. Sebagai gantinya, gunakan properti MediaPlayer.PlaybackSession untuk mendapatkan objek MediaPlaybackSession lalu gunakan peristiwa MediaPlaybackSession.BufferingStarted . |
CurrentStateChanged |
Terjadi ketika status pemutar media telah berubah. Catatan MediaPlayer.CurrentStateChanged dapat diubah atau tidak tersedia setelah Windows 10, versi 1607. Sebagai gantinya, gunakan properti MediaPlayer.PlaybackSession untuk mendapatkan objek MediaPlaybackSession lalu gunakan peristiwa MediaPlaybackSession.PlaybackStateChanged . |
IsMutedChanged |
Terjadi ketika status dimatikan suara MediaPlayer saat ini berubah. |
MediaEnded |
Terjadi ketika media telah menyelesaikan pemutaran. |
MediaFailed |
Terjadi ketika terjadi kesalahan. |
MediaOpened |
Terjadi ketika media dibuka. |
MediaPlayerRateChanged |
Terjadi ketika laju pemutaran media telah berubah. Catatan MediaPlayer.MediaPlayerRateChanged dapat diubah atau tidak tersedia setelah Windows 10, versi 1607. Sebagai gantinya, gunakan properti MediaPlayer.PlaybackSession untuk mendapatkan objek MediaPlaybackSession lalu gunakan peristiwa MediaPlaybackSession.PlaybackRateChanged . |
PlaybackMediaMarkerReached |
Terjadi ketika penanda media telah dicapai selama pemutaran. Catatan MediaPlayer.PlaybackMediaMarkerReached dapat diubah atau tidak tersedia setelah Windows 10, versi 1607. Sebagai gantinya, gunakan MediaPlaybackItem.TimedMetadataTracks untuk mengelola tanda data atau teks. Untuk informasi selengkapnya, lihat Pemutaran media dengan MediaSource. |
SeekCompleted |
Terjadi ketika operasi pencarian telah selesai. Catatan MediaPlayer.SeekCompleted mungkin diubah atau tidak tersedia setelah Windows 10, versi 1607. Sebagai gantinya, gunakan properti MediaPlayer.PlaybackSession untuk mendapatkan objek MediaPlaybackSession lalu gunakan peristiwa MediaPlaybackSession.SeekCompleted . |
SourceChanged |
Terjadi ketika sumber media untuk MediaPlayer berubah. |
SubtitleFrameChanged |
Terjadi ketika konten subtitel saat ini telah berubah saat MediaPlayer berada dalam mode server bingkai. |
VideoFrameAvailable |
Terjadi ketika IsVideoFrameServerEnabled diatur ke true dan bingkai video baru tersedia untuk diproses. |
VolumeChanged |
Terjadi ketika volume audio telah berubah. |