통화 일시 중지
PlanetKit은 통화를 일시 중지(hold)하거나 재개(unhold)하는 기능을 제공합니다. 이 기능을 이용하면 애플리케이션이 미디어 스트림 전송과 수신을 일시 중지하거나 재개합니다. 사용자가 통화를 일시 중지하거나 재개하면 피어는 사용자의 비디오가 일시 중지되었거나 다시 재생되었음을 알리는 이벤트를 받습니다.
통화 일시 중지 및 재개 동작은 통화 유형에 따라 다릅니다. 이 페이지에서는 통화를 일시 중지하거나 재개하는 방법을 설명합니다.
| 지원 통화 유형 | 최소 SDK 버전 |
|---|---|
| 1대1 통화, 그룹 통화(컨퍼런스) | 0.7 |
1대1 통화
1대1 통화를 일시 중지하거나 재개하려면 PlanetKitCall의 hold() 또는 unhold()를 사용하세요.
hold()를 호출하여 애플리케이션의 미디어 스트림 전송 및 수신을 일시 중지한 후에, 피어는 통신을 재개하기 위해 unhold()가 호출될 때까지 기다려야 합니다. 피어 측 애플리케이션은 PlanetKit이 통화 파라미터에 설정된 일시 중지음(hold tone)을 재생하게 합니다.
다음 다이어그램은 1대1 통화의 일시 중지 및 재개 흐름을 보여줍니다.
관련 API
1대1 통화에서 통화 일시 중지 및 재개와 관련된 API는 다음과 같습니다.
| 메서드 | 설명 | 관련 이벤트 콜백 |
|---|---|---|
hold() | 일시 중지 상태를 시작합니다. 일시 중지 이유를 제공할 수 있습니다. | onPeerHold |
unhold() | 일시 중지 상태를 종료합니다. | onPeerUnhold |
그룹 통화
그룹 통화를 일시 중지하거나 재개하려면 PlanetKitConference의 hold() 또는 unhold()를 사용하세요.
그룹 통화에서는 일시 중지 동작이 1대1 통화와 다릅니다. 주요 차이점은 다음과 같습니다.
- 일시 중지음이라는 개념이 없습니다.
- 1대1 통화에서는 발신자(피어) 측에서 미디어 전송과 수신이 일시 중지되지만, 그룹 통화에서는 피어의 미디어 전송과 수신이 Planet Cloud에 의해 중지됩니다.
다음 다이어그램은 그룹 통화의 일시 중지 및 재개 흐름을 보여줍니다.
관련 API
그룹 통화에서 통화 일시 중지 및 재개와 관련된 API는 다음과 같습니다.
| 메서드 | 설명 | 관련 이벤트 콜백 |
|---|---|---|
hold() | 일시 중지 상태를 시작합니다. 일시 중지 이유를 제공할 수 있습니다. | onPeersHold |
unhold() | 일시 중지 상태를 종료합니다. | onPeersUnhold |