MediaPlaybackItem 클래스

정의

네임스페이스:

Windows.Media.Playback

재생할 수 있는 미디어 항목을 나타냅니다. 이 클래스는 미디어 원본에 포함된 오디오 트랙, 비디오 트랙 및 시간 제한 메타데이터 트랙을 노출하는 MediaSource 를 둘러싼 래퍼 역할을 합니다.

public ref class MediaPlaybackItem 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)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Media.Playback.IMediaPlaybackItemFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.Media.Playback.IMediaPlaybackItemFactory2, 196608, "Windows.Foundation.UniversalApiContract")]
class MediaPlaybackItem 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)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Media.Playback.IMediaPlaybackItemFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Media.Playback.IMediaPlaybackItemFactory2), 196608, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaPlaybackItem

function MediaPlaybackItem(source, startTime, durationLimit)

Public NotInheritable Class MediaPlaybackItem

상속

Object Platform::Object IInspectable MediaPlaybackItem

특성

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

구현

IMediaPlaybackSource

Windows 요구 사항

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

설명

MediaPlaybackItem은 MediaPlayer, MediaElement 또는 MediaPlayerElement와 같은 플레이어에게 직접 전달할 수 있습니다. 또는 MediaPlaybackList 클래스를 사용하여 플레이어에게 여러 미디어 재생 항목 목록을 전달할 수도 있습니다.

미디어 항목 작업에 대한 방법 지침은 미디어 항목, 재생 목록 및 트랙을 참조하세요.

버전 기록

Windows 버전	SDK 버전	추가된 값
1511	10586	FindFromMediaSource
1607	14393	MediaPlaybackItem(MediaSource,TimeSpan)
1607	14393	MediaPlaybackItem(MediaSource,TimeSpan,TimeSpan)
1607	14393	ApplyDisplayProperties
1607	14393	BreakSchedule
1607	14393	CanSkip
1607	14393	DurationLimit
1607	14393	GetDisplayProperties
1607	14393	StartTime
1703	15063	AutoLoadedDisplayProperties
1703	15063	IsDisabledInPlaybackList
1703	15063	TotalDownloadProgress

생성자

MediaPlaybackItem(MediaSource)	MediaPlaybackItem 클래스의 새 instance 초기화합니다.
MediaPlaybackItem(MediaSource, TimeSpan)	재생을 시작해야 하는 항목 내의 위치를 나타내는 StartTime 값을 사용하여 MediaPlaybackItem 클래스의 새 instance 초기화합니다.
MediaPlaybackItem(MediaSource, TimeSpan, TimeSpan)	재생을 시작해야 하는 항목 내의 위치를 나타내는 StartTime 값과 항목의 최대 재생 기간을 지정하는 DurationLimit 값을 사용하여 MediaPlaybackItem 클래스의 새 instance 초기화합니다.

속성

AudioTracks	MediaPlaybackItem과 연결된 MediaSource에서 오디오 트랙의 읽기 전용 목록을 가져옵니다.
AutoLoadedDisplayProperties	시스템에서 시스템 미디어 전송 컨트롤에 표시할 메타데이터를 자동으로 로드해야 하는 미디어 콘텐츠 유형(있는 경우)을 지정하는 값을 가져오거나 설정합니다.
BreakSchedule	MediaPlaybackItem에 대한 미디어 중단 일정을 정의하는 MediaBreakSchedule을 가져옵니다.
CanSkip	MediaPlaybackItem을 건너뛸 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.
DurationLimit	MediaPlaybackItem의 최대 재생 기간을 가져옵니다.
IsDisabledInPlaybackList	MediaPlaybackList에서 MediaPlaybackItem을 사용하지 않도록 설정할지 여부를 지정하는 값을 가져오거나 설정합니다.
Source	MediaPlaybackItem과 연결된 MediaSource 개체를 가져옵니다.
StartTime	재생이 시작될 MediaPlaybackItem 내의 위치를 가져옵니다.
TimedMetadataTracks	MediaPlaybackItem과 연결된 MediaSource에서 시간 제한 메타데이터 트랙의 읽기 전용 목록을 가져옵니다.
TotalDownloadProgress	현재 다운로드된 MediaPlaybackItem 에 대한 데이터의 비율을 나타내는 값을 가져옵니다.
VideoTracks	MediaPlaybackItem과 연결된 MediaSource에서 비디오 트랙의 읽기 전용 목록을 가져옵니다.

메서드

ApplyDisplayProperties(MediaItemDisplayProperties)	MediaPlaybackItem의 표시 속성을 업데이트. 이러한 속성은 시스템 미디어 전송 컨트롤에서 현재 재생 중인 미디어 항목에 대한 정보를 표시하는 데 사용됩니다.
FindFromMediaSource(MediaSource)	제공된 MediaSource와 연결된 MediaPlaybackItem을 검색합니다.
GetDisplayProperties()	MediaPlaybackItem의 표시 속성을 가져옵니다.

이벤트

AudioTracksChanged	MediaPlaybackItem과 연결된 MediaSource의 오디오 트랙 목록이 변경될 때 발생합니다.
TimedMetadataTracksChanged	MediaPlaybackItem과 연결된 MediaSource에서 시간이 지정된 메타데이터 목록이 변경될 때 발생합니다.
VideoTracksChanged	MediaPlaybackItem과 연결된 MediaSource의 비디오 트랙 목록이 변경될 때 발생합니다.

추가 정보

• IMediaPlaybackSource
• 미디어 항목, 재생 목록 및 트랙