비디오 일시 중지 이벤트
피어가 자신의 비디오 스트림을 일시 중지하거나 다시 재생하면 이벤트가 발생합니다.
| 지원 통화 유형 | 최소 SDK 버전 |
|---|---|
| 1대1 통화, 그룹 통화(컨퍼런스) | PlanetKit 3.0 |
1대1 통화
1대1 통화에서는 피어의 비디오가 일시 중지되거나 다시 재생되면 다음과 같은 이벤트 콜백이 호출됩니다.
| 이벤트 콜백 | 설명 |
|---|---|
onPeerVideoPaused | 피어의 비디오가 일시 중지될 때 호출됩니다. |
onPeerVideoResumed | 피어의 비디오가 다시 재생될 때 호출됩니다. |
그룹 통화
그룹 통화에서는 한 명 이상의 피어의 비디오가 일시 중지되거나 다시 재생되면 다음과 같은 이벤트 콜백이 호출됩니다.
| 이벤트 콜백 | 설명 |
|---|---|
onPeersVideoUpdated | 한 명 이상의 피어의 비디오가 일시 중지되거나 다시 재생될 때 호출됩니다. - 피어의 비디오가 일시 중지되면 피어의 VideoState는 PAUSED입니다.- 피어의 비디오가 다시 재생되면 피어의 VideoState는 ENABLED입니다. |
비디오 일시 중지 이유
사용자의 지시 또는 카메라 사용 불가 등 여러 가지 이유로 비디오 스트림을 중지할 수 있습니다.
1대1 통화, 그룹 통화 모두 비디오 일시 중지 시 이벤트 콜백을 통해 비디오 일시 중지 이유를 전달합니다. PlanetKitVideoPauseReason enum은 다음과 같은 비디오 일시 중지 이유를 정의합니다.
| Enum 상수 | 설명 |
|---|---|
BY_USER | 피어가 pauseMyVideo()를 호출함 |
BY_INTERRUPT | 애플리케이션이 백그라운드 상태에 진입함 |
ENABLE_VIDEO_RESPONSE | (1대1 통화에서만 가능) 피어가 영상 통화를 활성화한 후 사용자의 비디오가 일시 중지 상태가 됨. 자세한 내용은 영상 통화 활성화를 참고하세요. |
CAMERA_INACTIVE | 카메라를 사용하지 못하게 됨 |
HOLD | 피어가 hold()를 호출함. 자세한 내용은 일시 중지를 참고하세요. |