MediaPlayer Classe

Definizione

Fornisce l'accesso alle funzionalità di riproduzione multimediale, ad esempio riproduzione, sospensione, avanzamento rapido, riavvolgimento e 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
Ereditarietà
Object Platform::Object IInspectable MediaPlayer
Attributi
Implementazioni

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

La sezione Riproduzione multimediale della documentazione contiene articoli sulle procedure che forniscono indicazioni dettagliate per l'aggiunta di funzionalità di riproduzione multimediale all'app. Nella tabella seguente sono elencati alcuni degli articoli disponibili.

Argomento Descrizione
Riprodurre audio e video con MediaPlayer Mostra come sfruttare le nuove funzionalità e i miglioramenti apportati al sistema di riproduzione multimediale per le app UWP.
Elementi multimediali, playlist e tracce Illustra come usare la classe MediaSource , che offre un modo comune per fare riferimento e riprodurre supporti da origini diverse, ad esempio file locali o remoti, ed espone un modello comune per l'accesso ai dati multimediali, indipendentemente dal formato multimediale sottostante.
Integrare con i controlli di trasporto multimediale di sistema Illustra come integrare l'app con i controlli SMTC (System Media Transport Controls).
Segnali di metadati temporizzati supportati dal sistema Viene descritto come sfruttare diversi formati di metadati temporali che possono essere incorporati in file multimediali o flussi.
Creare, pianificare e gestire le interruzioni di elementi multimediali Illustra come creare, pianificare e gestire interruzioni multimediali per l'app di riproduzione multimediale.
Riprodurre elementi multimediali in background Illustra come configurare l'app in modo che i supporti continuino a essere riprodotti quando l'app passa dal primo piano allo sfondo.
Streaming adattivo Descrive come aggiungere la riproduzione di contenuti multimediali di streaming adattivi a un'app UWP (piattaforma UWP (Universal Windows Platform)).
Casting multimediale Illustra come eseguire il cast di supporti a dispositivi remoti da un'app di Windows universale.
PlayReady DRM Descrive come aggiungere contenuto multimediale protetto da PlayReady all'app piattaforma UWP (Universal Windows Platform) (UWP).

Esempi dell'SDK per la riproduzione multimediale

Gli esempi dell'SDK seguente sono una dimostrazione delle funzionalità di riproduzione multimediale disponibili per le app UWP in Windows 10. Usa questi esempi per esaminare le API di riproduzione multimediale usate in contesto oppure come punto di partenza per la tua app.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1511 10586 AddAudioEffect
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

Costruttori

MediaPlayer()

Inizializza una nuova istanza dell'oggetto MediaPlayer .

Proprietà

AudioBalance

Ottiene o imposta un rapporto di volume tra altoparlanti stereo.

AudioCategory

Ottiene o imposta il tipo di audio attualmente riprodotto.

AudioDevice

Ottiene o imposta l'oggetto DeviceInformation che rappresenta il dispositivo audio utilizzato da MediaPlayer per il rendering dell'audio.

AudioDeviceType

Ottiene o imposta un valore che descrive l'utilizzo primario del dispositivo utilizzato per riprodurre l'audio.

AudioStateMonitor

Ottiene un oggetto AudioStateMonitor che consente a un'app UWP di determinare se uno dei flussi audio dell'app è attualmente disattivato o se il volume è ridotto dal sistema.

AutoPlay

Ottiene o imposta un valore booleano che indica se la riproduzione viene avviata automaticamente dopo il caricamento del supporto.

BreakManager

Ottiene l'oggetto MediaBreakManager associato a MediaPlayer, che fornisce informazioni sulle interruzioni multimediali e sul controllo delle interruzioni multimediali per il lettore.

BufferingProgress

Ottiene la quantità di buffering completata per il contenuto multimediale, espresso come percentuale.

Nota

MediaPlayer.BufferingProgress può essere modificato o non disponibile dopo Windows 10 versione 1607. Utilizzare invece la proprietà MediaPlayer.PlaybackSession per ottenere un oggetto MediaPlaybackSession e quindi utilizzare la proprietà MediaPlaybackSession.BufferingProgress .

