SystemMediaTransportControls Kelas
Definisi
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.
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
- Atribut
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 . |