다음을 통해 공유


MediaPlaybackSession 클래스

정의

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
특성

Windows 요구 사항

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

설명

MediaPlayerPlaybackSession 속성 또는 MediaBreakManagerPlaybackSession 속성에 액세스하여 이 클래스의 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

미디어 재생 세션에서 지원하는 재생 속도 집합이 변경되면 발생합니다.

적용 대상

추가 정보