SystemMediaTransportControlsDisplayUpdater 클래스

정의

네임스페이스:

Windows.Media

SystemMediaTransportControls에 표시되는 음악 정보를 업데이트하는 기능을 제공합니다.

public ref class SystemMediaTransportControlsDisplayUpdater 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.Both)]
class SystemMediaTransportControlsDisplayUpdater 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.Both)]
public sealed class SystemMediaTransportControlsDisplayUpdater

Public NotInheritable Class SystemMediaTransportControlsDisplayUpdater

상속

Object Platform::Object IInspectable SystemMediaTransportControlsDisplayUpdater

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

Windows 10 버전 1607부터 MediaPlayer 클래스를 사용하여 미디어를 재생하는 UWP 앱은 기본적으로 SMTC와 자동으로 통합됩니다. 자동 통합을 사용하면 MediaPlaybackItem 클래스를 사용하여 미디어 항목의 제목과 같은 미디어 메타데이터를 업데이트합니다. GetDisplayProperties를 호출하여 MediaItemDisplayProperties 클래스의 instance 가져옵니다. 개체를 SMTC의 항목에 대해 표시할 값으로 업데이트한 다음 ApplyDisplayProperties 를 호출하여 변경 내용을 커밋합니다. 앱에서 SMTC를 사용하는 방법에 대한 지침은 SystemMediaTransportControls와 통합을 참조하세요.

수동 SMTC 통합을 사용하지 않도록 설정하거나 이전 버전의 Windows를 대상으로 하는 경우 SystemMediaTransportControls.DisplayUpdater 를 사용하여 미디어 메타데이터를 업데이트해야 합니다. SMTC를 수동으로 제어하는 방법에 대한 방법 지침은 시스템 미디어 전송 컨트롤의 수동 제어를 참조하세요.

속성

AppMediaId	앱의 미디어 ID를 가져오거나 설정합니다.
ImageProperties	현재 재생 중인 미디어와 연결된 이미지 속성을 가져옵니다.
MusicProperties	현재 재생 중인 미디어와 연결된 음악 속성을 가져옵니다.
Thumbnail	현재 재생 중인 미디어와 연결된 미리 보기 이미지를 가져오거나 설정합니다.
Type	미디어 형식을 가져오거나 설정합니다.
VideoProperties	현재 재생 중인 미디어와 연결된 비디오 속성을 가져옵니다.

메서드

ClearAll()	모든 미디어 메타데이터를 지웁니다.
CopyFromFileAsync(MediaPlaybackType, StorageFile)	지정된 파일을 사용하여 미디어 속성을 초기화합니다.
Update()	현재 재생 중인 미디어의 메타데이터를 업데이트.

추가 정보

• SystemMediaTransportControls와 통합
• 시스템 미디어 전송 컨트롤의 수동 컨트롤