CanPause

Ottiene un valore booleano che indica se il supporto può essere sospeso.

Nota

MediaPlayer.CanPause può essere modificato o non disponibile dopo Windows 10 versione 1607. Utilizzare invece la proprietà MediaPlayer.PlaybackSession per ottenere un oggetto MediaPlaybackSession e quindi utilizzare la proprietà MediaPlaybackSession.CanPause .

CanSeek

Ottiene un valore booleano che indica se il supporto supporta la ricerca di una posizione specifica.

Nota

MediaPlayer.CanSeek può essere modificato o non disponibile dopo Windows 10 versione 1607. Utilizzare invece la proprietà MediaPlayer.PlaybackSession per ottenere un oggetto MediaPlaybackSession e quindi utilizzare la proprietà MediaPlaybackSession.CanSeek .

CommandManager

Ottiene mediaPlaybackCommandManager associato a MediaPlayer, che specifica il comportamento di e riceve gli eventi dai controlli di trasporto multimediale di sistema.

CurrentState

Ottiene lo stato corrente della riproduzione multimediale.

Nota

MediaPlayer.CurrentState può essere modificato o non disponibile dopo Windows 10 versione 1607. Utilizzare invece la proprietà MediaPlayer.PlaybackSession per ottenere un oggetto MediaPlaybackSession e quindi utilizzare la proprietà MediaPlaybackSession.PlaybackState .

IsLoopingEnabled

Ottiene o imposta un valore booleano che indica se il contenuto multimediale verrà riprodotto in un ciclo ripetuto.

IsMuted

Ottiene o imposta un valore booleano che indica se l'audio è disattivato.

IsProtected

Ottiene un valore booleano che indica se il contenuto è protetto da un sistema di gestione dei diritti digitali.

Nota

MediaPlayer.IsProtected può essere modificato o non disponibile dopo Windows 10 versione 1607. Usa invece la proprietà MediaPlayer.PlaybackSession per ottenere un oggetto MediaPlaybackSession e quindi usa la proprietà IsProtected .

IsVideoFrameServerEnabled

Ottiene un valore che indica se la modalità server fotogrammi video è abilitata per l'istanza di MediaPlayer .

NaturalDuration

Ottiene la durata effettiva del supporto senza applicare PlaybackRate.

Nota

MediaPlayer.NaturalDuration può essere modificato o non disponibile dopo Windows 10 versione 1607. Utilizzare invece la proprietà MediaPlayer.PlaybackSession per ottenere un oggetto MediaPlaybackSession e quindi utilizzare la proprietà MediaPlaybackSession.NaturalDuration .

PlaybackMediaMarkers

Ottiene la raccolta di marcatori della sequenza temporale per il supporto.

Nota

MediaPlayer.PlaybackMediaMarkers può essere modificato o non disponibile dopo Windows 10 versione 1607. Usare invece MediaPlaybackItem.TimedMetadataTracks per gestire i dati o i segnali di testo. Per altre informazioni, vedere Riproduzione multimediale con MediaSource.

PlaybackRate

Ottiene o imposta la frequenza di riproduzione, espressa come rapporto.

Nota

MediaPlayer.PlaybackRate può essere modificato o non disponibile dopo Windows 10 versione 1607. Utilizzare invece la proprietà MediaPlayer.PlaybackSession per ottenere un oggetto MediaPlaybackSession e quindi utilizzare la proprietà MediaPlaybackSession.PlaybackRate .

PlaybackSession

Ottiene l'oggetto MediaPlaybackSession associato a MediaPlayer, che fornisce informazioni sullo stato della sessione di riproduzione corrente e fornisce eventi per rispondere alle modifiche apportate allo stato della sessione di riproduzione.

Position

Ottiene o imposta la posizione di riproduzione all'interno del supporto.

Nota

