비디오 일시 중지 이벤트
피어가 자신의 비디오 스트림을 일시 중지하거나 다시 재생하면 이벤트가 발생합니다.
| 지원 통화 유형 | 최소 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 통화에서만 가능) 피어가 응답 유형을 PAUSE로 설정하고 사용자가 영상 통화 활성화를 요청함. 자세한 내용은 음성 통화 중 영상 통화 활성화를 참고하세요. |
CAMERA_INACTIVE | 카메라를 사용하지 못하게 됨 |
HOLD | 피어가 hold()를 호출함. 자세한 내용은 일시 중지를 참고하세요. |
인터페이스 변경
비디오 일시 중지 이벤트와 관련된 API에서 다음과 같은 변경이 있었습니다.
| SDK 버전 | 1대1 통화 | 그룹 통화 |
|---|---|---|
| PlanetKit 4.4 이상 | onPeerVideoPausedonPeerVideoResumed | onPeersVideoUpdated |
| PlanetKit 4.3 | evtPeerVideoPausedevtPeerVideoResumed | evtPeerVideoPausedevtPeerVideoResumed |
| PlanetKit 4.2 이하 | evtPeerUpdated | evtPeerUpdated |
Note
PlanetKit 4.3까지는 그룹 통화에서 사용자 자신의 비디오 일시 중지 상태를 다른 사람과 공유하는 것을 비활성화하려면 그룹 통화 파라미터의 shareVideoPause 속성(기본값은 true)을 false로 설정해야 합니다. PlanetKit 4.4부터 shareVideoPause 속성이 제거되었습니다.