다음을 통해 공유


MediaPlaybackItem 클래스

정의

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

public ref class MediaPlaybackItem sealed
/// [Windows.Foundation.Metadata.Activatable(Windows.Media.Playback.IMediaPlaybackItemFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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 MediaPlaybackItem final
/// [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")]
class MediaPlaybackItem final
/// [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.Activatable(typeof(Windows.Media.Playback.IMediaPlaybackItemFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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 MediaPlaybackItem
[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")]
public sealed class MediaPlaybackItem
[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)
function MediaPlaybackItem(source, startTime, durationLimit)
Public NotInheritable Class MediaPlaybackItem
상속
Object Platform::Object IInspectable MediaPlaybackItem
특성
구현

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의 비디오 트랙 목록이 변경될 때 발생합니다.

적용 대상

추가 정보