MediaPlayer.Position può essere modificato o non disponibile dopo Windows 10 versione 1607. Utilizzare invece la proprietà MediaPlayer.PlaybackSession per ottenere un oggetto MediaPlaybackSession e quindi utilizzare la proprietà MediaPlaybackSession.Position .

ProtectionManager

Ottiene o imposta lo strumento di gestione protezione del contenuto per il supporto.

RealTimePlayback

Ottiene o imposta un valore che configura MediaPlayer per scenari in tempo reale, ad esempio video in streaming live.

Source

Imposta l'origine di riproduzione del lettore multimediale.

StereoscopicVideoRenderMode

Ottiene o imposta un valore che indica la modalità di rendering stereoscopica corrente.

SystemMediaTransportControls

Ottiene un'istanza della classe SystemMediaTransportControls per abilitare il controllo utente della riproduzione di MediaPlayer e per consentire all'app di visualizzare informazioni sul contenuto attualmente in riproduzione nell'interfaccia utente di sistema.

TimelineController

Ottiene o imposta MediaTimelineController associato a MediaPlayer. Usare questa proprietà per modificare più istanze di MediaPlayer con un singolo controllo sequenza temporale.

TimelineControllerPositionOffset

Ottiene o imposta l'offset applicato alla posizione di MediaTimelineController associato a MediaPlayer.

Volume

Ottiene o imposta il volume audio per la riproduzione multimediale.

Metodi

AddAudioEffect(String, Boolean, IPropertySet)

Aggiunge un effetto audio al flusso di riproduzione di MediaPlayer.

AddVideoEffect(String, Boolean, IPropertySet)

Applica un effetto video alla riproduzione multimediale.

Close()

Chiude MediaPlayer ed elimina le risorse associate.

CopyFrameToStereoscopicVideoSurfaces(IDirect3DSurface, IDirect3DSurface)

Copia il fotogramma video attualmente visualizzato da MediaPlayer nei due oggetti IDirect3DSurface forniti che rappresentano il contenuto dell'occhio sinistro e dell'occhio destro di un fotogramma video stereoscopico.

CopyFrameToVideoSurface(IDirect3DSurface)

Copia il fotogramma video corrente da MediaPlayerall'oggetto IDirect3DSurface specificato.

CopyFrameToVideoSurface(IDirect3DSurface, Rect)

Copia il fotogramma video corrente da MediaPlayer al rettangolo di destinazione specificato all'interno dell'oggetto IDirect3DSurface specificato.

Dispose()

Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.

GetAsCastingSource()

Ottiene un oggetto CastingSource che rappresenta MediaPlayer, che consente il cast dei relativi supporti ad altri dispositivi.

GetSurface(Compositor)

Ottiene un oggetto MediaPlayerSurface per MediaPlayer, che consente di eseguire il rendering del contenuto del lettore usando un compositor senza basarsi sul framework XAML.

Pause()

Mette in pausa la riproduzione multimediale

Play()

Avvia la riproduzione multimediale.

RemoveAllEffects()

Rimuove tutti gli effetti dal flusso di riproduzione di MediaPlayer.

RenderSubtitlesToSurface(IDirect3DSurface)

Richiede al sistema di eseguire il rendering del testo del sottotitolo corrente nell'oggetto IDirect3DSurface specificato.

RenderSubtitlesToSurface(IDirect3DSurface, Rect)

Richiede al sistema di eseguire il rendering del testo del sottotitolo corrente nel rettangolo di destinazione specificato all'interno dell'oggetto IDirect3DSurface specificato.

SetFileSource(IStorageFile)

Impostare l'origine multimediale su un file.

Nota

MediaPlayer.SetFileSource può essere modificato o non disponibile dopo Windows 10. Usare invece MediaPlayer.Source .

SetMediaSource(IMediaSource)

Imposta l'origine multimediale per la riproduzione.

Nota

MediaPlayer.SetMediaSource può essere modificato o non disponibile dopo Windows 10. Usare invece MediaPlayer.Source .

SetStreamSource(IRandomAccessStream)

Imposta l'origine multimediale su un flusso.

Nota

