MediaPlaybackSession 클래스

정의

네임스페이스:

Windows.Media.Playback

MediaPlayer의 현재 재생 세션 상태에 대한 정보를 제공하고 재생 세션 상태의 변경에 응답하기 위한 이벤트를 제공합니다.

public ref class MediaPlaybackSession sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class MediaPlaybackSession final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class MediaPlaybackSession

Public NotInheritable Class MediaPlaybackSession

상속

Object Platform::Object IInspectable MediaPlaybackSession

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

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

설명

MediaPlayer의 PlaybackSession 속성 또는 MediaBreakManager의 PlaybackSession 속성에 액세스하여 이 클래스의 instance 가져옵니다.

MediaPlayer 및 재생 세션 작업에 대한 방법 지침은 MediaPlayer를 사용하여 오디오 및 비디오 재생을 참조하세요.

버전 기록

Windows 버전	SDK 버전	추가된 값
1703	15063	BufferedRangesChanged
1703	15063	GetBufferedRanges
1703	15063	GetPlayedRanges
1703	15063	GetSeekableRanges
1703	15063	IsMirroring
1703	15063	IsSupportedPlaybackRateRange
1703	15063	PlayedRangesChanged
1703	15063	SeekableRangesChanged
1703	15063	SphericalVideoProjection
1703	15063	SupportedPlaybackRatesChanged
1803	17134	GetOutputDegradationPolicyState
1803	17134	PlaybackRotation

속성

BufferingProgress	MediaPlaybackSession의 현재 버퍼링 진행률을 나타내는 값을 가져옵니다.
CanPause	MediaPlayer.Pause 메서드가 호출될 경우 미디어를 일시 중지할 수 있는지 여부를 나타내는 값을 가져옵니다.
CanSeek	MediaPlayer.Position 속성의 값을 설정하여 미디어의 현재 재생 위치를 변경할 수 있는지 여부를 나타내는 값을 가져옵니다.
DownloadProgress	다운로드가 완료되고 콘텐츠가 버퍼링되는 현재 재생 위치 이후의 위치를 나타내는 값을 가져옵니다.
IsMirroring	미디어 재생 세션의 콘텐츠가 현재 가로로 미러링되고 있는지 여부를 나타내는 값을 가져오거나 설정합니다.
IsProtected	MediaPlaybackSession에서 현재 재생 중인 미디어가 DRM(디지털 권한 관리)으로 보호되는지 여부를 나타내는 값을 가져옵니다.
MediaPlayer	MediaPlaybackSession과 연결된 MediaPlayer를 가져옵니다.
NaturalDuration	정상 속도로 재생될 때 현재 재생 중인 미디어의 기간을 나타내는 값을 가져옵니다.
NaturalVideoHeight	현재 재생 중인 미디어 항목에서 비디오의 높이를 가져옵니다.
NaturalVideoWidth	현재 재생 중인 미디어 항목에서 비디오의 너비를 가져옵니다.
NormalizedSourceRect	MediaPlayer에서 렌더링하는 비디오 원본 내에서 정규화된 사각형을 가져오거나 설정합니다. 이렇게 하면 비디오 내에서 이동 및 확대/축소가 가능합니다.
PlaybackRate	MediaPlaybackSession의 현재 재생 속도를 나타내는 값을 가져오거나 설정합니다.
PlaybackRotation	재생 중에 비디오 콘텐츠에 적용된 회전을 지정하는 MediaRotation 열거형에서 값을 가져오거나 설정합니다.
PlaybackState	버퍼링 또는 재생과 같은 MediaPlaybackSession의 현재 재생 상태를 나타내는 값을 가져옵니다.
Position	현재 재생 중인 미디어 내에서 현재 재생 위치를 가져오거나 설정합니다.
SphericalVideoProjection	미디어 재생 세션에서 사용하는 구형 비디오 프로젝션 설정을 관리하는 개체를 가져옵니다.
StereoscopicVideoPackingMode	MediaPlaybackSession에 대한 입체 비디오 압축 모드를 지정하는 값을 가져오거나 설정합니다.

메서드

GetBufferedRanges()	데이터가 버퍼링되고 재생이 즉시 시작될 수 있는 시간 범위의 읽기 전용 목록을 검색합니다.
GetOutputDegradationPolicyState()	MediaPlaybackSession의 현재 출력 저하 정책 상태를 나타내는 개체를 가져옵니다.
GetPlayedRanges()	콘텐츠가 재생된 시간 범위의 읽기 전용 목록을 검색합니다.
GetSeekableRanges()	재생 스택 위치를 검색할 수 있는 시간 범위의 읽기 전용 목록을 검색합니다. 라이브 스트리밍의 경우 이러한 범위는 데이터를 계속 사용할 수 있는 시간 범위를 나타냅니다.
IsSupportedPlaybackRateRange(Double, Double)	지정된 재생 속도 범위가 지원되는지 여부를 나타내는 값을 가져옵니다.

이벤트

BufferedRangesChanged	데이터가 버퍼링되는 시간 범위 집합이 변경될 때 발생합니다.
BufferingEnded	MediaPlaybackSession에 대한 버퍼링이 끝날 때 발생합니다.
BufferingProgressChanged	MediaPlaybackSession에 대한 버퍼링 진행률이 변경되면 발생합니다.
BufferingStarted	MediaPlaybackSession에 대한 버퍼링이 시작될 때 발생합니다.
DownloadProgressChanged	MediaPlaybackSession의 다운로드 진행률이 변경되면 발생합니다.
NaturalDurationChanged	현재 재생 중인 미디어 항목의 기간이 변경되면 발생합니다.
NaturalVideoSizeChanged	현재 재생 중인 미디어 항목의 비디오 크기가 변경되면 발생합니다.
PlaybackRateChanged	MediaPlaybackSession에 대한 현재 재생 속도가 변경되면 발생합니다.
PlaybackStateChanged	현재 재생 상태가 변경되면 발생합니다.
PlayedRangesChanged	재생된 시간 범위 집합이 변경될 때 발생합니다.
PositionChanged	현재 재생 중인 미디어 내의 현재 재생 위치가 변경되면 발생합니다.
SeekableRangesChanged	변경하려는 시간 범위 집합이 변경될 때 발생합니다.
SeekCompleted	MediaPlaybackSession에 대한 검색 작업이 완료되면 발생합니다.
SupportedPlaybackRatesChanged	미디어 재생 세션에서 지원하는 재생 속도 집합이 변경되면 발생합니다.

추가 정보

• MediaPlayer를 사용하여 오디오 및 비디오 재생