Condividi tramite


SystemMediaTransportControls Classe

Definizione

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

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.

Controlli di transtport multimediale di sistema

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 .

Si applica a

Vedi anche