Version: 5.5

통화 종료 이유

LINE Planet에서는 1대1 통화와 그룹 통화에 대해 통화 종료의 이유를 제공하며, 이를 통화 종료 이유(disconnect reason)라고 합니다. 통화 종료 이유의 값은 클라이언트와 서버에 대해 공통으로 정의됩니다.

통화가 종료되면 통화 종료 이유가 통화 종료 소스와 함께 전달되므로 이 정보를 사용하여 통화 종료의 원인과 시작점을 확인할 수 있습니다.

Note

클라이언트와 서버에 공통으로 정의된 통화 종료 이유 값을 지원하는 SDK 버전은 다음과 같습니다.

Android, iOS/macOS, Windows: PlanetKit 5.1 이상
Web: WebPlanetKit 5.2 이상

관련 API

1대1 통화의 경우 OnDisconnected 콜백이 전달하는 SCallDisconnectedParam에서 정보를 얻을 수 있습니다. 그룹 통화의 경우 OnDisconnected 콜백이 전달하는 SConferenceDisconnectedParam에서 정보를 얻을 수 있습니다.

// 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;

SCallDisconnectedParam 구조체는 다음 멤버들로 구성됩니다.

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;

SConferenceDisconnectedParam 구조체는 다음 멤버들로 구성됩니다.

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;

통화 종료 소스

EDisconnectSource enum에는 다음과 같은 유형의 통화 종료 소스가 있습니다.

Enum 상수	값	설명
`PLNK_DISCONNECT_SOURCE_CALLEE`	1	1대1 통화 착신자
`PLNK_DISCONNECT_SOURCE_CALLER`	2	1대1 통화 발신자
`PLNK_DISCONNECT_SOURCE_PARTICIPANT`	3	그룹 통화 참여자
`PLNK_DISCONNECT_SOURCE_CLOUD_SERVER`	4	LINE Planet Cloud 서버
`PLNK_DISCONNECT_SOURCE_APP_SERVER`	5	애플리케이션 서버