본문으로 건너뛰기

그룹 통화 이벤트 콜백

그룹 통화(컨퍼런스) 이벤트 콜백은 참여자가 그룹 통화에 입장하거나 퇴장할 때 호출됩니다. 애플리케이션은 그룹 통화 이벤트를 이용해 다음과 같은 작업을 할 수 있습니다.

참여자들에게 방금 그룹 통화를 시작했음을 알림
통화 상태 확인 (예: 그룹 통화가 끝났는지 아닌지)
통계 데이터 수집

메서드와 URI

메서드: GET
URI: {on_gcall_evt_cb_url}

쿼리 파라미터

파라미터	데이터 유형	Null 허용	설명	예시
`sid`	String	N	세션 ID. 이를 이용해 통화를 식별할 수 있습니다. Null을 포함하지 않는 36 바이트 고정 크기입니다.	`6364e8b3bdac436e96310bce2498ce0c`
`svc_id`	String	N	그룹 통화 서비스 ID	`room-service-id`
`id`	String	N	그룹 통화 ID	`room-id`
`user_svc_id`	String	N	참여자의 서비스 ID	`user-service-id`
`user_id`	String	N	참여자의 사용자 ID	`user-id`
`host_svc_id`	String	N	호스트의 서비스 ID	`host-service-id`
`host_id`	String	N	호스트의 사용자 ID	`host-user-id`
`sc`	String	N	그룹 통화 상태 코드 - `S`: 시작됨 - `C`: 변경됨 - `E`: 종료됨	`S`
`setup_time`	Long	N	그룹 통화를 생성한 시각(초)	`0`
`start_time`	Long	N	그룹 통화를 시작한 시각(초)	`0`
`end_time`	Long	N	그룹 통화를 종료한 시각(초)	`0`
`online`	Integer	N	온라인 참여자(연결된 참여자) 수	`0`
`media_type`	String	N	미디어 유형. - `A`: 음성 그룹 통화 - `V`: 영상 그룹 통화	`A`
`msc`	String	N	참여자 상태 코드 - `C`: 연결됨 - `D`: 연결 해제됨 - `T`: 타임아웃 - `M`: 미디어가 변경됨	`C`
`stid`	String	Y	Deprecated. PlanetKit의 `joinConference()`를 호출했을 때 전달된 애플리케이션 데이터	애플리케이션이 생성
`ts`	Numeric	N	타임스탬프	`2277272`
`rel_code`	Integer	Y	통화의 상세 해제 코드. 플랫폼 내에서 통화 해제 사유를 추적하는 데 사용합니다. 통화 해제 이유를 참고하세요.	`1`
`rel_code_str`	String	Y	통화의 상세 해제 메시지. 플랫폼 내에서 통화 해제 사유를 추적하는 데 사용합니다. 통화 해제 이유를 참고하세요.	`NORMAL`
`ue_type`	String	N	사용자 단말 유형 - `UE_TYPE_UNDEFINED` - `ANDROID` - `IOS` - `DESKTOPMAC` - `DESKTOPWIN` - `BROWSER` - `SIP_TERMINAL`	`IOS`
`display_name`	String	Y	사용자 단말의 표시 이름	`iosApp`
`client_address`	String	Y	클라이언트의 IP 주소	`1.1.1.1`
`mtg_data`	String	Y	미팅 생성 시 지정한 미팅 데이터	`JP`
`rc_idc`	String	Y	그룹 통화 서버의 IDC를 나타냅니다. ISO 3166-1 alpha-2 code 포맷을 사용하며 모두 대문자입니다.	`JP`
`disconnect_reason`	Integer	Y	통화 종료 이유. 자세한 내용은 통화 종료 이유를 참고하세요.	`1001`
`releaser_type`	Integer	Y	통화 종료 소스의 유형. 자세한 내용은 통화 종료 소스를 참고하세요.	`1`
`app_svr_data`	String	Y	PlanetKit의 `joinConference()`를 호출했을 때 전달된 애플리케이션 데이터. 자세한 내용은 클라이언트 플랫폼별 앱 서버 데이터 가이드를 참조하세요. - Android - iOS - macOS - Windows - Web 참고: 이 파라미터는 `stid`와 동일한 데이터를 전달합니다.	애플리케이션이 생성

예제

# Let's suppose on_gcall_evt_cb_url is
# http://sample.server.com:20200/gcall_event
# LINE Planet server will send a request to on_gcall_evt_cb_url as follows.

GET http://sample.server.com:20200/gcall_event?
sid=59db2167e13911ea83a8213945545d1c&
svc_id=room-service-id&
id=1111&
user_svc_id=user-service-id&
user_id=9286&
host_svc_id=host-service-id&
host_id=2809&
sc=C&
setup_time=1597744702514&
start_time=1597744703058&
end_time=0&
online=2&
mediaType=V&
msc=C&
stid=application-data&
ts=1599463610820&
ue_type=IOS&
display_name=iosApp&
client_address=1.1.1.1&
mtg_data=JP&
rc_idc=JP&
app_svr_data=appSvrData

메서드와 URI
쿼리 파라미터
예제