SystemMediaTransportControls Kelas

Referensi

Definisi

Ruang nama:: Windows.Media

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Mewakili objek yang memungkinkan integrasi dengan kontrol transportasi media sistem dan dukungan untuk perintah media.

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

Warisan: Object Platform::Object IInspectable SystemMediaTransportControls

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Keterangan

SystemMediaTransportControls menggantikan kelas MediaControl . Di Windows 8.1 dan yang lebih baru, Anda harus menggunakan kontrol ini alih-alih MediaControl untuk berinteraksi dengan kontrol transportasi sistem. Kontrol transportasi sistem memungkinkan pengembang aplikasi media berintegrasi dengan UI sistem bawaan untuk menampilkan metadata media seperti artis, judul album, atau judul bab. Kontrol transportasi sistem juga memungkinkan pengguna untuk mengontrol pemutaran aplikasi media menggunakan UI sistem bawaan, seperti menjeda pemutaran dan melompat maju dan mundur dalam daftar putar.

Dimulai dengan Windows 10, versi 1607, aplikasi UWP yang menggunakan kelas MediaPlayer atau kelas AudioGraph untuk memutar media secara otomatis terintegrasi dengan SMTC secara default. Cukup buat instans baru MediaPlayer dan tetapkan MediaSource, MediaPlaybackItem, atau MediaPlaybackList ke properti Sumber pemutar dan pengguna akan melihat nama aplikasi Anda di SMTC dan dapat memutar, menjeda, dan menelusuri daftar pemutaran Anda dengan menggunakan kontrol SMTC. Dapatkan instans SMTC dengan mengakses properti SystemMediaTransportControls objek MediaPlayer. Untuk panduan cara menggunakan SMTC dari aplikasi Anda, lihat Mengintegrasikan dengan SystemMediaTransportControls.

Untuk beberapa skenario, Anda mungkin ingin menonaktifkan integrasi otomatis dengan SMTC. Dalam hal ini, Anda harus menonaktifkan CommandManager objek MediaPlayer dengan mengatur properti IsEnabled ke false. Panggil GetForCurrentView untuk mendapatkan instans SystemMediaTransportControls untuk tampilan saat ini. Anda juga perlu mendapatkan instans dengan cara ini jika Anda menargetkan versi Windows yang lebih lama. Untuk panduan cara mengontrol SMTC secara manual, lihat Kontrol Transportasi Media Sistem secara manual.

Properti

AutoRepeatMode	Mendapatkan atau menetapkan nilai yang mewakili mode pengulangan otomatis saat ini dari SystemMediaTransportControls.
DisplayUpdater	Mendapatkan pembaruan tampilan untuk SystemMediaTransportControls yang memungkinkan pembaruan informasi yang ditampilkan tentang lagu yang sedang diputar.
IsChannelDownEnabled	Mendapatkan atau menetapkan nilai yang menentukan apakah tombol turun saluran didukung.
IsChannelUpEnabled	Mendapatkan atau menetapkan nilai yang menentukan apakah tombol channel up didukung.
IsEnabled	Mengaktifkan dan menonaktifkan kontrol transportasi media sistem untuk aplikasi.
IsFastForwardEnabled	Mendapatkan atau menetapkan nilai yang menentukan apakah tombol maju cepat didukung.
IsNextEnabled	Mendapatkan atau mengatur nilai yang menentukan apakah tombol berikutnya didukung.
IsPauseEnabled	Mendapatkan atau mengatur nilai yang menentukan apakah tombol jeda didukung. true jika tombol jeda didukung; jika tidak, salah.
IsPlayEnabled	Mendapatkan atau mengatur nilai yang menentukan apakah tombol putar didukung.
IsPreviousEnabled	Mendapatkan atau mengatur nilai yang menentukan apakah tombol sebelumnya didukung.
IsRecordEnabled	Mendapatkan atau mengatur nilai yang menentukan apakah tombol rekaman didukung. true jika tombol rekam didukung; jika tidak, salah.
IsRewindEnabled	Mendapatkan atau mengatur nilai yang menentukan apakah tombol putar balik didukung.
IsStopEnabled	Mendapatkan atau mengatur nilai yang menentukan apakah tombol berhenti didukung.
PlaybackRate	Mendapatkan atau mengatur laju pemutaran SystemMediaTransportControls.
PlaybackStatus	Mendapatkan atau mengatur status pemutaran media.
ShuffleEnabled	Mendapatkan atau menetapkan nilai yang mewakili status acak saat ini dari SystemMediaTransportControls.
SoundLevel	Mendapatkan tingkat suara media untuk aliran pengambilan dan render.

Metode

GetForCurrentView()	Kontrol transportasi media sistem untuk tampilan saat ini.
UpdateTimelineProperties(SystemMediaTransportControlsTimelineProperties)	Updates properti garis waktu SystemMediaTransportControls dengan nilai dalam objek yang disediakan.

Acara

AutoRepeatModeChangeRequested	Terjadi ketika pengguna memodifikasi mode pengulangan otomatis SystemMediaTransportControls .
ButtonPressed	Terjadi ketika tombol ditekan pada SystemMediaTransportControls.
PlaybackPositionChangeRequested	Terjadi ketika pengguna memodifikasi posisi pemutaran SystemMediaTransportControls.
PlaybackRateChangeRequested	Terjadi ketika pengguna memodifikasi laju pemutaran SystemMediaTransportControls .
PropertyChanged	Terjadi ketika properti pada SystemMediaTransportControls telah berubah.
ShuffleEnabledChangeRequested	Terjadi ketika pengguna memodifikasi status acak SystemMediaTransportControls .

Berlaku untuk