MediaPlayer Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce la riproduzione multimediale per i disegni.
public ref class MediaPlayer : System::Windows::Media::Animation::Animatablepublic class MediaPlayer : System.Windows.Media.Animation.Animatabletype MediaPlayer = class
inherit Animatable
interface DUCE.IResourcetype MediaPlayer = class
inherit AnimatablePublic Class MediaPlayer
Inherits Animatable- Ereditarietà
Esempio
Procedura: Riprodurre contenuti multimediali con videoDrawing
Commenti
Sebbene sia possibile dichiarare un'istanza di questa classe in XAML (Extensible Application Markup Language), non è possibile caricare e riprodurre i supporti senza usare il codice. Per riprodurre solo elementi multimediali in XAML, usare un oggetto MediaElement. Inoltre, se dichiari un'istanza in XAML, l'unico uso pratico consiste nel riempire la sintassi degli elementi delle proprietà per la Player proprietà .
Quando si distribuiscono supporti con l'applicazione, non è possibile usare un file multimediale come risorsa di progetto. Nel file di progetto è invece necessario impostare il tipo di supporto su Content e impostare su PreserveNewestCopyToOutputDirectory o Always.
MediaPlayer può essere usato in due modalità diverse, a seconda di ciò che sta guidando il giocatore: modalità indipendente o modalità orologio. In modalità indipendente, MediaPlayer è analogo a un'immagine e il supporto aperto tramite il Open metodo di riproduzione. In modalità Orologio, può MediaPlayer essere considerato come destinazione per un'animazione e quindi avrà voci e Clock corrispondenti Timeline nell'albero Temporizzazione che controlla la riproduzione. Per altre informazioni sulle modalità multimediali, vedere La panoramica multimediale.
MediaPlayer è diverso da in MediaElement quanto non è un controllo che può essere aggiunto direttamente all'interfaccia utente di un'applicazione. Per visualizzare i supporti caricati tramite MediaPlayer, è necessario usare o VideoDrawingDrawingContext .
Costruttori
| Nome | Descrizione |
|---|---|
| MediaPlayer() |
Inizializza una nuova istanza della classe MediaPlayer. |
Proprietà
| Nome | Descrizione |
|---|---|
| Balance |
Ottiene o imposta il bilanciamento tra i volumi altoparlanti sinistro e destro. |
| BufferingProgress |
Ottiene la percentuale di buffering completato per il contenuto di streaming. |
| CanFreeze |
Ottiene un valore che indica se l'oggetto può essere reso non modificabile. (Ereditato da Freezable) |
| CanPause |
Ottiene un valore che indica se il supporto può essere sospeso. |
| Clock |
Ottiene o imposta l'oggetto MediaClock associato all'oggetto MediaTimeline da riprodurre. |
| DependencyObjectType |
Ottiene l'oggetto DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza. (Ereditato da DependencyObject) |
| Dispatcher |
Ottiene l'oggetto DispatcherDispatcherObject a cui è associato. (Ereditato da DispatcherObject) |
| DownloadProgress |
Ottiene la percentuale di avanzamento del download per il contenuto che si trova in un server remoto. |
| HasAnimatedProperties |
Ottiene un valore che indica se uno o più AnimationClock oggetti sono associati a una delle proprietà di dipendenza di questo oggetto. (Ereditato da Animatable) |
| HasAudio |
Ottiene un valore che indica se l'output audio del supporto è contenuto. |
| HasVideo |
Ottiene un valore che indica se l'output multimediale è contenuto video. |
| IsBuffering |
Ottiene un valore che indica se il supporto è memorizzato nel buffer. |
| IsFrozen |
Ottiene un valore che indica se l'oggetto è attualmente modificabile. (Ereditato da Freezable) |
| IsMuted |
Ottiene un valore che indica se il supporto è disattivato. |
| IsSealed |
Ottiene un valore che indica se questa istanza è attualmente sealed (sola lettura). (Ereditato da DependencyObject) |
| NaturalDuration |
Ottiene la durata naturale del supporto. |
| NaturalVideoHeight |
Ottiene l'altezza in pixel del video. |
| NaturalVideoWidth |
Ottiene la larghezza in pixel del video. |
| Position |
Ottiene o imposta la posizione corrente del supporto. |
| ScrubbingEnabled |
Ottiene o imposta un valore che indica se lo scrubbing è abilitato. |
| Source |
Ottiene il supporto Uri. |
| SpeedRatio |
Ottiene o imposta il rapporto di velocità con cui viene riprodotto il contenuto multimediale. |
| Volume |
Ottiene o imposta il volume del supporto. |
Metodi
| Nome | Descrizione |
|---|---|
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Applica un oggetto AnimationClock all'oggetto specificato DependencyProperty. Se la proprietà è già animata, viene utilizzato l'oggetto specificato HandoffBehavior . (Ereditato da Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
Applica un oggetto AnimationClock all'oggetto specificato DependencyProperty. Se la proprietà è già animata, viene utilizzato il SnapshotAndReplace comportamento di handoff. (Ereditato da Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Applica un'animazione all'oggetto specificato DependencyProperty. L'animazione viene avviata quando viene eseguito il rendering del fotogramma successivo. Se la proprietà specificata è già animata, viene utilizzato l'oggetto specificato HandoffBehavior . (Ereditato da Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Applica un'animazione all'oggetto specificato DependencyProperty. L'animazione viene avviata quando viene eseguito il rendering del fotogramma successivo. Se la proprietà specificata è già animata, viene utilizzato il SnapshotAndReplace comportamento di handoff. (Ereditato da Animatable) |
| CheckAccess() |
Determina se il thread chiamante ha accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject) |
| ClearValue(DependencyProperty) |
Cancella il valore locale di una proprietà. La proprietà da cancellare viene specificata da un DependencyProperty identificatore. (Ereditato da DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare viene specificata da un oggetto DependencyPropertyKey. (Ereditato da DependencyObject) |
| Clone() |
Crea un clone modificabile di questo Animatableoggetto , eseguendo copie complete dei valori di questo oggetto. Quando si copiano le proprietà di dipendenza di questo oggetto, questo metodo copia i riferimenti alle risorse e i data binding (ma potrebbero non essere più risolti), ma non le animazioni o i relativi valori correnti. (Ereditato da Animatable) |
| CloneCore(Freezable) |
Rende questa istanza una copia completa dell'oggetto specificato MediaPlayer. Quando si copiano le proprietà di dipendenza, questo metodo copia i riferimenti alle risorse e i data binding (ma potrebbero non essere più risolti), ma non le animazioni o i relativi valori correnti. |
| CloneCurrentValue() |
Crea un clone modificabile (copia completa) dell'oggetto Freezable utilizzando i relativi valori correnti. (Ereditato da Freezable) |
| CloneCurrentValueCore(Freezable) |
Rende questa istanza una copia completa modificabile dell'oggetto specificato MediaPlayer utilizzando i valori delle proprietà correnti. I riferimenti alle risorse, i data binding e le animazioni non vengono copiati, ma i relativi valori correnti sono. |
| Close() |
Chiude il supporto sottostante. |
| CoerceValue(DependencyProperty) |
Forza il valore della proprietà di dipendenza specificata. A tale scopo, richiamare qualsiasi CoerceValueCallback funzione specificata nei metadati della proprietà per la proprietà di dipendenza così come esiste nella chiamata DependencyObjectdi . (Ereditato da DependencyObject) |
| CreateInstance() |
Inizializza una nuova istanza della classe Freezable. (Ereditato da Freezable) |
| CreateInstanceCore() |
Crea una nuova istanza di MediaPlayer. |
| Equals(Object) |
Determina se un oggetto specificato DependencyObject è equivalente all'oggetto corrente DependencyObject. (Ereditato da DependencyObject) |
| Freeze() |
Rende l'oggetto corrente non modificabile e imposta la relativa IsFrozen proprietà su |
| FreezeCore(Boolean) |
Animatable Rende questo oggetto non modificabile o determina se può essere reso non modificabile. (Ereditato da Animatable) |
| GetAnimationBaseValue(DependencyProperty) |
Restituisce il valore non animato dell'oggetto specificato DependencyProperty. (Ereditato da Animatable) |
| GetAsFrozen() |
Crea una copia bloccata della proprietà , utilizzando i valori della Freezableproprietà base (non animati). Poiché la copia è bloccata, tutti gli oggetti secondari bloccati vengono copiati in base al riferimento. (Ereditato da Freezable) |
| GetAsFrozenCore(Freezable) |
Rende questa istanza un clone dell'oggetto specificato MediaPlayer . |
| GetCurrentValueAsFrozen() |
Crea una copia bloccata dell'oggetto utilizzando i valori correnti delle Freezable proprietà. Poiché la copia è bloccata, tutti gli oggetti secondari bloccati vengono copiati in base al riferimento. (Ereditato da Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Rende l'istanza corrente un clone bloccato dell'oggetto specificato Freezable. Se l'oggetto ha proprietà di dipendenza animate, i valori animati correnti vengono copiati. (Ereditato da Freezable) |
| GetHashCode() |
Ottiene un codice hash per l'oggetto DependencyObject. (Ereditato da DependencyObject) |
| GetLocalValueEnumerator() |
Crea un enumeratore specializzato per determinare quali proprietà di dipendenza hanno valori impostati localmente in questo DependencyObjectoggetto . (Ereditato da DependencyObject) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| GetValue(DependencyProperty) |
Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di un oggetto DependencyObject. (Ereditato da DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Rivaluta il valore effettivo per la proprietà di dipendenza specificata. (Ereditato da DependencyObject) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnChanged() |
Chiamato quando l'oggetto corrente Freezable viene modificato. (Ereditato da Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Questo membro supporta l'infrastruttura di Windows Presentation Foundation (WPF) e non deve essere usato direttamente dal codice. (Ereditato da Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Assicura che vengano stabiliti puntatori di contesto appropriati per un DependencyObjectType membro dati appena impostato. (Ereditato da Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Esegue l'override dell'implementazione DependencyObject di OnPropertyChanged(DependencyPropertyChangedEventArgs) per richiamare anche i Changed gestori in risposta a una proprietà di dipendenza modificata di tipo Freezable. (Ereditato da Freezable) |
| Open(Uri) |
Apre l'oggetto specificato Uri per la riproduzione multimediale. |
| Pause() |
Sospende la riproduzione multimediale. |
| Play() |
Riproduce elementi multimediali dall'oggetto corrente Position. |
| ReadLocalValue(DependencyProperty) |
Restituisce il valore locale di una proprietà di dipendenza, se esistente. (Ereditato da DependencyObject) |
| ReadPreamble() |
Assicura che l'accesso a MediaPlayer venga eseguito da un thread valido. |
| SetCurrentValue(DependencyProperty, Object) |
Imposta il valore di una proprietà di dipendenza senza modificarne l'origine del valore. (Ereditato da DependencyObject) |
| SetValue(DependencyProperty, Object) |
Imposta il valore locale di una proprietà di dipendenza, specificato dall'identificatore della proprietà di dipendenza. (Ereditato da DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza. (Ereditato da DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore per la proprietà di dipendenza specificata. (Ereditato da DependencyObject) |
| Stop() |
Arresta la riproduzione multimediale. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| VerifyAccess() |
Impone che il thread chiamante abbia accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject) |
| WritePostscript() |
Genera l'evento Changed per Freezable e richiama il relativo OnChanged() metodo. Le classi che derivano da Freezable devono chiamare questo metodo alla fine di qualsiasi API che modifica i membri della classe non archiviati come proprietà di dipendenza. (Ereditato da Freezable) |
| WritePreamble() |
Verifica che MediaPlayer non sia bloccato e che sia accessibile da un contesto di threading valido. |
Eventi
| Nome | Descrizione |
|---|---|
| BufferingEnded |
Si verifica al termine del buffering. |
| BufferingStarted |
Si verifica all'avvio del buffering. |
| Changed |
Si verifica quando l'oggetto Freezable o un oggetto che contiene viene modificato. (Ereditato da Freezable) |
| MediaEnded |
Si verifica al termine della riproduzione degli elementi multimediali. |
| MediaFailed |
Si verifica quando viene rilevato un errore. |
| MediaOpened |
Si verifica all'apertura del supporto. |
| ScriptCommand |
Si verifica quando viene rilevato un comando script all'interno del supporto. |
