MediaPlayer.EventHandler (MediaPlayerEventHandler)

extension MediaPlayer {
    public typealias EventHandler = MediaPlayerEventHandler
}

enum MediaPlayerEventHandler

이벤트 핸들러의 종류와 사용 방법에 대한 설명입니다. 각각 케이스에 대한 설명은 케이스를, 사용 방법은 addEventHandler(_)를 참고하시면 됩니다. 이벤트 핸들러를 추가한 후, 해당 이벤트 핸들러가 더 이상 필요 없을 때는 반드시 removeEventHandler(_) 메서드를 사용해서 제거하세요.
이벤트 핸들러를 대신하여 사용 방법에 따라서 이벤트 리스너를 사용하여 이벤트 처리를 할 수 있습니다. 이벤트 리스너에서 사용되는 파라미터는 이벤트 핸들러의 파라미터와 동일합니다. 이벤트 리스너의 사용 방법은 addEventListener(_)와 메서드를 참고하시면 됩니다.

케이스

durationChange

case durationChange((_ duration: Duration) -> Void)

미디어의 길이(duration)가 변경되었을 때를 처리하기 위한 핸들러입니다.

ended

case ended(() -> Void)

재생 목록의 마지막 미디어의 재생이 완료된 시점에 사용하기 위한 핸들러입니다.

error

case error((_ error: Error) -> Void)

에러가 발생할 때 사용하기 위한 핸들러입니다.

loadedData

case loadedData(() -> Void)

미디어 아이템이 로드되었을 때 사용하기 위한 핸들러입니다.

loadStart

case loadStart(() -> Void)

미디어 리소스를 로딩하기 시작할 때 사용하기 위한 핸들러입니다.

mediaItemTransition

case mediaItemTransition((_ item: MediaItem?) -> Void)

미디어 아이템이 교체 되는 시점에 사용하기 위한 핸들러입니다.

pause

case pause(() -> Void)

미디어가 일시 정지 상태로 진입하는 시점에 사용하기 위한 핸들러입니다.

pictureInPictureActiveChange

case pictureInPictureActiveChange((_ active: Bool) -> Void)

화면 속 화면 모드가 켜지거나 꺼지는 시점에 사용하기 위한 핸들러입니다.

pictureInPicturePossibleChange

case pictureInPicturePossibleChange((_ possible: Bool) -> Void)

화면 속 화면 모드를 사용할 수 있을 때, (혹은 반대의 경우에) 사용하기 위한 핸들러입니다. 예를 들면, 화면 속 화면 모드 버튼을 활성화 및 비활성화 하기 위해서는 이 핸들러가 필요합니다.

pictureInPictureDidStart

case pictureInPictureDidStart(() -> Void)

화면 속 화면 모드가 시작한 후 사용하기 위한 핸들러입니다.
화면 속 화면 모드로 들어가면, pictureInPictureWillStart → pictureInPictureActiveChange(true) → pictureInPictureDidStart의 순서대로 호출됩니다.

pictureInPictureDidStop

case pictureInPictureDidStop(() -> Void)

화면 속 화면 모드가 끝나고 난 후 사용하기 위한 핸들러입니다.
화면 속 화면 모드가 종료되면, pictureInPictureWillStop → pictureInPictureActiveChange(false) → pictureInPictureDidStop의 순서대로 호출됩니다.

pictureInPictureWillStart

case pictureInPictureWillStart(() -> Void)

화면 속 화면 모드가 시작하기 직전에 사용하기 위한 핸들러입니다.
화면 속 화면 모드로 들어가면, pictureInPictureWillStart → pictureInPictureActiveChange(true) → pictureInPictureDidStart의 순서대로 호출됩니다.

pictureInPictureWillStop

case pictureInPictureWillStop(() -> Void)

화면 속 화면 모드가 끝나기 직전애 사용하기 위한 핸들러입니다.
화면 속 화면 모드가 종료되면, pictureInPictureWillStop → pictureInPictureActiveChange(false) → pictureInPictureDidStop의 순서대로 호출됩니다.

play

case play(() -> Void)

미디어가 일시 정지 상태에서 재생 상태로 변경되는 시점에 사용하기 위한 핸들러입니다. 사용자가 재생 버튼을 클릭하거나 mediaPlayer.play()를 호출하는 등 플레이어에 재생 명령을 내렸을 때 등과 같이 명령을 했을 때 상황에서 이벤트 처리를 여기서 할 수 있습니다. play와 관련된 이벤트 핸들러가 호출된 이후에 playing 이벤트 핸들러는 언제나 호출됩니다. 재생 중에 미디어를 이동하든지 재생 위치를 이동하면, 언제나 pause -> play -> playing 순서로 호출됩니다.

