Version: 6.0

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.

Note

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

For 1-to-1 calls, you can get the information from SCallDisconnectedParam delivered by the OnDisconnected callback. For group calls, you can get the information from SConferenceDisconnectedParam delivered by the OnDisconnected callback.

// For 1-to-1 calls
virtual void OnDisconnected(PlanetKitCallPtr pPlanetKitCall, const SCallDisconnectedParam* pParam) = 0;

// For group calls
virtual void OnDisconnected(PlanetKitConferencePtr pPlanetKitConference, const SConferenceDisconnectedParam* pParam) = 0;

The SCallDisconnectedParam struct consists of the following members.

typedef struct SCallDisconnectedParam
{
    // Disconnect reason
    EDisconnectReason           eReason;
    // Disconnect source
    EDisconnectSource           eDisconnectSource;
    // Whether the disconnection was made by a remote user or not
    bool                        bByRemote;
    // User-defined release code
    String                      strUserRelCode;
} SCallDisconnectedParam;

The SConferenceDisconnectedParam struct consists of the following members.

typedef struct SConferenceDisconnectedParam
{
    // Disconnect reason
    EDisconnectReason           eEndReason;
    // Disconnect source
    EDisconnectSource           eDisconnectSource;
    // Whether the disconnection was made by a remote user or not
    bool                        bByRemote;
    // User-defined release code
    String                      strUserRelCode;
} SConferenceDisconnectedParam;

Disconnect sources

The following types of disconnect sources are available in the EDisconnectSource enum.

Enum constant	Value	Description
`PLNK_DISCONNECT_SOURCE_CALLEE`	1	A callee in a 1-to-1 call
`PLNK_DISCONNECT_SOURCE_CALLER`	2	A caller in a 1-to-1 call
`PLNK_DISCONNECT_SOURCE_PARTICIPANT`	3	A participant in a group call
`PLNK_DISCONNECT_SOURCE_CLOUD_SERVER`	4	LINE Planet Cloud server
`PLNK_DISCONNECT_SOURCE_APP_SERVER`	5	Application server