Disconnect reasons
For both 1-to-1 calls and group calls, LINE Planet provides a reason for call disconnection, which is called a disconnect reason. The disconnect reason values are commonly defined for client and server.
When a call is disconnected, a disconnect reason is delivered with a disconnect source, so you can use the information to determine the cause and source of call disconnection.
The SDK versions that support disconnect reason values commonly defined for the client and server are as follows:
- Android, iOS/macOS, Windows: PlanetKit 5.1 or higher
- Web: WebPlanetKit 5.2 or higher
Related API
You can get the information from DisconnectedParam delivered by the evtDisconnected callback for 1-to-1 calls or group calls.
DisconnectedParam consists of the following properties.
| Property | Type | Description |
|---|---|---|
source | DISCONNECT_SOURCE | Disconnect source. For more information, see Disconnect sources. |
reason | DisconnectReason | Disconnect reason object |
DisconnectReason consists of the following properties.
| Property | Type | Description |
|---|---|---|
code | KIT_DISCONNECT_REASON | Code of the disconnect reason. For more information, see Disconnect reasons. |
codeString | string | Name of the disconnect reason |
Disconnect sources
The following types of disconnect sources are available in the DISCONNECT_SOURCE enum.
| Enum constant | Value | Description |
|---|---|---|
CALLEE | callee | A callee in a 1-to-1 call |
CALLER | caller | A caller in a 1-to-1 call |
PARTICIPANT | participant | A participant in a group call |
CLOUD_SERVER | cloud_server | LINE Planet Cloud server |
APP_SERVER | app_server | Application server |
Disconnect reasons
The KIT_DISCONNECT_REASON enum provides two types of disconnect reasons: disconnect reasons that are common to both WebPlanetKit and native PlanetKit, and disconnect reasons that are exclusive to WebPlanetKit.
Disconnect reasons common to WebPlanetKit and native PlanetKit
The following disconnect reasons are common to both WebPlanetKit and native PlanetKit. For more information on each reason, refer to the links below:
| Enum constant | Disconnect reason |
|---|---|
NORMAL | NORMAL |
DECLINE | DECLINE |
CELL_CALL | CELL_CALL |
INTERNAL_ERROR | INTERNAL_ERROR |
USER_ERROR | USER_ERROR |
INTERNAL_KIT_ERROR | INTERNAL_KIT_ERROR |
AUDIO_TX_NO_SRC | AUDIO_TX_NO_SRC |
CANCEL | CANCEL |
BUSY | BUSY |
NOANSWER | NOANSWER |
ALREADY_GOT_A_CALL | ALREADY_GOT_A_CALL |
MULTIDEV_IN_USE | MULTIDEV_IN_USE |
MULTIDEV_ANSWER | MULTIDEV_ANSWER |
MULTIDEV_DECLINE | MULTIDEV_DECLINE |
MAX_CALL_TIME_EXCEEDED | MAX_CALL_TIME_EXCEEDED |
NETWORK_UNSTABLE | NETWORK_UNSTABLE |
PUSH_ERROR | PUSH_ERROR |
AUTH_ERROR | AUTH_ERROR |
RELEASED_CALL | RELEASED_CALL |
SERVER_INTERNAL_ERROR | SERVER_INTERNAL_ERROR |
UNAVAILABLE_NETWORK | UNAVAILABLE_NETWORK |
APP_DESTROY | APP_DESTROY |
SYSTEM_SLEEP | SYSTEM_SLEEP |
SYSTEM_LOGOFF | SYSTEM_LOGOFF |
MTU_EXCEEDED | MTU_EXCEEDED |
ROOM_IS_FULL | ROOM_IS_FULL |
ALONE_KICK_OUT | ALONE_KICK_OUT |
ROOM_NOT_FOUND | ROOM_NOT_FOUND |
SERVICE_ACCESS_TOKEN_ERROR | SERVICE_ACCESS_TOKEN_ERROR |
SERVICE_INVALID_ID | SERVICE_INVALID_ID |
SERVICE_MAINTENANCE | SERVICE_MAINTENANCE |
SERVICE_BUSY | SERVICE_BUSY |
SERVICE_INTERNAL_ERROR | SERVICE_INTERNAL_ERROR |
SERVICE_HTTP_ERROR | SERVICE_HTTP_ERROR |
SERVICE_HTTP_CONNECTION_TIME_OUT | SERVICE_HTTP_CONNECTION_TIME_OUT |
SERVICE_INCOMPATIBLE_PLANETKIT_VER | SERVICE_INCOMPATIBLE_PLANETKIT_VER |
SERVICE_TOO_MANY_REQUESTS | SERVICE_TOO_MANY_REQUESTS |
Disconnect reasons exclusive to WebPlanetKit
The following disconnect reasons are available only in WebPlanetKit.
| Enum constant | Value | Call type | Disconnect source | Description |
|---|---|---|---|---|
WEB_RTC_ABORT | 1601 | Both | CALLER, PARTICIPANT | Although the user and operating system both granted access to the hardware device, some problem occurred which prevented the device from being used. |
WEB_RTC_NOT_ALLOWED | 1602 | Both | CALLER, PARTICIPANT | A browser is not permitted access to the device. |
WEB_RTC_NOT_FOUND | 1603 | Both | CALLER, PARTICIPANT | No media tracks of the specified type that satisfy the given constraints were found. |
WEB_RTC_NOT_READABLE | 1604 | Both | CALLER, PARTICIPANT | Although the user granted permission to use the matching devices, a hardware error occurred which prevented access to the device. |
WEB_RTC_OVERCONSTRAINED | 1605 | Both | CALLER, PARTICIPANT | The specified constraints resulted in no candidate devices which met the criteria requested. |
WEB_RTC_SECURITY_ERROR | 1606 | Both | CALLER, PARTICIPANT | User media support is disabled on the Document on which getUserMedia() was called. |
WEB_RTC_TYPE_ERROR | 1607 | Both | CALLER, PARTICIPANT | Disconnected by wrong constraints of getUserMedia(). |
WEB_NO_MEDIA_PACKET | 1608 | Both | CLOUD_SERVER | The server disconnected a call because the server did not receive any media packet during conference. |
WEB_CALL_CONNECT_FAIL_BY_SERVER | 1609 | Both | CALLER, PARTICIPANT | Failed to connect to LINE Web Planet server because of server failure. |
WEB_CALL_CONNECT_FAIL_BY_CLIENT | 1610 | Both | CALLER, PARTICIPANT | Failed to connect to LINE Web Planet server because of client's timeout. |
WEB_SIGNALING_UNEXPECTED_DISCONNECTED | 1611 | Both | CALLER, PARTICIPANT | Connection to the LINE Web Planet server is unexpectedly disconnected or WebSocket of client has problem. |