SystemMediaTransportControls Класс

Определение

Пространство имен:

Windows.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

Наследование

Object Platform::Object IInspectable SystemMediaTransportControls

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

SystemMediaTransportControls заменяет класс MediaControl . В Windows 8.1 и более поздних версий этот элемент управления следует использовать вместо MediaControl для взаимодействия с системными элементами управления транспортировкой. Системные элементы управления транспортировкой позволяют разработчикам приложений мультимедиа интегрироваться со встроенным системным пользовательским интерфейсом для отображения метаданных мультимедиа, таких как исполнитель, название альбома или название главы. Элемент управления транспортировкой системы также позволяет пользователю управлять воспроизведением мультимедийного приложения с помощью встроенного системного пользовательского интерфейса, например приостановки воспроизведения и пропускания вперед и назад в списке воспроизведения.

Начиная с Windows 10 версии 1607, приложения UWP, использующие класс MediaPlayer или Класс AudioGraph для воспроизведения мультимедиа, по умолчанию автоматически интегрируются с SMTC. Просто создайте новый экземпляр MediaPlayer и назначьте MediaSource, MediaPlaybackItem или MediaPlaybackList свойству Source проигрывателя, чтобы пользователь увидел имя вашего приложения в SMTC и сможет воспроизводить, приостанавливать и перемещаться по спискам воспроизведения с помощью элементов управления SMTC. Получите экземпляр SMTC, перейдя к свойству SystemMediaTransportControls объекта MediaPlayer. Инструкции по использованию SMTC из приложения см. в статье Интеграция с SystemMediaTransportControls.

В некоторых сценариях может потребоваться отключить автоматическую интеграцию с SMTC. В этом случае следует отключить commandManager объекта MediaPlayer, задав свойству IsEnabled значение false. Вызовите Метод GetForCurrentView , чтобы получить экземпляр SystemMediaTransportControls для текущего представления. Вам также потребуется получить экземпляр таким образом, если вы используете более раннюю версию Windows. Инструкции по ручному управлению SMTC см. в разделе Ручное управление системными элементами управления транспортировкой мультимедиа.

Свойства

AutoRepeatMode	Возвращает или задает значение, представляющее текущий режим автоматического повтора SystemMediaTransportControls.
DisplayUpdater	Возвращает средство обновления отображения для SystemMediaTransportControls , которое позволяет обновлять сведения о воспроизводимой в данный момент песне.
IsChannelDownEnabled	Возвращает или задает значение, указывающее, поддерживается ли кнопка уменьшения канала.
IsChannelUpEnabled	Возвращает или задает значение, указывающее, поддерживается ли кнопка "Вверх по каналу".
IsEnabled	Включает и отключает системные элементы управления транспортировкой мультимедиа для приложения.
IsFastForwardEnabled	Возвращает или задает значение, указывающее, поддерживается ли кнопка быстрого продвижения вперед.
IsNextEnabled	Возвращает или задает значение, указывающее, поддерживается ли кнопка "Следующий".
IsPauseEnabled	Возвращает или задает значение, указывающее, поддерживается ли кнопка приостановки. значение true , если кнопка приостановки поддерживается; в противном случае — false.
IsPlayEnabled	Возвращает или задает значение, указывающее, поддерживается ли кнопка воспроизведения.
IsPreviousEnabled	Возвращает или задает значение, указывающее, поддерживается ли предыдущая кнопка.
IsRecordEnabled	Возвращает или задает значение, указывающее, поддерживается ли кнопка записи. Значение true , если кнопка записи поддерживается; в противном случае — false.
IsRewindEnabled	Возвращает или задает значение, указывающее, поддерживается ли кнопка перемотки.
IsStopEnabled	Возвращает или задает значение, указывающее, поддерживается ли кнопка остановки.
PlaybackRate	Возвращает или задает скорость воспроизведения объекта SystemMediaTransportControls.
PlaybackStatus	Возвращает или задает состояние воспроизведения мультимедиа.
ShuffleEnabled	Возвращает или задает значение, представляющее текущее состояние тасовки SystemMediaTransportControls.
SoundLevel	Возвращает уровень звука мультимедиа для потоков захвата и отрисовки.

Методы

GetForCurrentView()	Системные элементы управления транспортировкой мультимедиа для текущего представления.
UpdateTimelineProperties(SystemMediaTransportControlsTimelineProperties)	Обновления свойства SystemMediaTransportControls временная шкала значениями в предоставленном объекте.

События

AutoRepeatModeChangeRequested	Происходит при изменении пользователем режима автоматического повтора SystemMediaTransportControls .
ButtonPressed	Происходит при нажатии кнопки в SystemMediaTransportControls.
PlaybackPositionChangeRequested	Происходит, когда пользователь изменяет позицию воспроизведения SystemMediaTransportControls.
PlaybackRateChangeRequested	Происходит, когда пользователь изменяет скорость воспроизведения SystemMediaTransportControls .
PropertyChanged	Происходит при изменении свойства в SystemMediaTransportControls .
ShuffleEnabledChangeRequested	Происходит, когда пользователь изменяет состояние перетасовки SystemMediaTransportControls .

См. также раздел

• Интеграция с SystemMediaTransportControls
• Ручное управление системными элементами управления воспроизведением мультимедиа
• Пример системных элементов управления транспортировкой мультимедиа