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 pemutaran media untuk gambar.
public ref class MediaPlayer : System::Windows::Media::Animation::Animatable
public class MediaPlayer : System.Windows.Media.Animation.Animatable
type MediaPlayer = class
inherit Animatable
interface DUCE.IResource
type MediaPlayer = class
inherit Animatable
Public Class MediaPlayer
Inherits Animatable
- Warisan
Contoh
Cara: Memutar Media menggunakan VideoDrawing
Keterangan
Meskipun Anda dapat mendeklarasikan instans kelas ini dalam Extensible Application Markup Language (XAML), Anda tidak dapat memuat dan memutar medianya tanpa menggunakan kode. Untuk memutar media di XAML saja, gunakan MediaElement. Selain itu, jika Anda mendeklarasikan instans di XAML, satu-satunya penggunaan praktis adalah mengisi sintaks elemen properti untuk Player properti .
Saat mendistribusikan media dengan aplikasi, Anda tidak dapat menggunakan file media sebagai sumber daya proyek. Dalam file proyek Anda, Anda harus mengatur jenis media ke Content
dan mengatur CopyToOutputDirectory
ke PreserveNewest
atau Always
.
MediaPlayer dapat digunakan dalam dua mode berbeda, tergantung pada apa yang mendorong pemutar: mode independen atau mode jam. Dalam mode independen, MediaPlayer dianalogikan dengan gambar dan media yang dibuka melalui Open metode mendorong pemutaran. Dalam mode Jam, MediaPlayer dapat dianggap sebagai target untuk animasi, dan dengan demikian akan memiliki entri dan Clock yang sesuai Timeline di pohon Pengaturan Waktu yang mengontrol pemutaran. Untuk informasi selengkapnya tentang mode media, lihat Gambaran Umum Multimedia.
MediaPlayer berbeda dari MediaElement di mana itu bukan kontrol yang dapat ditambahkan langsung ke antarmuka pengguna (UI) aplikasi. Untuk menampilkan media yang dimuat menggunakan MediaPlayer, atau VideoDrawingDrawingContext harus digunakan.
Konstruktor
MediaPlayer() |
Menginisialisasi instans baru kelas MediaPlayer. |
Properti
Balance |
Mendapatkan atau mengatur keseimbangan antara volume speaker kiri dan kanan. |
BufferingProgress |
Mendapatkan persentase buffering yang diselesaikan untuk streaming konten. |
CanFreeze |
Mendapatkan nilai yang menunjukkan apakah objek dapat dibuat tidak dapat dimodifikasi. (Diperoleh dari Freezable) |
CanPause |
Mendapatkan nilai yang menunjukkan apakah media dapat dijeda. |
Clock |
Mendapatkan atau mengatur yang MediaClock terkait dengan yang MediaTimeline akan diputar. |
DependencyObjectType |
Mendapatkan yang membungkus jenis CLR dari instans DependencyObjectType ini. (Diperoleh dari DependencyObject) |
Dispatcher |
Mendapatkan ini DispatcherDispatcherObject dikaitkan dengan. (Diperoleh dari DispatcherObject) |
DownloadProgress |
Mendapatkan persentase kemajuan pengunduhan untuk konten yang terletak di server jarak jauh. |
HasAnimatedProperties |
Mendapatkan nilai yang menunjukkan apakah satu atau beberapa AnimationClock objek dikaitkan dengan salah satu properti dependensi objek ini. (Diperoleh dari Animatable) |
HasAudio |
Mendapatkan nilai yang menunjukkan apakah media memiliki output audio. |
HasVideo |
Mendapatkan nilai yang menunjukkan apakah media memiliki output video. |
IsBuffering |
Mendapatkan nilai yang menunjukkan apakah media sedang buffering. |
IsFrozen |
Mendapatkan nilai yang menunjukkan apakah objek saat ini dapat dimodifikasi. (Diperoleh dari Freezable) |
IsMuted |
Mendapatkan nilai yang menunjukkan apakah media dibisukan. |
IsSealed |
Mendapatkan nilai yang menunjukkan apakah instans ini saat ini disegel (baca-saja). (Diperoleh dari DependencyObject) |
NaturalDuration |
Mendapatkan durasi alami media. |
NaturalVideoHeight |
Mendapatkan tinggi piksel video. |
NaturalVideoWidth |
Mendapatkan lebar piksel video. |
Position |
Mendapatkan atau mengatur posisi media saat ini. |
ScrubbingEnabled |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah scrubbing diaktifkan. |
Source |
Mendapatkan media Uri. |
SpeedRatio |
Mendapatkan atau mengatur rasio kecepatan yang dimainkan media. |
Volume |
Mendapatkan atau mengatur volume media. |
Metode
ApplyAnimationClock(DependencyProperty, AnimationClock) |
AnimationClock Menerapkan ke yang ditentukanDependencyProperty. Jika properti sudah dianimasikan, SnapshotAndReplace perilaku handoff digunakan. (Diperoleh dari Animatable) |
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
AnimationClock Menerapkan ke yang ditentukanDependencyProperty. Jika properti sudah dianimasikan, yang ditentukan HandoffBehavior akan digunakan. (Diperoleh dari Animatable) |
BeginAnimation(DependencyProperty, AnimationTimeline) |
Menerapkan animasi ke yang ditentukan DependencyProperty. Animasi dimulai ketika bingkai berikutnya dirender. Jika properti yang ditentukan sudah dianimasikan, SnapshotAndReplace perilaku handoff digunakan. (Diperoleh dari Animatable) |
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Menerapkan animasi ke yang ditentukan DependencyProperty. Animasi dimulai ketika bingkai berikutnya dirender. Jika properti yang ditentukan sudah dianimasikan, properti yang ditentukan HandoffBehavior akan digunakan. (Diperoleh dari Animatable) |
CheckAccess() |
Menentukan apakah utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject) |
ClearValue(DependencyProperty) |
Menghapus nilai lokal properti. Properti yang akan dibersihkan ditentukan oleh DependencyProperty pengidentifikasi. (Diperoleh dari DependencyObject) |
ClearValue(DependencyPropertyKey) |
Menghapus nilai lokal properti baca-saja. Properti yang akan dibersihkan ditentukan oleh DependencyPropertyKey. (Diperoleh dari DependencyObject) |
Clone() |
Membuat kloning yang dapat dimodifikasi dari ini Animatable, membuat salinan mendalam dari nilai objek ini. Saat menyalin properti dependensi objek ini, metode ini menyalin referensi sumber daya dan pengikatan data (tetapi mungkin tidak lagi diselesaikan) tetapi bukan animasi atau nilainya saat ini. (Diperoleh dari Animatable) |
CloneCore(Freezable) |
Menjadikan instans ini salinan mendalam dari yang ditentukan MediaPlayer. Saat menyalin properti dependensi, metode ini menyalin referensi sumber daya dan pengikatan data (tetapi mungkin tidak lagi diselesaikan) tetapi bukan animasi atau nilainya saat ini. |
CloneCurrentValue() |
Membuat kloning yang dapat dimodifikasi (salinan mendalam) dari Freezable menggunakan nilainya saat ini. (Diperoleh dari Freezable) |
CloneCurrentValueCore(Freezable) |
Menjadikan instans ini salinan mendalam yang dapat dimodifikasi dari yang ditentukan MediaPlayer menggunakan nilai properti saat ini. Referensi sumber daya, pengikatan data, dan animasi tidak disalin, tetapi nilainya saat ini. |
Close() |
Menutup media yang mendasar. |
CoerceValue(DependencyProperty) |
Memaksakan nilai properti dependensi yang ditentukan. Ini dicapai dengan memanggil fungsi apa pun CoerceValueCallback yang ditentukan dalam metadata properti untuk properti dependensi seperti yang ada pada panggilan DependencyObject. (Diperoleh dari DependencyObject) |
CreateInstance() |
Menginisialisasi instans baru kelas Freezable. (Diperoleh dari Freezable) |
CreateInstanceCore() |
Membuat instans baru MediaPlayer . |
Equals(Object) |
Menentukan apakah yang disediakan DependencyObject setara dengan saat ini DependencyObject. (Diperoleh dari DependencyObject) |
Freeze() |
Membuat objek saat ini tidak dapat dimodifikasi dan mengatur propertinya IsFrozen ke |
FreezeCore(Boolean) |
Membuat objek ini Animatable tidak dapat dimodifikasi atau menentukan apakah objek dapat dibuat tidak dapat dimodifikasi. (Diperoleh dari Animatable) |
GetAnimationBaseValue(DependencyProperty) |
Mengembalikan nilai non-animasi dari yang ditentukan DependencyProperty. (Diperoleh dari Animatable) |
GetAsFrozen() |
Membuat salinan beku dari Freezable, menggunakan nilai properti dasar (non-animasi). Karena salinan dibekukan, sub-objek beku apa pun disalin oleh referensi. (Diperoleh dari Freezable) |
GetAsFrozenCore(Freezable) |
Menjadikan instans ini sebagai klon objek yang ditentukan MediaPlayer . |
GetCurrentValueAsFrozen() |
Membuat salinan beku dari Freezable menggunakan nilai properti saat ini. Karena salinan dibekukan, sub-objek beku apa pun disalin oleh referensi. (Diperoleh dari Freezable) |
GetCurrentValueAsFrozenCore(Freezable) |
Menjadikan instans saat ini sebagai klon beku dari yang ditentukan Freezable. Jika objek memiliki properti dependensi animasi, nilai animasinya saat ini akan disalin. (Diperoleh dari Freezable) |
GetHashCode() |
Mendapatkan kode hash untuk ini DependencyObject. (Diperoleh dari DependencyObject) |
GetLocalValueEnumerator() |
Membuat enumerator khusus untuk menentukan properti dependensi mana yang memiliki nilai yang ditetapkan secara lokal pada ini DependencyObject. (Diperoleh dari DependencyObject) |
GetType() |
Mendapatkan dari instans Type saat ini. (Diperoleh dari Object) |
GetValue(DependencyProperty) |
Mengembalikan nilai efektif properti dependensi saat ini pada instans ini dari DependencyObject. (Diperoleh dari DependencyObject) |
InvalidateProperty(DependencyProperty) |
Mengevaluasi kembali nilai efektif untuk properti dependensi yang ditentukan. (Diperoleh dari DependencyObject) |
MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
OnChanged() |
Dipanggil ketika objek saat ini Freezable dimodifikasi. (Diperoleh dari Freezable) |
OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Memastikan bahwa penunjuk konteks yang sesuai ditetapkan untuk DependencyObjectType anggota data yang baru saja ditetapkan. (Diperoleh dari Freezable) |
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Anggota ini mendukung infrastruktur Windows Presentation Foundation (WPF) dan tidak dimaksudkan untuk digunakan langsung dari kode Anda. (Diperoleh dari Freezable) |
OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Mengambil alih DependencyObject implementasi OnPropertyChanged(DependencyPropertyChangedEventArgs) untuk juga memanggil penangan apa pun Changed sebagai respons terhadap properti dependensi yang berubah dari jenis Freezable. (Diperoleh dari Freezable) |
Open(Uri) |
Membuka yang diberikan Uri untuk pemutaran media. |
Pause() |
Menjeda pemutaran media. |
Play() |
Memutar media dari saat ini Position. |
ReadLocalValue(DependencyProperty) |
Mengembalikan nilai lokal properti dependensi, jika ada. (Diperoleh dari DependencyObject) |
ReadPreamble() |
Memastikan bahwa MediaPlayer sedang diakses dari utas yang valid. |
SetCurrentValue(DependencyProperty, Object) |
Mengatur nilai properti dependensi tanpa mengubah sumber nilainya. (Diperoleh dari DependencyObject) |
SetValue(DependencyProperty, Object) |
Mengatur nilai lokal properti dependensi, yang ditentukan oleh pengidentifikasi properti dependensinya. (Diperoleh dari DependencyObject) |
SetValue(DependencyPropertyKey, Object) |
Mengatur nilai lokal properti dependensi baca-saja, yang ditentukan oleh DependencyPropertyKey pengidentifikasi properti dependensi. (Diperoleh dari DependencyObject) |
ShouldSerializeProperty(DependencyProperty) |
Mengembalikan nilai yang menunjukkan apakah proses serialisasi harus menserialisasikan nilai untuk properti dependensi yang disediakan. (Diperoleh dari DependencyObject) |
Stop() |
Menghentikan pemutaran media. |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
VerifyAccess() |
Memberlakukan bahwa utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject) |
WritePostscript() |
Menaikkan Changed peristiwa untuk Freezable dan memanggil metodenya OnChanged() . Kelas yang berasal dari Freezable harus memanggil metode ini di akhir API apa pun yang memodifikasi anggota kelas yang tidak disimpan sebagai properti dependensi. (Diperoleh dari Freezable) |
WritePreamble() |
Memverifikasi bahwa MediaPlayer tidak dibekukan dan sedang diakses dari konteks utas yang valid. |
Acara
BufferingEnded |
Terjadi ketika buffering telah selesai. |
BufferingStarted |
Terjadi ketika buffering telah dimulai. |
Changed |
Terjadi ketika Freezable atau objek yang dikandungnya dimodifikasi. (Diperoleh dari Freezable) |
MediaEnded |
Terjadi ketika media telah menyelesaikan pemutaran. |
MediaFailed |
Terjadi ketika terjadi kesalahan. |
MediaOpened |
Terjadi ketika media dibuka. |
ScriptCommand |
Terjadi ketika perintah skrip telah ditemui di dalam media. |