本文にスキップする
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;

切断元​

EDisconnectSourceenumには、次のタイプの切断元があります。

Enum定数値説明
PLNK_DISCONNECT_SOURCE_CALLEE11対1通話の受信者
PLNK_DISCONNECT_SOURCE_CALLER21対1通話の発信者
PLNK_DISCONNECT_SOURCE_PARTICIPANT3グループ通話の参加者
PLNK_DISCONNECT_SOURCE_CLOUD_SERVER4LINE Planet Cloudサーバー
PLNK_DISCONNECT_SOURCE_APP_SERVER5アプリケーションサーバー

切断理由​

EDisconnectReasonenumから提供する切断理由は、次のとおりです。それぞれの切断理由について詳細な情報を確認するには、以下のリンクを参照してください。

Enum定数切断理由
PLNK_DISCONNECT_REASON_NORMALNORMAL
PLNK_DISCONNECT_REASON_DECLINEDECLINE
PLNK_DISCONNECT_REASON_CELL_CALLCELL_CALL
PLNK_DISCONNECT_REASON_INTERNAL_ERRORINTERNAL_ERROR
PLNK_DISCONNECT_REASON_USER_ERRORUSER_ERROR
PLNK_DISCONNECT_REASON_INTERNAL_KIT_ERRORINTERNAL_KIT_ERROR
PLNK_DISCONNECT_REASON_AUDIO_TX_NO_SRCAUDIO_TX_NO_SRC
PLNK_DISCONNECT_REASON_CANCELCANCEL
PLNK_DISCONNECT_REASON_BUSYBUSY
PLNK_DISCONNECT_REASON_NO_ANSWERNOANSWER
PLNK_DISCONNECT_REASON_ALREADY_GOT_A_CALLALREADY_GOT_A_CALL
PLNK_DISCONNECT_REASON_MULTIDEV_IN_USEMULTIDEV_IN_USE
PLNK_DISCONNECT_REASON_MULTIDEV_ANSWERMULTIDEV_ANSWER
PLNK_DISCONNECT_REASON_MULTIDEV_DECLINEMULTIDEV_DECLINE
PLNK_DISCONNECT_REASON_MAX_CALL_TIME_EXCEEDEDMAX_CALL_TIME_EXCEEDED
PLNK_DISCONNECT_REASON_NETWORK_UNSTABLENETWORK_UNSTABLE
PLNK_DISCONNECT_REASON_PUSH_ERRORPUSH_ERROR
PLNK_DISCONNECT_REASON_AUTH_ERRORAUTH_ERROR
PLNK_DISCONNECT_REASON_RELEASED_CALLRELEASED_CALL
PLNK_DISCONNECT_REASON_SERVER_INTERNAL_ERRORSERVER_INTERNAL_ERROR
PLNK_DISCONNECT_REASON_UNAVAILABLE_NETWORKUNAVAILABLE_NETWORK
PLNK_DISCONNECT_REASON_APP_DESTROYAPP_DESTROY
PLNK_DISCONNECT_REASON_SYSTEM_SLEEPSYSTEM_SLEEP
PLNK_DISCONNECT_REASON_SYSTEM_LOGOFFSYSTEM_LOGOFF
PLNK_DISCONNECT_REASON_MTU_EXCEEDEDMTU_EXCEEDED
PLNK_DISCONNECT_REASON_APP_SERVER_DATA_ERRORAPP_SERVER_DATA_ERROR
PLNK_DISCONNECT_REASON_DESKTOP_SCREEN_LOCKEDDESKTOP_SCREEN_LOCKED
PLNK_DISCONNECT_REASON_ROOM_IS_FULLROOM_IS_FULL
PLNK_DISCONNECT_REASON_ALONE_KICK_OUTALONE_KICK_OUT
PLNK_DISCONNECT_REASON_WRONG_ROOM_ATTRWRONG_ROOM_ATTR
PLNK_DISCONNECT_REASON_REASON_ROOM_NOT_FOUNDROOM_NOT_FOUND
PLNK_DISCONNECT_REASON_ANOTHER_INSTANCE_TRY_TO_JOINANOTHER_INSTANCE_TRY_TO_JOIN
PLNK_DISCONNECT_REASON_SERVICE_ACCESS_TOKEN_ERRORSERVICE_ACCESS_TOKEN_ERROR
PLNK_DISCONNECT_REASON_SERVICE_INVALID_IDSERVICE_INVALID_ID
PLNK_DISCONNECT_REASON_SERVICE_MAINTENANCESERVICE_MAINTENANCE
PLNK_DISCONNECT_REASON_SERVICE_BUSYSERVICE_BUSY
PLNK_DISCONNECT_REASON_SERVICE_INTERNAL_ERRORSERVICE_INTERNAL_ERROR
PLNK_DISCONNECT_REASON_SERVICE_HTTP_ERRORSERVICE_HTTP_ERROR
PLNK_DISCONNECT_REASON_SERVICE_HTTP_CONNECTION_TIME_OUTSERVICE_HTTP_CONNECTION_TIME_OUT
PLNK_DISCONNECT_REASON_SERVICE_HTTP_INVALID_PEER_CERTSERVICE_HTTP_INVALID_PEER_CERT
PLNK_DISCONNECT_REASON_SERVICE_HTTP_CONNECT_FAILSERVICE_HTTP_CONNECT_FAIL
PLNK_DISCONNECT_REASON_SERVICE_HTTP_INVALID_URLSERVICE_HTTP_INVALID_URL
PLNK_DISCONNECT_REASON_SERVICE_INCOMPATIBLE_PLANETKIT_VERSERVICE_INCOMPATIBLE_PLANETKIT_VER
PLNK_DISCONNECT_REASON_SERVICE_TOO_MANY_REQUESTSSERVICE_TOO_MANY_REQUESTS