JoinGameServer

public bool JoinGameServer(string serverAddress, string serverPort, bool isReconnect, out ErrorInfo errorInfo);

파라미터

ValueTypeDescription
serverAddressstring인게임 서버 주소 (OnMatchMakingResponse의 roomInfo에서 전달받은 서버 주소)
serverPortushort인게임 서버 포트 (OnMatchMakingResponse의 roomInfo에서 전달받은 서버 포트)
isReconnectbool재접속 여부 (false). 재접속을 수행하는 법은 재접속 문서를 참고해주세요.
errorInfoErrorInfo성공/실패 정보

인게임 서버 접속을 위한 서버주소, 포트에 대한 정보는 인게임 서버 접속을 위한 정보 문서를 확인해주세요.

설명

유저들 간 실시간 게임을 위한 인게임 서버에 접속을 시도합니다.

  • 인게임서버 접속 함수의 리턴이 true인 것은 서버 접속이 성공한 것이 아닌 단순히 서버와 소켓이 연결된 것 입니다.
  • 실제 서버 연결은 소켓 연결 후 유저 인증과정을 거친 후 완료됩니다.

    OnSessionJoinInServer 이벤트가 호출되었을 때 유저가 실제로 인게임서버에 접속한 것 입니다.

Example

string serverAddress;
ushort serverPort;

OnMatchMakingResponse += (args) => // serverAddress와 serverPort 확인하는 곳
{
    string serverAddress = args.RoomInfo.m_inGameServerEndPoint.m_address;
    ushort serverPort = args.RoomInfo.m_inGameServerEndPoint.m_port;
}

void JoinMatchMakingServer() // 임의의 함수
{
    bool isReconnect = true;
    ErrorInfo errorInfo;

    Backend.Match.JoinMatchMakingServer(serverAddress, serverPort, isReconnect, out errorInfo);
}

ReturnCase

Success cases
인게임서버와 소켓연결에 성공한 경우
true
errorInfo : ErrorInfo.Success

Error cases
인게임서버 접속에 실패한 경우
false
errorInfo.Category : ErrorCode.Exception
errorInfo.Reasion : "이유"

인게임서버와 소켓연결에 실패한 경우
false
errorInfo.Category : ErrorCode.SocketOperationError
errorInfo.SocketError : 발생한 소켓 에러 타입
errorInfo.Reason : "이유"


OnSessionJoinInServer

public JoinChannelEventHandler OnSessionJoinInServer;

전달인자

ValueTypeDescription
argsJoinChannelEventArgs인게임서버 접속 성공/실패 여부

JoinChannelEventArgs

ValueTypeDescription
ErrInfoErrorInfo에러 정보
SessionInfoSessionInfo접속 세션 정보

설명

인게임 서버에 접속했을 때 호출되는 이벤트입니다.
인게임 서버 접속 성공/실패 여부를 확인할 수 있습니다.

Example

Backend.Match.OnSessionJoinInServer += (args) => {
    // TODO
};

ArgumentCase

인게임 서버 접속에 성공한 경우
ErrInfo : ErrorInfo.Success

인게임 서버 접속에 실패한 경우
ErrInfo.Category : ErrorCode.Exception
ErrInfo.Reason : 접속 실패에 대한 이유

자기자신이 인게임 서버 재접속에 성공한 경우
ErrInfo.Category : ErrorCode.Success
ErrInfo.Detail : ErrorCode.NetworkOnline
ErrInfo.Reason : Reconnect Success