통화 종료 이유
LINE Planet에서는 1대1 통화와 그룹 통화에 대해 통화 종료의 이유를 제공하며, 이를 통화 종료 이유(disconnect reason)라고 합니다. 통화 종료 이유의 값은 클라이언트와 서버에 대해 공통으로 정의됩니다.
통화가 종료되면 통화 종료 이유가 통화 종료 소스(disconnect source, 서버 측에서는 releaser_type에 해당)와 함께 전달되므로 앱 클라이언트 또는 앱 서버에서 이 정보를 사용하여 통화 종료의 원인과 시작점을 확인할 수 있습니다.
앱 클라이언트는 통화 종료 이벤트 콜백에서 이 정보를 얻을 수 있고, 앱 서버는 1대1 통화 이벤트 콜백 또는 그룹 통화 이벤트 콜백에서 이 정보를 얻을 수 있습니다.
Note
통화 종료 소스
다음과 같은 유형의 통화 종료 소스가 있습니다.
| 유형 | 값 | 설명 |
|---|---|---|
| Callee | 1 | 1대1 통화 착신자 |
| Caller | 2 | 1대1 통화 발신자 |
| Participant | 3 | 그룹 통화 참여자 |
| CloudServer | 4 | LINE Planet Cloud 서버 |
| AppServer | 5 | 애플리케이션 서버 |
통화 종료 이유
LINE Planet에서 제공하는 통화 종료 이유에 대해 설명합니다. 표에서 각 열의 의미는 다음과 같습니다.
- 이름: 통화 종료 이유의 이름
- 값: 통화 종료 이유의 값
- 통화 유형: 해당하는 통화 유형입니다. 1대1 통화, 그룹 통화, 또는 둘 다가 될 수 있습니다.
- 통화 종료 소스: 가능한 통화 종료 소스입니다. 실제 통화 종료 소스는 나열된 항목 중 하나가 될 수 있습니다. 자세한 내용은 통화 종료 소스를 참고하세요.
- 설명: 통화 종료 이유에 대한 설명
일반적인 이유
오류가 아닌 상황을 나타내는 통화 종료 이유입니다.
| 이름 | 값 | 통화 유형 | 통화 종료 소스 | 설명 |
|---|---|---|---|---|
| NORMAL | 1001 | 둘 다 | Caller, Callee, Participant | 오류 없이 통화가 종료되었습니다. |
| DECLINE | 1002 | 둘 다 | Callee, CloudServer | - 1대1 통화: 응답자가 통화를 거절했습니다. - 그룹 통화: 이전에 참여한 그룹 통화와 동일한 그룹 통화방에 들어가면서 통화가 거부되었습니다(예: 크래시 발생 후 다시 참여). |
| CELL_CALL | 1003 | 둘 다 | Caller, Callee, Participant | Planet 통화 중에 모바일 통화를 수신했습니다. |
| CANCEL | 1201 | 1대1 통화 | Caller | 응답자가 응답하기 전에 발신자(initiator)가 통화를 종료했습니다. |
| BUSY | 1202 | 1대1 통화 | Callee | 응답자가 통화 중입니다. |
| NOANSWER | 1203 | 1대1 통화 | Caller | 응답자가 응답하지 않습니다. 발신자는 60초 동안 응답을 기다립니다. |
| ALREADY_GOT_A_CALL | 1204 | 둘 다 | CloudServer | 발신자 또는 참여자에게 이미 수신 통화가 있지만 아직 푸시를 받지 못했습니다. |
| MULTIDEV_IN_USE | 1205 | 둘 다 | CloudServer | 동일한 ID 쌍(user-id 및 service-id)을 사용하는 사용자가 다른 장치에서 통화하고 있습니다. |
| MULTIDEV_ANSWER | 1206 | 1대1 통화 | CloudServer | 동일한 ID 쌍(user-id 및 service-id)을 사용하는 응답자가 다른 장치에서 전화에 응답했습니다. |
| MULTIDEV_DECLINE | 1207 | 1대1 통화 | CloudServer | 동일한 ID 쌍(user-id 및 service-id)을 사용하는 응답자가 다른 장치에서 통화를 거절했습니다. |
| MAX_CALL_TIME_EXCEEDED | 1208 | 둘 다 | CloudServer | 최대 통화 시간에 도달했습니다. |
1대1 통화 또는 그룹 통화의 오류 이유
1대1 통화 또는 그룹 통화의 오류 상황을 나타내는 통화 종료 이유입니다.
| 이름 | 값 | 통화 유형 | 통화 종료 소스 | 설명 |
|---|---|---|---|---|
| INTERNAL_ERROR | 1109 | 둘 다 | Caller, Callee, Participant, CloudServer | 내부 오류로 통화가 종료되었습니다. |
| USER_ERROR | 1110 | 둘 다 | Caller, Callee, AppServer | 애플리케이션 정의 오류입니다. user_rel_code가 함께 전달됩니다.- 1대1 통화: 통화 피어가 user_rel_code를 정의합니다.- 그룹 통화: 앱 서버가 user_rel_code를 정의합니다. 예시는 참여자 추방을 참조하세요. |
| INTERNAL_KIT_ERROR | 1111 | 둘 다 | Caller, Callee, Participant | OS 관련 오류로 통화가 종료되었습니다. |
| AUDIO_TX_NO_SRC | 1112 | 둘 다 | Caller, Callee, Participant | 오디오 소스(예: 마이크)에서 한동안 오디오 데이터를 전송하지 않았습니다. |
| NETWORK_UNSTABLE | 1301 | 둘 다 | Caller, Callee, Participant, CloudServer | 통화를 유지하기 위한 네트워크 사용이 불가합니다. |
| PUSH_ERROR | 1302 | 1대1 통화 | CloudServer | LINE Planet Gateway에서 Notify 콜백 호출에 실패했거나 Notify 콜백이 실패를 반환했습니다. 앱 서버 또는 Notify 콜백의 URL을 확인하십시오. |
| AUTH_ERROR | 1303 | 둘 다 | CloudServer | 인증이 실패했습니다. |
| RELEASED_CALL | 1304 | 둘 다 | CloudServer | 통화가 이미 종료되었습니다. 예를 들어, 발신자가 이미 통화를 취소한 경우일 수 있습니다. |
| SERVER_INTERNAL_ERROR | 1305 | 둘 다 | CloudServer | 서버에서 내부 오류로 통화를 종료했습니다. |
| UNAVAILABLE_NETWORK | 1308 | 둘 다 | Caller, Callee, Participant | 일정 시간 동안 네트워크를 사용할 수 없어 통화가 종료되었습니다. |
| APP_DESTROY | 1309 | 둘 다 | Caller, Callee, Participant | 애플리케이션 프로세스가 종료되었습니다. 플랫폼별 상세 설명은 다음과 같습니다.
|
| SYSTEM_SLEEP | 1310 | 둘 다 | Caller, Callee, Participant | 애플리케이션이 절전(sleep) 모드에 있습니다. 플랫폼별 상세 설명은 다음과 같습니다.
|
| SYSTEM_LOGOFF | 1311 | 둘 다 | Caller, Callee, Participant | 애플리케이션이 로그오프 상태입니다. 플랫폼별 상세 설명은 다음과 같습니다.
|
| MTU_EXCEEDED | 1312 | 둘 다 | Caller, Callee, Participant | 최대 전송 단위(MTU)를 초과하여 통화가 연결되지 않았습니다. |
| APP_SERVER_DATA_ERROR | 1313 | 둘 다 | CloudServer | Planet Cloud 서버가 앱 서버 데이터를 앱 서버로 전달하지 못했습니다. |
| DESKTOP_SCREEN_LOCKED | 1314 | 둘 다 | Caller, Callee, Participant | 데스크톱 화면이 잠겼습니다. Note: 이 이유는 macOS와 Windows에만 적용됩니다. |
그룹 통화에만 해당되는 오류 이유
그룹 통화에만 해당하는 오류 상황을 나타내는 통화 종료 이유입니다.
| 이름 | 값 | 통화 유형 | 통화 종료 소스 | 설명 |
|---|---|---|---|---|
| ROOM_IS_FULL | 1401 | 그룹 통화 | CloudServer | 이 방의 참여자 수가 한도에 도달했습니다. |
| ALONE_KICK_OUT | 1402 | 그룹 통화 | CloudServer | 그룹 통화방에 사용자가 혼자 오래 있어 서버에서 추방되었습니다. |
| WRONG_ROOM_ATTR | 1403 | 그룹 통화 | CloudServer | PlanetKit 5.2부터 Deprecated 방 속성이 일치하지 않습니다. |
| ROOM_NOT_FOUND | 1404 | 그룹 통화 | CloudServer | 참여자가 참여 완료하기 전에 나머지 참여자가 모두 나갔기 때문에 방이 없어졌습니다. |
| ANOTHER_INSTANCE_TRY_TO_JOIN | 1405 | 그룹 통화 | Participant | 다른 인스턴스에서 방 참여를 시도하여 통화가 종료되었습니다. |
HTTP 연결 관련 오류 이유
HTTP 연결과 관련된 오류를 나타내는 통화 종료 이유입니다.
| 이름 | 값 | 통화 유형 | 통화 종료 소스 | 설명 |
|---|---|---|---|---|
| SERVICE_ACCESS_TOKEN_ERROR | 1501 | 둘 다 | CloudServer | 잘못된 액세스 토큰입니다. |
| SERVICE_INVALID_ID | 1502 | 둘 다 | CloudServer | service-id 또는 user-id에 허용되지 않는 문자가 사용되었습니다. |
| SERVICE_MAINTENANCE | 1503 | 둘 다 | CloudServer | 유지보수 중입니다. |
| SERVICE_BUSY | 1504 | 둘 다 | CloudServer | LINE Planet Gateway가 현재 사용 중입니다. |
| SERVICE_INTERNAL_ERROR | 1505 | 둘 다 | CloudServer | LINE Planet Gateway 내부 오류입니다. 방에 SUBGROUP 방 속성(PlanetKit 3.6 이상에서 생성)이 있기 때문에 이전 버전(3.6 미만)에서 참여에 실패했습니다. |
| SERVICE_HTTP_ERROR | 1506 | 둘 다 | Caller, Participant | HTTP 요청을 할 수 없습니다. 사용자의 네트워크 환경을 확인하세요. 1. 방화벽 설정 2. 클라이언트 백신 프로그램 |
| SERVICE_HTTP_CONNECTION_TIME_OUT | 1507 | 둘 다 | Caller, Participant | HTTP 요청을 할 수 없습니다. 사용자의 네트워크 환경을 확인하세요. 1. 방화벽 설정 2. 클라이언트 백신 프로그램 |
| SERVICE_HTTP_INVALID_PEER_CERT | 1508 | 둘 다 | Caller, Participant | SSL 피어 인증서 또는 SSH 원격 키가 유효하지 않습니다. |
| SERVICE_HTTP_CONNECT_FAIL | 1509 | 둘 다 | Caller, Participant | HTTP 요청을 할 수 없습니다. 사용자의 네트워크 환경을 확인하세요. 1. 방화벽 설정 2. 클라이언트 백신 프로그램 |
| SERVICE_HTTP_INVALID_URL | 1510 | 둘 다 | Caller, Participant | URL 형식이 잘못되었거나 호스트 또는 프록시 이름을 확인할 수 없습니다. |
| SERVICE_INCOMPATIBLE_PLANETKIT_VER | 1511 | 둘 다 | CloudServer | 현재 PlanetKit 버전은 더 이상 사용되지 않습니다. 업그레이드가 필요합니다. |
| SERVICE_TOO_MANY_REQUESTS | 1512 | 둘 다 | CloudServer | 짧은 시간 내에 너무 많은 통화 연결을 시도했습니다. |