1対1通話のイベントコールバック
1対1通話のイベントコールバックは、1対1通話が終了した際に呼び出されます。アプリケーションは、通話イベントを利用して以下の作業を行うことができます。
- 通話ログを残す
- 通話状態を確認する（例：通話が正常に終わったか）
- 統計データを収集する
メソッドとURI
- メソッド：GET
- URI:
{on_call_evt_cb_url}
クエリパラメーター
| パラメーター | データ型 | Null許容 | 説明 | 例 |
|---|---|---|---|---|
sid | String | N | セッションID（UUIDの形式）。これを利用して通話を識別できます。Nullなしで36バイトの固定長です。 | 6364e8b3-bdac-436e-9631-0bce2498ce0c |
from_service_id | String | N | 発信者のサービスID | caller-service-id |
from_user_id | String | N | 発信者のユーザーID | caller-user-id |
to_service_id | String | N | 受信者のサービスID | callee-service-id |
to_user_id | String | N | 受信者のユーザーID | callee-user-id |
type | String | N | メディアタイプ。A：音声通話、V：ビデオ通話 | A |
stid | String | Y | Deprecated. PlanetKitの makeCall()を呼び出したときに渡されるアプリケーションデータ | アプリケーションが作成 |
setup_time | Long | N | 通話が作成された時刻（秒） | 0 |
start_time | Long | N | 通話が開始された時刻（秒） | 0 |
end_time | Long | N | 通話が終了した時刻（秒） | 0 |
duration | Integer | N | 通話継続時間（秒）。end_time - start_time。通話に失敗すると0になります。 | 30 |
srcip | String | N | 発信者のIPアドレス | 1.2.3.4 |
dstip | String | N | 受信者のIPアドレス | 1.2.3.3 |
terminate | Integer | N | Q.850原因コード（cause code）。durationが0より大きい場合、この値は16(Normal)になります。通話解除の理由を参照してください。 | 16 |
rel_code | Integer | N | 通話の詳細解除コード。プラットフォーム内で通話解除の原因を調べるのに使用します。通話解除の理由を参照してください。 | 2 |
rel_code_str | String | N | 通話の詳細解除メッセージ。プラットフォーム内で通話解除の原因を調べるのに使用します。通話解除の理由を参照してください。 | CANCEL |
user_rel_code | String | Y | アプリケーションが定義した通話解除コード。通話解除の理由を参照してください。 | |
billing_sec | Integer | N | ユーザーに課金される通話時間（秒単位、ミリ秒以下は切り上げ処理） 注：通話の接続状態によって、課金される通話時間は通話継続時間（ duration）より少ない場合があります。 | 25 |
rc_idc | String | N | 発信者を処理したIDC（インターネットデータセンター）。ISO 3166-1 alpha-2 codeフォーマットを使用します。すべてアルファベット大文字です。 | KR |
disconnect_reason | Integer | N | 通話切断の理由。詳しくは、通話切断の理由を参照してください。 | 1001 |
releaser_type | Integer | N | 切断元のタイプ。詳しくは、切断元を参照してください。 | 1 |
app_svr_data | String | Y | PlanetKitのmakeCall()を呼び出したときに渡されるアプリケーションデータ詳しくは、クライアントプラットフォームごとのアプリサーバーデータガイドを参照してください。 - Android - iOS/macOS - Windows - Web 注：このパラメーターは stidと同じデータを提供します。 | アプリケーションが作成 |
サンプル
# Let's suppose on_call_evt_cb_url is
# http://sample.server.com:20200/call_event
# LINE Planet server will send a request to on_call_evt_cb_url as follows.
GET http://sample.server.com:20200/call_event?
sid=6364e8b3-bdac-436e-9631-0bce2498ce0c&
type=V&
from_user_id=9286&
from_service_id=caller-service-id&
to_user_id=2809&
to_service_id=callee-service-id&
setup_time=1582527400&
start_time=1582527404&
end_time=1582527434&
duration=30&
terminate=16&
srcip=1.2.3.4&
dstip=1.2.3.5&
stid=voip.next&
rel_code=1&
rel_code_str=NORMAL&
billing_sec=25&
rc_idc=KR&
disconnect_reason=1001&
releaser_type=1&
app_svr_data=appSvrData