비디오 일시 중지 이벤트

피어가 자신의 비디오 스트림을 일시 중지하거나 다시 재생하면 이벤트가 발생합니다.

지원 통화 유형	최소 SDK 버전
1대1 통화, 그룹 통화(컨퍼런스)	1대1 통화: 0.8 그룹 통화: 0.9

1대1 통화

1대1 통화에서는 피어의 비디오가 일시 중지되거나 다시 재생되면 다음과 같은 이벤트 콜백이 호출됩니다.

이벤트 콜백	설명
onPeerVideoPaused	피어의 비디오가 일시 중지될 때 호출됩니다.
onPeerVideoResumed	피어의 비디오가 다시 재생될 때 호출됩니다.

그룹 통화

그룹 통화에서는 피어의 비디오가 일시 중지되거나 다시 재생되면 다음과 같은 이벤트 콜백이 호출됩니다.

이벤트 콜백	설명
PlanetKitPeerControlHandler의 onVideoUpdate	피어의 비디오가 일시 중지되거나 다시 재생될 때 호출됩니다. - 피어의 비디오가 일시 중지되면 피어의 PlanetKitVideoState는 paused입니다. - 피어의 비디오가 다시 재생되면 피어의 PlanetKitVideoState는 enabled입니다.

비디오 일시 중지 이유

사용자의 지시 또는 카메라 사용 불가 등 여러 가지 이유로 비디오 스트림을 중지할 수 있습니다.

비디오 일시 중지 시 이벤트 콜백을 통해 비디오 일시 중지 이유를 전달합니다. PlanetKitVideoPauseReason enum은 다음과 같은 비디오 일시 중지 이유를 정의합니다.

Enum 상수	설명
user	피어가 pauseMyVideo()를 호출함
interrupt	애플리케이션이 백그라운드 상태에 진입함
enableVideoResponse	(1대1 통화에서만 가능) 피어가 응답 유형을 pause로 설정하고 사용자가 영상 통화 활성화를 요청함. 자세한 내용은 음성 통화 중 영상 통화 활성화를 참고하세요.
cameraInactive	카메라를 사용하지 못하게 됨
hold	피어가 hold()를 호출함. 자세한 내용은 일시 중지를 참고하세요.

관련 API

비디오 일시 중지 이벤트와 관련된 API는 다음과 같습니다.

Enum

• PlanetKitVideoPauseReason

1대1 통화

메서드

• PlanetKitCall의 pauseMyVideo()
• PlanetKitCall의 resumeMyVideo()
• PlanetKitCall의 hold()

이벤트

• onPeerVideoPaused
• onPeerVideoResumed

그룹 통화

메서드

• PlanetKitConference의 pauseMyVideo()
• PlanetKitConference의 resumeMyVideo()
• PlanetKitConference의 hold()

이벤트

• onVideoUpdate

관련 문서

• 음성 통화 중 영상 통화 활성화
• 통화 일시 중지