MediaPlayer.SetMediaSource può essere modificato o non disponibile dopo Windows 10. Usare invece MediaPlayer.Source .

SetSurfaceSize(Size)

Imposta le dimensioni della superficie di composizione restituita da GetSurface.

SetUriSource(Uri)

Imposta il percorso del supporto.

Nota

MediaPlayer.SetUriSource può essere modificato o non disponibile dopo Windows 10. Usare invece MediaPlayer.Source .

StepBackwardOneFrame()

Fa sì che la posizione di riproduzione di MediaPlayer si sposti all'indietro di 042 secondi, che corrisponde a un fotogramma a 24 fps, indipendentemente dalla frequenza effettiva dei fotogrammi del contenuto riprodotto.

StepForwardOneFrame()

Fa sì che MediaPlayer passi avanti nel supporto corrente di un fotogramma.

Eventi

BufferingEnded

Si verifica al termine della memorizzazione nel buffer.

Nota

MediaPlayer.BufferingEnded può essere modificato o non disponibile dopo Windows 10 versione 1607. Usa invece la proprietà MediaPlayer.PlaybackSession per ottenere un oggetto MediaPlaybackSession e quindi usa l'evento MediaPlaybackSession.BufferingEnded .

BufferingStarted

Si verifica all'avvio della memorizzazione nel buffer.

Nota

MediaPlayer.BufferingStarted può essere modificato o non disponibile dopo Windows 10 versione 1607. Usa invece la proprietà MediaPlayer.PlaybackSession per ottenere un oggetto MediaPlaybackSession e quindi usa l'evento MediaPlaybackSession.BufferingStarted .

CurrentStateChanged

Si verifica quando lo stato del lettore multimediale è cambiato.

Nota

MediaPlayer.CurrentStateChanged può essere modificato o non disponibile dopo Windows 10 versione 1607. Usa invece la proprietà MediaPlayer.PlaybackSession per ottenere un oggetto MediaPlaybackSession e quindi usa l'evento MediaPlaybackSession.PlaybackStateChanged .

IsMutedChanged

Si verifica quando lo stato disattivato corrente di MediaPlayer cambia.

MediaEnded

Si verifica al termine della riproduzione dell'elemento multimediale.

MediaFailed

Si verifica quando viene rilevato un errore.

MediaOpened

Si verifica all'apertura dell'elemento multimediale.

MediaPlayerRateChanged

Si verifica quando la frequenza di riproduzione multimediale è cambiata.

Nota

MediaPlayer.MediaPlayerRateChanged può essere modificato o non disponibile dopo Windows 10 versione 1607. Usa invece la proprietà MediaPlayer.PlaybackSession per ottenere un oggetto MediaPlaybackSession e quindi usa l'evento MediaPlaybackSession.PlaybackRateChanged .

PlaybackMediaMarkerReached

Si verifica quando viene raggiunto un marcatore multimediale durante la riproduzione.

Nota

MediaPlayer.PlaybackMediaMarkerReached può essere modificato o non disponibile dopo Windows 10 versione 1607. Usare invece MediaPlaybackItem.TimedMetadataTracks per gestire i dati o i segnali di testo. Per altre informazioni, vedere Riproduzione multimediale con MediaSource.

SeekCompleted

Si verifica al termine di un'operazione di ricerca.

Nota

MediaPlayer.SeekCompleted può essere modificato o non disponibile dopo Windows 10 versione 1607. Usa invece la proprietà MediaPlayer.PlaybackSession per ottenere un oggetto MediaPlaybackSession e quindi usa l'evento MediaPlaybackSession.SeekCompleted .

SourceChanged

Si verifica quando viene modificata l'origine multimediale per MediaPlayer .

SubtitleFrameChanged

Si verifica quando il contenuto del sottotitolo corrente è cambiato mentre MediaPlayer è in modalità server frame.

VideoFrameAvailable

Si verifica quando IsVideoFrameServerEnabled è impostato su true e per l'elaborazione è disponibile un nuovo fotogramma video.

VolumeChanged

Si verifica quando il volume dell'audio è cambiato.

Si applica a