네트워크 사용 불가 이벤트
네트워크 사용 불가 이벤트(network unavailable event)는 네트워크를 사용할 수 없을 때 알려주는 역할을 합니다.
LINE Planet은 네트워크 사용 불가 이벤트가 발생한 후 잠시 동안 통화 재연결을 시도합니다. 재연결 시도가 실패하면 통화 연결이 끊어집니다. 재연결 시도가 성공하면 LINE Planet은 네트워크 재가용 이벤트를 발생시키고 통화를 계속합니다.
이러한 이벤트를 사용하여 애플리케이션에서 현재 통화의 네트워크 상태를 나타내는 메시지를 표시할 수 있습니다.
| 지원되는 통화 유형 | 지원되는 버전 |
|---|---|
| 1대1 통화 | 모든 버전 |
| 그룹 통화(컨퍼런스) | PlanetKit 5.4 이상 |
1대1 통화
1대1 통화에서는 ICallEvent의 다음 두 가지 콜백이 각각 네트워크 사용 불가 이벤트와 네트워크 재가용 이벤트에 사용됩니다.
네트워크 사용 불가 이벤트 콜백
OnNetworkUnavailable 콜백은 네트워크에 문제가 있을 때 호출됩니다. 이 콜백에는 다음 파라미터가 포함됩니다.
| 파라미터 | 설명 |
|---|---|
bIsPeer | 피어에 문제가 발생했는지 여부. 다음 값 중 하나입니다. - true: 피어의 네트워크에 문제가 있습니다. - false: 로컬 사용자의 네트워크에 문제가 있습니다. |
nDisconnectAfterSec | 재연결에 실패했을 때 통화 종료까지의 시간(초 단위). 재연결에 실패하면 이 시간만큼 지난 후에 통화 종료 이유 UNAVAILABLE_NETWORK와 함께 통화 연결이 끊어집니다. |
네트워크 재가용 이벤트 콜백
네트워크가 복구되면 The OnNetworkReavailable 콜백이 호출됩니다. 이 콜백에는 다음 파라미터가 포함됩니다.
| 파라미터 | 설명 |
|---|---|
bIsPeer | 피어에 문제가 있었는지 여부. 다음 값 중 하나입니다. - true: 피어의 네트워크에 문제가 있었습니다. - false: 로컬 사용자의 네트워크에 문제가 있었습니다. |
그룹 통화
그룹 통화에서는 IConferenceEvent의 다음 두 가지 콜백이 각각 네트워크 사용 불가 이벤트와 네트워크 재가용 이벤트에 사용됩니다.
네트워크 사용 불가 이벤트 콜백
OnNetworkUnavailable 콜백은 로컬 사용자의 네트워크에 문제가 있을 때 호출됩니다. 이 콜백에는 다음 파라미터가 포함됩니다.
| 파라미터 | 설명 |
|---|---|
nWillDisconnectAfterSec | 재연결에 실패했을 때 통화 종료까지의 시간(초 단위). 재연결에 실패하면 이 시간만큼 지난 후에 통화 종료 이유 UNAVAILABLE_NETWORK와 함께 통화 연결이 끊어집니다. |
네트워크 재가용 이벤트 콜백
로컬 사용자의 네트워크가 복구되면 OnNetworkReavailable 콜백이 호출됩니다.