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