MediaPlayer Klass
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Tillhandahåller medieuppspelning för ritningar.
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
- Arv
Exempel
Gör så här: Spela upp media med hjälp av en videodrawing
Kommentarer
Även om du kan deklarera en instans av den här klassen i XAML (Extensible Application Markup Language) kan du inte läsa in och spela upp dess media utan att använda kod. Om du bara vill spela upp media i XAML använder du en MediaElement. Om du deklarerar en instans i XAML är den enda praktiska användningen att fylla egenskapselementsyntaxen Player för egenskapen.
När du distribuerar media med ditt program kan du inte använda en mediefil som en projektresurs. I projektfilen måste du i stället ange medietypen till Content och ange CopyToOutputDirectory till PreserveNewest eller Always.
MediaPlayer kan användas i två olika lägen, beroende på vad som driver spelaren: oberoende läge eller klockläge. I oberoende läge MediaPlayer är det analogt med en bild och mediet som öppnas via Open metoden driver uppspelning. I klockläge MediaPlayer kan du betrakta som ett mål för en animering, och därför har den motsvarande Timeline poster och Clock poster i tidsträdet som styr uppspelningen. Mer information om medielägen finns i Översikt över multimedia.
MediaPlayer skiljer sig från en MediaElement eftersom det inte är en kontroll som kan läggas till direkt i användargränssnittet för ett program. Om du vill visa media som lästs in med hjälp av MediaPlayermåste en VideoDrawing eller DrawingContext användas.
Konstruktorer
| Name | Description |
|---|---|
| MediaPlayer() |
Initierar en ny instans av MediaPlayer klassen. |
Egenskaper
| Name | Description |
|---|---|
| Balance |
Hämtar eller ställer in balansen mellan vänster- och högerhögtalarvolymer. |
| BufferingProgress |
Hämtar procentandelen buffring slutförd för strömmande innehåll. |
| CanFreeze |
Hämtar ett värde som anger om objektet kan göras ommodifierbart. (Ärvd från Freezable) |
| CanPause |
Hämtar ett värde som anger om mediet kan pausas. |
| Clock |
Hämtar eller anger associerad MediaClock med den MediaTimeline som ska spelas upp. |
| DependencyObjectType |
DependencyObjectType Hämtar som omsluter CLR-typen för den här instansen. (Ärvd från DependencyObject) |
| Dispatcher |
Hämtar det Dispatcher som DispatcherObject är associerat med. (Ärvd från DispatcherObject) |
| DownloadProgress |
Hämtar procentandelen nedladdningsstatus för innehåll som finns på en fjärrserver. |
| HasAnimatedProperties |
Hämtar ett värde som anger om ett eller flera AnimationClock objekt är associerade med något av det här objektets beroendeegenskaper. (Ärvd från Animatable) |
| HasAudio |
Hämtar ett värde som anger om mediet har ljudutdata. |
| HasVideo |
Hämtar ett värde som anger om mediet har videoutdata. |
| IsBuffering |
Hämtar ett värde som anger om mediet buffrar. |
| IsFrozen |
Hämtar ett värde som anger om objektet för närvarande kan ändras. (Ärvd från Freezable) |
| IsMuted |
Hämtar ett värde som anger om mediet är avstängt. |
| IsSealed |
Hämtar ett värde som anger om den här instansen för närvarande är förseglad (skrivskyddad). (Ärvd från DependencyObject) |
| NaturalDuration |
Hämtar den naturliga varaktigheten för media. |
| NaturalVideoHeight |
Hämtar bildpunktshöjden för videon. |
| NaturalVideoWidth |
Hämtar videons bildpunktsbredd. |
| Position |
Hämtar eller anger mediets aktuella position. |
| ScrubbingEnabled |
Hämtar eller anger ett värde som anger om rensning är aktiverat. |
| Source |
Hämtar mediet Uri. |
| SpeedRatio |
Hämtar eller anger förhållandet mellan hastigheten som mediet spelas upp på. |
| Volume |
Hämtar eller ställer in mediets volym. |
Metoder
| Name | Description |
|---|---|
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Tillämpar en AnimationClock på den angivna DependencyProperty. Om egenskapen redan är animerad används den angivna HandoffBehavior . (Ärvd från Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
Tillämpar en AnimationClock på den angivna DependencyProperty. Om egenskapen redan är animerad används överlämningsbeteendet SnapshotAndReplace . (Ärvd från Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Tillämpar en animering på den angivna DependencyProperty. Animeringen startas när nästa bildruta återges. Om den angivna egenskapen redan är animerad används den angivna HandoffBehavior egenskapen. (Ärvd från Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Tillämpar en animering på den angivna DependencyProperty. Animeringen startas när nästa bildruta återges. Om den angivna egenskapen redan är animerad används överlämningsbeteendet SnapshotAndReplace . (Ärvd från Animatable) |
| CheckAccess() |
Avgör om den anropande tråden har åtkomst till den här DispatcherObject. (Ärvd från DispatcherObject) |
| ClearValue(DependencyProperty) |
Rensar det lokala värdet för en egenskap. Egenskapen som ska rensas anges av en DependencyProperty identifierare. (Ärvd från DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Rensar det lokala värdet för en skrivskyddad egenskap. Egenskapen som ska rensas anges av en DependencyPropertyKey. (Ärvd från DependencyObject) |
| Clone() |
Skapar en modifierbar klon av detta Animatableoch gör djupa kopior av objektets värden. När du kopierar det här objektets beroendeegenskaper kopierar den här metoden resursreferenser och databindningar (men de kanske inte längre matchar) men inte animeringar eller deras aktuella värden. (Ärvd från Animatable) |
| CloneCore(Freezable) |
Gör den här instansen till en djup kopia av den angivna MediaPlayer. När du kopierar beroendeegenskaper kopierar den här metoden resursreferenser och databindningar (men de kanske inte längre matchar) men inte animeringar eller deras aktuella värden. |
| CloneCurrentValue() |
Skapar en modifierbar klon (djup kopia) av med hjälp av Freezable dess aktuella värden. (Ärvd från Freezable) |
| CloneCurrentValueCore(Freezable) |
Gör den här instansen till en ändringsbar djupkopia av den angivna MediaPlayer med hjälp av aktuella egenskapsvärden. Resursreferenser, databindningar och animeringar kopieras inte, men deras aktuella värden är det. |
| Close() |
Stänger det underliggande mediet. |
| CoerceValue(DependencyProperty) |
Tvingar fram värdet för den angivna beroendeegenskapen. Detta uppnås genom att anropa alla CoerceValueCallback funktioner som anges i egenskapsmetadata för beroendeegenskapen eftersom den finns på anropet DependencyObject. (Ärvd från DependencyObject) |
| CreateInstance() |
Initierar en ny instans av Freezable klassen. (Ärvd från Freezable) |
| CreateInstanceCore() |
Skapar en ny MediaPlayer instans. |
| Equals(Object) |
Avgör om en angivet DependencyObject motsvarar den aktuella DependencyObject. (Ärvd från DependencyObject) |
| Freeze() |
Gör det aktuella objektet ommodifierbart och anger dess IsFrozen egenskap till |
| FreezeCore(Boolean) |
Gör det här Animatable objektet ommodifierbart eller avgör om det kan göras ommodifierbart. (Ärvd från Animatable) |
| GetAnimationBaseValue(DependencyProperty) |
Returnerar det icke-animerade värdet för det angivna DependencyProperty. (Ärvd från Animatable) |
| GetAsFrozen() |
Skapar en frusen Freezablekopia av , med hjälp av grundläggande (icke-animerade) egenskapsvärden. Eftersom kopian är låst kopieras alla frysta underobjekt som referens. (Ärvd från Freezable) |
| GetAsFrozenCore(Freezable) |
Gör den här instansen till en klon av det angivna MediaPlayer objektet. |
| GetCurrentValueAsFrozen() |
Skapar en frusen Freezable kopia av med aktuella egenskapsvärden. Eftersom kopian är låst kopieras alla frysta underobjekt som referens. (Ärvd från Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Gör den aktuella instansen till en frusen klon av den angivna Freezable. Om objektet har animerade beroendeegenskaper kopieras deras aktuella animerade värden. (Ärvd från Freezable) |
| GetHashCode() |
Hämtar en hash-kod för den här DependencyObject. (Ärvd från DependencyObject) |
| GetLocalValueEnumerator() |
Skapar en specialiserad uppräknare för att avgöra vilka beroendeegenskaper som har lokalt angivna värden för den här DependencyObject. (Ärvd från DependencyObject) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| GetValue(DependencyProperty) |
Returnerar det aktuella effektiva värdet för en beroendeegenskap för den här instansen av en DependencyObject. (Ärvd från DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Utvärderar det effektiva värdet för den angivna beroendeegenskapen igen. (Ärvd från DependencyObject) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| OnChanged() |
Anropas när det aktuella Freezable objektet ändras. (Ärvd från Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Den här medlemmen stöder infrastrukturen för Windows Presentation Foundation (WPF) och är inte avsedd att användas direkt från koden. (Ärvd från Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Ser till att lämpliga kontextpekare upprättas för en DependencyObjectType datamedlem som just har angetts. (Ärvd från Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Åsidosätter implementeringen DependencyObject av OnPropertyChanged(DependencyPropertyChangedEventArgs) för att även anropa alla Changed hanterare som svar på en ändrad beroendeegenskap av typen Freezable. (Ärvd från Freezable) |
| Open(Uri) |
Öppnar angivet Uri för medieuppspelning. |
| Pause() |
Pausar medieuppspelningen. |
| Play() |
Spelar upp media från den aktuella Position. |
| ReadLocalValue(DependencyProperty) |
Returnerar det lokala värdet för en beroendeegenskap, om den finns. (Ärvd från DependencyObject) |
| ReadPreamble() |
Säkerställer att MediaPlayer används från en giltig tråd. |
| SetCurrentValue(DependencyProperty, Object) |
Anger värdet för en beroendeegenskap utan att ändra dess värdekälla. (Ärvd från DependencyObject) |
| SetValue(DependencyProperty, Object) |
Anger det lokala värdet för en beroendeegenskap som anges av dess beroendeegenskapsidentifierare. (Ärvd från DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Anger det lokala värdet för en skrivskyddad beroendeegenskap som anges av identifieraren DependencyPropertyKey för beroendeegenskapen. (Ärvd från DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Returnerar ett värde som anger om serialiseringsprocesser ska serialisera värdet för den angivna beroendeegenskapen. (Ärvd från DependencyObject) |
| Stop() |
Stoppar medieuppspelning. |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |
| VerifyAccess() |
Framtvingar att den anropande tråden har åtkomst till den här DispatcherObject. (Ärvd från DispatcherObject) |
| WritePostscript() |
Genererar Changed händelsen för Freezable och anropar dess OnChanged() metod. Klasser som härleds från Freezable bör anropa den här metoden i slutet av alla API:er som ändrar klassmedlemmar som inte lagras som beroendeegenskaper. (Ärvd från Freezable) |
| WritePreamble() |
Verifierar att MediaPlayer inte är låst och att den används från en giltig trådkontext. |
Händelser
| Name | Description |
|---|---|
| BufferingEnded |
Inträffar när buffring har slutförts. |
| BufferingStarted |
Inträffar när buffring har startat. |
| Changed |
Inträffar när eller Freezable ett objekt som det innehåller ändras. (Ärvd från Freezable) |
| MediaEnded |
Inträffar när mediet har slutfört uppspelningen. |
| MediaFailed |
Inträffar när ett fel påträffas. |
| MediaOpened |
Inträffar när mediet öppnas. |
| ScriptCommand |
Inträffar när ett skriptkommando har påträffats i mediet. |