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

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