ネットワーク使用不可イベント
ネットワーク使用不可イベント(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コールバックが呼び出されます。