本文にスキップする
Version: 1.0

ネットワーク使用不可イベント

ネットワーク使用不可イベント(network unavailable event)は、ネットワークが使用できないとき、通知の役割を担います。

LINE Planetは、ネットワーク使用不可イベントが発生した後しばらくの間、通話の再接続を試みます。再接続に失敗すると、通話が切断されます。再接続に成功すると、LINE Planetはネットワーク復旧イベントを発生させ、通話を続行します。

これらのイベントを使用して、アプリケーションで現在の通話のネットワーク状態を示すメッセージを表示できます。

対応する通話タイプSDKの最低バージョン
1対1通話、グループ通話(カンファレンス)0.7

1対1通話

1対1通話では、PlanetKitCallEventHandlerの以下2つのコールバックが、それぞれネットワーク使用不可イベントとネットワーク再接続イベントに使用されます。

ネットワーク使用不可イベントのコールバック

onNetworkUnavailableコールバックは、ネットワークに問題があるときに呼び出されます。このコールバックには以下のパラメーターが含まれます。

パラメーター説明
isPeerピアに問題が発生したかどうか。次の値のいずれかです。
- true:ピアネットワークに問題があります。
- false:ローカルユーザーのネットワークに問題があります。
willDisconnect再接続に失敗した場合の通話切断までの時間(秒単位)。再接続に失敗すると、この時間が経過した後に通話切断の理由UNAVAILABLE_NETWORKと共に通話が切断されます。

ネットワーク復旧イベントのコールバック

ネットワークが復旧すると、onNetworkReavailableコールバックが呼び出されます。このコールバックには以下のパラメーターが含まれます。

パラメーター説明
isPeerピアに問題が発生したかどうか。次の値のいずれかです。
- true:ピアのネットワークに問題がある
- false:ローカルユーザーのネットワークに問題がある

グループ通話

グループ通話では、PlanetKitConferenceEventHandlerの以下2つのコールバックが、それぞれネットワーク使用不可イベントとネットワーク再接続イベントに使用されます。

ネットワーク使用不可イベントのコールバック

onNetworkUnavailableコールバックは、ローカルユーザーのネットワークに問題があるときに呼び出されます。このコールバックには以下のパラメーターが含まれます。

パラメーター説明
willDisconnect再接続に失敗したときの通話終了までの時間(秒単位)。再接続に失敗すると、設定時間が経過後に通話切断の理由UNAVAILABLE_NETWORKと共に通話が切断されます。

ネットワーク復旧イベントのコールバック

ローカルユーザーのネットワークが復旧すると、onNetworkReavailableコールバックが呼び出されます。