playbackFinish

case playbackFinish(
    (_ mediaItem: MediaItem, _ position: Duration, _ duration: Duration?, _ reason: PlaybackFinishReason) -> Void
)

미디어가 종료될 때 사용하기 위한 핸들러입니다. 이 때 마지막 재생 위치(position)와 미디어의 길이(duration) 값을 사용할 수 있습니다. 주의할 점은, 미디어가 로드된 후에 종료될 때만 사용할 수 있다는 것입니다. 만약 미디어가 로드되기 전에 종료되는 상황에도 사용하려면, Unload를 참고하세요.

playbackStateChange

case playbackStateChange((_ state: MediaPlayer.PlaybackState) -> Void)

미디어 로딩 상태에 따른 처리, 즉, 버퍼링인지 준비가 된 상태인지, 끝이 났는지, 플레이어를 종료하였는지 등의 상황에 따라 처리하기 위한 핸들러입니다. 상황에 따른 설명은 playbackState를 참고하세요.

playing

case playing(() -> Void)

미디어가 재생 상태로 변한 직후에 사용하기 위한 핸들러입니다. playing과 관련된 이벤트 핸들러는 play 이벤트 이후에 항상 호출됩니다.

positionDiscontinuity

case positionDiscontinuity(
    (_ oldPosition: Duration, _ newPosition: Duration) -> Void
)

재생 위치가 변경되는 시점에 사용하기 위한 핸들러입니다. 이전 위치와 이동한 위치 모두 접근이 가능합니다.

progress

case progress(() -> Void)

플레이어가 리소스를 읽을 때 사용하기 위한 핸들러입니다.

rateChange

case rateChange((_ rate: Float) -> Void)

재생 속도가 변경되는 시점에 사용하기 위한 핸들러입니다.

repeatModeChange

case repeatModeChange((_ mode: MediaPlayer.RepeatMode) -> Void)

반복 모드가 설정되었을 때 처리하기 위한 핸들러입니다.

repeatRangeChange

case repeatRangeChange((_ range: MediaPlayer.RepeatRange?) -> Void)

구간 반복 모드가 시작되거나 종료되었을 때, 그리고 구간 반복의 시작 위치 또는 종료 위치가 바뀌었을 때를 처리하기 위한 핸들러입니다.

scalingModeChange

case scalingModeChange((_ mode: MediaPlayer.ScalingMode) -> Void)

미디어 화면의 스케일링 상태가 변하는 시점에 사용하기 위한 핸들러입니다.

seeked

case seeked(() -> Void)

seek 작업이 완료된 시점, 또는 재생 위치가 변경되는 시점, 또는 seeking 값이 false로 변경되는 시점에 사용하기 위한 핸들러입니다.

seeking

case seeking(() -> Void)

seek 작업이 시작되는 시점, 또는 seeking 값이 false에서 true로 변경되는 시점에 사용하기 위한 핸들러입니다.

textCueChange

case textCueChange((_ textCues: [TextTrack.Cue]) -> Void)

자막 큐가 변경되는 시점에 사용하기 위한 핸들러입니다.

timeUpdate

case timeUpdate((_ position: Duration) -> Void)

currentTime이 변경되는 시점에 사용하기 위한 핸들러입니다. 즉, 미디어가 재생이 되는 동안 수행하려는 작업을 이곳에 구현하시면 됩니다.

unload

case unload((_ mediaItem: MediaItem) -> Void)
)

미디어가 제거된 시점, 즉, 미디어 주소가 변경되기 직전, 기존에 존재하던 미디어를 비울 때를 처리하기 위한 핸들러입니다.

videoSizeChange

case videoSizeChange((_ size: CGSize) -> Void)

미디어 아이템의 비디오 크기가 달라지는 시점에 사용하기 위한 핸들러입니다. 아이템을 교체하는 순간에는 (0.0, 0.0)의 값으로 바뀌는 것도 체크를 하니 참고하시기 바랍니다.

volumeChange

case volumeChange((_ volume: Float, _ muted: Bool) -> Void)

볼륨이 변경되는 시점에 사용하기 위한 핸들러입니다. 무음(muted) 상태가 변경될 때도 호출됩니다.

waiting

case waiting(() -> Void)

일시적인 버퍼 부족, 즉 데이터가 충분히 로딩되지 못하거나 데이터가 없어서 재생이 정지된 시점에 사용하기 위한 핸들러입니다. playbackState가 .buffering이 될 때 호출됩니다.