MediaPlayer Kelas

Definisi

Ruang nama:

Windows.Media.Playback

Menyediakan akses ke fungsi pemutaran media seperti putar, jeda, maju cepat, putar balik, dan volume.

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)]
/// [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)]
[Windows.Foundation.Metadata.Activatable(196608, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaPlayer : System.IDisposable

function MediaPlayer()

Public NotInheritable Class MediaPlayer
Implements IDisposable

Warisan

Object Platform::Object IInspectable MediaPlayer

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ActivatableAttribute

Penerapan

IClosable IDisposable

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.