グループ通話フロー
ここでは、LINE Planetのグループ通話（カンファレンス）のフローについて説明します。
下図では、アプリクライアントとアプリサーバーはアプリケーション側に属しており、PlanetKitとLINE Planet CloudはLINE Planet側に属しています。
グループ通話参加
グループ通話に参加するには、アプリクライアントがjoinConference()を呼び出す必要があります。ユーザーがグループ通話に参加すると、onConnectedイベントが発生します。
グループ通話に参加するには、ルームIDが必要です。したがって、アプリクライアントはグループ通話に参加する前にアプリケーション通信チャンネルを通じてルームIDを共有する必要があります。
下図はグループ通話に参加する流れを示します。ここではClient 01がグループ音声通話に参加した後、Client Kが通話に参加します。
- Client 01が通話に参加しようとすると、Client 01のアプリクライアントが
joinConference()を呼び出します。 - Planet CloudはGroup Call Eventコールバックを呼び出して、アプリサーバーに新しいグループ通話を通知します。
- Client 01のアプリクライアントで
onConnectedイベントが発生します。 - Client Kが通話に参加しようとすると、Client Kのアプリクライアントが
joinConference()を呼び出します。 - Planet CloudはGroup Call Eventコールバックを呼び出し、アプリサーバーにグループ通話のステータス変更を通知します。
- Client 01のアプリクライアントで
onPeerListUpdatedイベントが発生し、Client KのアプリクライアントでonConnectedおよびonPeerListUpdatedイベントが発生します。
ピアリストの更新イベント
onPeerListUpdatedイベントは、参加者リストが更新されるたびに、つまり誰かがルームに参加または退出した後に発生します。そのため、Client Kが参加すると、Client 01とClient Kの両方ともこのイベントを受け取ります。このイベントは、新しく参加または退出した参加者のリストを渡します。
新しい参加者に対してonPeerListUpdatedイベントが発生すると、他の参加者はその参加者に対してPlanetKitPeerControlインスタンスを作成し、そのPlanetKitPeerControlインスタンスを使用して参加者のステータス変更に基づいて参加者のUIを更新するなどの作業を行うことができます。
イベントの更新間隔
アプリクライアントは、更新間隔内の最新情報に基づきonPeerListUpdatedイベントを受け取ります。その結果として、アプリクライアントは、誰かが参加直後に退出する場合など、更新間隔内で発生した急な変更に対するイベントを受信できない場合があります。
LINE Planet Cloudはこれらを内部で更新するスケジューラーを持ち、スケジューリング間隔は現在の参加者数が増えた分だけ長くなります。つまり、参加者数に比例して情報の更新が遅くなることにご注意ください。
グループ通話退出
グループ通話から退出するには、アプリクライアントがleaveConference()を呼び出す必要があります。グループ通話から退出したユーザーのアプリクライアントでは、onDisconnectedイベントが発生します。参加者リストが変更されたため、ピアのアプリクライアントではonPeerListUpdatedイベントが発生します。
下図は、グループ通話から退出する流れを示します。
- Client Kが通話から退出しようとすると、Client Kのアプリクライアントが
leaveConference()を呼び出します。 - Client Kのアプリクライアントで
onDisconnectedイベントが発生し、Client 01のアプリクライアントでonPeerListUpdatedイベントが発生します。 - Planet CloudはGroup Call Eventコールバックを呼び出し、アプリサーバーにグループ通話のステータス変更を通知します。
関連API
グループ通話に関連するAPIは次のとおりです。