통화 일시 중지
PlanetKit은 통화를 일시 중지(hold)하거나 재개(unhold)하는 기능을 제공합니다. 이 기능을 이용하면 애플리케이션이 미디어 스트림 전송과 수신을 일시 중지하거나 재개합니다. 사용자가 통화를 일시 중지하거나 재개하면 피어는 사용자의 비디오가 일시 중지되었거나 다시 재생되었음을 알리는 이벤트를 받습니다.
통화 일시 중지 및 재개 동작은 통화 유형에 따라 다릅니다. 이 페이지에서는 통화를 일시 중지하거나 재개하는 방법을 설명합니다.
| 지원 통화 유형 | 최소 SDK 버전 |
|---|---|
| 1대1 통화, 그룹 통화(컨퍼런스) | PlanetKit 3.0 |
1대1 통화
1대1 통화를 일시 중지하거나 재개하려면 PlanetKitCall의 hold() 또는 unhold()를 사용하세요.
hold()를 호출하여 애플리케이션의 미디어 스트림 전송 및 수신을 일시 중지한 후에, 피어는 통신을 재개하기 위해 unhold()가 호출될 때까지 기다려야 합니다. 피어 측 애플리케이션은 PlanetKit이 통화 파라미터에 설정된 일시 중지음(hold tone)을 재생하게 합니다.
다음 다이어그램은 1대1 통화의 일시 중지 및 재개 흐름을 보여줍니다.
관련 API
1대1 통화에서 통화 일시 중지 및 재개와 관련된 API는 다음과 같습니다.
| 메서드 | 설명 | 관련 이벤트 콜백 |
|---|---|---|
hold() | 일시 중지 상태를 시작합니다. 일시 중지 이유를 제공할 수 있습니다. | onPeerHold |
unhold() | 일시 중지 상태를 종료합니다. | onPeerUnhold |
영상 통화 활성화 및 비활성화
통화 중 일시 중지를 요청한 단말(Client 01)에서는 영상 통화 활성화 및 비활성화를 요청할 수 없습니다.
하지만 상대방 단말(Client 02)에서는 enableVideo() 및 disableVideo() 메서드로 영상 통화 활성화 및 비활성화를 요청할 수 있습니다. 1대1 통화에서 영상 통화 활성화 및 비활성화는 항상 양쪽에서 동시에 진행됩니다. 그러므로 Client 02가 영상 통화 활성화 및 비활성화를 요청하면, Client 02뿐만 아니라 Client 01도 영상 통화 활성화 및 비활성화를 수행합니다. 그 이후 이전에 일시 중지 상태였던 Client 01 단말은 일시 중지 상태를 지속합니다.
그룹 통화
그룹 통화를 일시 중지하거나 재개하려면 PlanetKitConference의 hold() 또는 unhold()를 사용하세요.
그룹 통화에서는 일시 중지 동작이 1대1 통화와 다릅니다. 주요 차이점은 다음과 같습니다.
- 일시 중지음이라는 개념이 없습니다.
- 1대1 통화에서는 발신자(피어) 측에서 미디어 전송과 수신이 일시 중지되지만, 그룹 통화에서는 피어의 미디어 전송과 수신이 Planet Cloud에 의해 중지됩니다.
다음 다이어그램은 그룹 통화의 일시 중지 및 재개 흐름을 보여줍니다.
관련 API
그룹 통화에서 통화 일시 중지 및 재개와 관련된 API는 다음과 같습니다.
| 메서드 | 설명 | 관련 이벤트 콜백 |
|---|---|---|
hold() | 일시 중지 상태를 시작합니다. 일시 중지 이유를 제공할 수 있습니다. | onPeersOnHold |
unhold() | 일시 중지 상태를 종료합니다. | onPeersUnhold |
영상 통화 활성화 및 비활성화
통화 중 일시 중지를 요청한 단말(Client 01)에서는 영상 통화 활성화 및 비활성화를 요청할 수 없습니다.
화면 공유
화면 공유 중에 발표자(화면 공유를 하고 있는 사용자)의 클라이언트가 hold()를 호출하면 발표자와 피어들에게 다음과 같은 이벤트가 발생합니다.
- 발표자:
onMyScreenShareStoppedByHold - 1대1 통화 피어:
onPeerScreenShareStopped - 그룹 통화 피어: 상태가
DISABLED인onScreenShareUpdated
그룹 통화에서는 화면 공유의 대상에 따라 onScreenShareUpdated 이벤트를 받는 피어가 다음과 같이 달라집니다.
- 화면 공유가 기본 방(main room)을 대상으로 하는 경우 방에 있는 모든 피어가 이벤트를 받습니다.
- 화면 공유가 서브그룹을 대상으로 하는 경우 서브그룹에 가입한 피어만 이벤트를 받습니다.