MediaPlayer Classe

Definizione

Spazio dei nomi:

Windows.Media.Playback

Fornisce l'accesso alle funzionalità di riproduzione multimediale, ad esempio riproduzione, sospensione, avanzamento rapido, riavvolgimento e 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

Ereditarietà

Object Platform::Object IInspectable MediaPlayer

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute ActivatableAttribute

Implementazioni

IClosable IDisposable

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.

• Esempio di flusso adattivo
• Esempio di audio in background
• Esempio di trasporto multimediale di sistema
• Esempio di riproduzione video a 360 gradi
• Esempio di riproduzione multimediale in background
• Esempio di sincronizzazione della riproduzione video

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.