비디오 일시 중지 이벤트
피어가 자신의 비디오 스트림을 일시 중지하거나 다시 재생하면 이벤트가 발생합니다.
| 지원 통화 유형 | 최소 SDK 버전 |
|---|---|
| 1대1 통화, 그룹 통화(컨퍼런스) | WebPlanetKit 3.1 |
1대1 통화
1대1 통화에서는 피어의 비디오가 일시 중지되거나 다시 재생되면 다음과 같은 이벤트 콜백이 호출됩니다.
| 이벤트 콜백 | 설명 |
|---|---|
MakeCallDelegate의 evtPeerVideoPausedVerifyCallDelegate의 evtPeerVideoPaused | 피어의 비디오가 일시 중지될 때 호출됩니다. |
MakeCallDelegate의 evtPeerVideoResumedVerifyCallDelegate의 evtPeerVideoResumed | 피어의 비디오가 다시 재생될 때 호출됩니다. |
그룹 통화
그룹 통화에서는 한 명 이상의 피어의 비디오가 일시 중지되거나 다시 재생되면 다음과 같은 이벤트 콜백이 호출됩니다.
| 이벤트 콜백 | 설명 |
|---|---|
evtPeersVideoPaused | 한 명 이상의 피어의 비디오가 일시 중지될 때 호출됩니다. |
evtPeersVideoResumed | 한 명 이상의 피어의 비디오가 다시 재생될 때 호출됩니다. |
비디오 일시 중지 이유
사용자의 지시 또는 카메라 사용 불가 등 여러 가지 이유로 비디오 스트림을 중지할 수 있습니다.
1대1 통화, 그룹 통화 모두 비디오 일시 중지 시 이벤트 콜백을 통해 비디오 일시 중지 이유를 전달합니다. VIDEO_PAUSE_REASON enum은 다음과 같은 비디오 일시 중지 이유를 정의합니다.
| Enum 상수 | 설명 |
|---|---|
PLANETKIT_VIDEO_PAUSE_REASON_BY_USER | 피어가 pauseMyVideo()를 호출함 |
PLANETKIT_VIDEO_PAUSE_REASON_BY_INTERRUPT | 애플리케이션이 백그라운드 상태에 진입함 |
PLANETKIT_VIDEO_PAUSE_REASON_ENABLE_VIDEO_RESPONSE | (1대1 통화에서만 가능) 피어가 응답 유형을 PAUSE로 설정하고 사용자가 영상 통화 활성화를 요청함. 자세한 내용은 음성 통화 중 영상 통화 활성화를 참고하세요. |
PLANETKIT_VIDEO_PAUSE_REASON_CAMERA_INACTIVE | 카메라를 사용하지 못하게 됨 |
인터페이스 변경
비디오 일시 중지 이벤트와 관련된 API에서 다음과 같은 변경이 있었습니다.
| SDK 버전 | 1대1 통화 | 그룹 통화 |
|---|---|---|
| WebPlanetKit 5.0 이상 | evtPeerVideoPausedevtPeerVideoResumed | evtPeersVideoPausedevtPeersVideoResumed |
| WebPlanetKit 4.2 이하 | evtPeerUpdated | evtPeerUpdated |
Note
WebPlanetKit 5.1까지는 그룹 통화에서 사용자 자신의 비디오 일시 중지 상태를 다른 사람과 공유하는 것을 활성화하려면 ConferenceParams의 shareVideoPause 속성(기본값은 false)을 true로 설정해야 합니다. WebPlanetKit 5.2부터 shareVideoPause 속성이 제거되었습니다.