Поделиться через


SystemMediaTransportControls Класс

Определение

Представляет объект, обеспечивающий интеграцию с системными элементами управления транспортировкой мультимедиа и поддержку команд мультимедиа.

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
Атрибуты

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

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

Комментарии

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

Элементы управления Transtport системного носителя

Начиная с 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 .

Применяется к

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