SystemMediaTransportControls Classe

Definizione

Spazio dei nomi:

Windows.Media

Rappresenta un oggetto che consente l'integrazione con i controlli di trasporto multimediale di sistema e il supporto per i comandi multimediali.

public ref class SystemMediaTransportControls sealed

/// [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.MTA)]
class SystemMediaTransportControls final

[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.MTA)]
public sealed class SystemMediaTransportControls

Public NotInheritable Class SystemMediaTransportControls

Ereditarietà

Object Platform::Object IInspectable SystemMediaTransportControls

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

SystemMediaTransportControls sostituisce la classe MediaControl . In Windows 8.1 e versioni successive, è consigliabile usare questo controllo anziché MediaControl per interagire con i controlli di trasporto di sistema. I controlli di trasporto di sistema consentono agli sviluppatori di applicazioni multimediali di integrarsi con l'interfaccia utente di sistema predefinita per visualizzare metadati multimediali, ad esempio artista, titolo album o titolo del capitolo. Il controllo trasporto di sistema consente anche a un utente di controllare la riproduzione di un'app multimediale usando l'interfaccia utente di sistema predefinita, ad esempio sospendere la riproduzione e ignorare la riproduzione e l'indietro in una playlist.

A partire da Windows 10, la versione 1607, le app UWP che usano la classe MediaPlayer o la classe AudioGraph per riprodurre i supporti vengono automaticamente integrate con smTC per impostazione predefinita. È sufficiente creare un'istanza di MediaPlayer e assegnare un'istanza di MediaSource, MediaPlaybackItem o MediaPlaybackList alla proprietà Source del lettore e l'utente visualizzerà il nome dell'app nel SMTC e può riprodurre, sospendere e spostare gli elenchi di riproduzione usando i controlli SMTC. Ottenere un'istanza di SMTC accedendo alla proprietà SystemMediaTransportControls dell'oggetto MediaPlayer. Per indicazioni sull'uso di SMTC dall'app, vedere Integrare con SystemMediaTransportControls.

Per alcuni scenari, è possibile disabilitare l'integrazione automatica con SMTC. In questo caso, è necessario disabilitare CommandManager dell'oggetto MediaPlayer impostando la proprietà IsEnabled su false. Chiamare GetForCurrentView per ottenere un'istanza di SystemMediaTransportControls per la visualizzazione corrente. Sarà anche necessario ottenere un'istanza in questo modo se si punta a una versione precedente di Windows. Per indicazioni su come controllare manualmente il SMTC, vedere Controllo manuale dei controlli trasporto multimediali di sistema.

Proprietà

AutoRepeatMode	Ottiene o imposta un valore che rappresenta la modalità di ripetizione automatica corrente di SystemMediaTransportControls.
DisplayUpdater	Ottiene l'aggiornamento visualizzato per SystemMediaTransportControls che abilita l'aggiornamento delle informazioni visualizzate sul brano attualmente in riproduzione.
IsChannelDownEnabled	Ottiene o imposta un valore che specifica se il pulsante a discesa del canale è supportato.
IsChannelUpEnabled	Ottiene o imposta un valore che specifica se il pulsante di up del canale è supportato.
IsEnabled	Abilita e disabilita i controlli di trasporto multimediale di sistema per l'app.
IsFastForwardEnabled	Ottiene o imposta un valore che specifica se il pulsante di inoltro rapido è supportato.
IsNextEnabled	Ottiene o imposta un valore che specifica se il pulsante successivo è supportato.
IsPauseEnabled	Ottiene o imposta un valore che specifica se il pulsante di sospensione è supportato. true se il pulsante di sospensione è supportato; in caso contrario, false.
IsPlayEnabled	Ottiene o imposta un valore che specifica se il pulsante play è supportato.
IsPreviousEnabled	Ottiene o imposta un valore che specifica se il pulsante precedente è supportato.
IsRecordEnabled	Ottiene o imposta un valore che specifica se il pulsante record è supportato. true se il pulsante record è supportato; in caso contrario, false.
IsRewindEnabled	Ottiene o imposta un valore che specifica se il pulsante rewind è supportato.
IsStopEnabled	Ottiene o imposta un valore che specifica se il pulsante di arresto è supportato.
PlaybackRate	Ottiene o imposta la frequenza di riproduzione di SystemMediaTransportControls.
PlaybackStatus	Ottiene o imposta lo stato di riproduzione del supporto.
ShuffleEnabled	Ottiene o imposta un valore che rappresenta lo stato di shuffle corrente di SystemMediaTransportControls.
SoundLevel	Ottiene il livello audio del supporto per l'acquisizione e il rendering dei flussi.

Metodi

GetForCurrentView()	I controlli di trasporto multimediale di sistema per la visualizzazione corrente.
UpdateTimelineProperties(SystemMediaTransportControlsTimelineProperties)	Aggiornamenti le proprietà della sequenza temporale SystemMediaTransportControls con i valori nell'oggetto specificato.

Eventi

AutoRepeatModeChangeRequested	Si verifica quando l'utente modifica la modalità di ripetizione automatica SystemMediaTransportControls .
ButtonPressed	Si verifica quando viene premuto un pulsante su SystemMediaTransportControls.
PlaybackPositionChangeRequested	Si verifica quando l'utente modifica la posizione di riproduzione di SystemMediaTransportControls.
PlaybackRateChangeRequested	Si verifica quando l'utente modifica la frequenza di riproduzione SystemMediaTransportControls .
PropertyChanged	Si verifica quando una proprietà in SystemMediaTransportControls è stata modificata.
ShuffleEnabledChangeRequested	Si verifica quando l'utente modifica lo stato shuffle systemMediaTransportControls .

Vedi anche

• Integrare con SystemMediaTransportControls
• Controllo manuale dei controlli di trasporto multimediale di sistema
• Esempio di controlli di trasporto multimediale di sistema