Version: 5.5

네트워크 사용 불가 이벤트

네트워크 사용 불가 이벤트(network unavailable event)는 네트워크를 사용할 수 없을 때 알려주는 역할을 합니다.

LINE Planet은 네트워크 사용 불가 이벤트가 발생한 후 잠시 동안 통화 재연결을 시도합니다. 재연결 시도가 실패하면 통화 연결이 끊어집니다. 재연결 시도가 성공하면 LINE Planet은 네트워크 재가용 이벤트를 발생시키고 통화를 계속합니다.

이러한 이벤트를 사용하여 애플리케이션에서 현재 통화의 네트워크 상태를 나타내는 메시지를 표시할 수 있습니다.

지원되는 통화 유형	지원되는 버전
1대1 통화	모든 버전
그룹 통화(컨퍼런스)	PlanetKit 5.4 이상

1대1 통화

1대1 통화에서는 PlanetKitCallDelegate의 다음 두 가지 콜백이 각각 네트워크 사용 불가 이벤트와 네트워크 재가용 이벤트에 사용됩니다.

networkDidUnavailable ^{iOS, macOS} 콜백은 네트워크에 문제가 있을 때 호출됩니다. 이 콜백에는 다음 파라미터가 포함됩니다.

파라미터	설명
`isPeer`	피어에 문제가 발생했는지 여부. 다음 값 중 하나입니다. - `true`: 피어의 네트워크에 문제가 있습니다. - `false`: 로컬 사용자의 네트워크에 문제가 있습니다.
`willDisconnected`	재연결에 실패했을 때 통화 종료까지의 시간(초 단위). 재연결에 실패하면 이 시간만큼 지난 후에 통화 종료 이유 `UNAVAILABLE_NETWORK`와 함께 통화 연결이 끊어집니다.

네트워크가 복구되면 The networkDidReavailable ^{iOS, macOS} 콜백이 호출됩니다. 이 콜백에는 다음 파라미터가 포함됩니다.

파라미터	설명
`isPeer`	피어에 문제가 있었는지 여부. 다음 값 중 하나입니다. - `true`: 피어의 네트워크에 문제가 있었습니다. - `false`: 로컬 사용자의 네트워크에 문제가 있었습니다.

그룹 통화에서는 PlanetKitConferenceDelegate의 다음 두 가지 콜백이 각각 네트워크 사용 불가 이벤트와 네트워크 재가용 이벤트에 사용됩니다.

networkDidUnavailable ^{iOS, macOS} 콜백은 로컬 사용자의 네트워크에 문제가 있을 때 호출됩니다. 이 콜백에는 다음 파라미터가 포함됩니다.

파라미터	설명
`willDisconnected`	재연결에 실패했을 때 통화 종료까지의 시간(초 단위). 재연결에 실패하면 이 시간만큼 지난 후에 통화 종료 이유 `UNAVAILABLE_NETWORK`와 함께 통화 연결이 끊어집니다.

로컬 사용자의 네트워크가 복구되면 networkDidReavailable ^{iOS, macOS} 콜백이 호출됩니다.