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 대신 이 컨트롤을 사용하여 시스템 전송 컨트롤과 상호 작용해야 합니다. 시스템 전송 컨트롤을 사용하면 미디어 애플리케이션 개발자가 기본 제공 시스템 UI와 통합되어 아티스트, 앨범 제목 또는 장 제목과 같은 미디어 메타데이터를 표시할 수 있습니다. 또한 시스템 전송 컨트롤을 사용하면 재생 일시 중지 및 재생 목록에서 앞뒤로 건너뛰는 등의 기본 제공 시스템 UI를 사용하여 미디어 앱의 재생을 제어할 수 있습니다.

Windows 10 버전 1607부터 MediaPlayer 클래스 또는 AudioGraph 클래스를 사용하여 미디어를 재생하는 UWP 앱은 기본적으로 SMTC와 자동으로 통합됩니다. MediaPlayer의 새 인스턴스를 인스턴스화하고 MediaSource, MediaPlaybackItem 또는 MediaPlaybackList를 플레이어의 Source 속성에 할당하기만 하면 사용자가 SMTC에서 앱 이름을 보고 SMTC 컨트롤을 사용하여 재생, 일시 중지 및 재생 목록을 이동할 수 있습니다. MediaPlayer 개체의 SystemMediaTransportControls 속성에 액세스하여 SMTC의 instance 가져옵니다. 앱에서 SMTC를 사용하는 방법에 대한 지침은 SystemMediaTransportControls와 통합을 참조하세요.

일부 시나리오에서는 SMTC와의 자동 통합을 사용하지 않도록 설정할 수 있습니다. 이 경우 IsEnabled 속성을 false로 설정하여 MediaPlayer 개체의 CommandManager를 사용하지 않도록 설정해야 합니다. GetForCurrentView를 호출하여 현재 보기에 대한 SystemMediaTransportControls의 instance 가져옵니다. 또한 이전 버전의 Windows를 대상으로 하는 경우 이러한 방식으로 instance 가져와야 합니다. 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와 통합
• 시스템 미디어 전송 컨트롤의 수동 컨트롤
• 시스템 미디어 전송 컨트롤 샘플