시작하기

주의
  • Backend-4.5.0 이상 버전부터 일부 이벤트 핸들러가 리턴되는 조건이 변경되었습니다.
  • 일반/길드 채팅의 4.5.0 이상 이벤트 핸들러 문서를 참고해주세요.
  • Backend-4.5.0 이상 버전의 채팅서버와 Backend-4.4.1 이하 버전의 채팅서버는 분리되어 있습니다.
         각 채팅서버는 서로 유저 목록을 공유하지 않고, 메시지를 주고받을 수 없습니다.
  • 뒤끝챗

    뒤끝베이스와 별개로 뒤끝챗만 사용할 수 없습니다.

    뒤끝챗 활성화

    뒤끝챗 기능은 뒤끝 콘솔에서 활성화 시킨 경우에만 사용가능합니다.
    게임 클라이언트에서는 Backend.Chat.GetChatStatus 메소드를 통해서 채팅 활성화 여부를 확인할 수 있습니다.

    유저 닉네임 설정

    • 닉네임이 없는 유저는 채팅을 사용할 수 없습니다.
    • 닉네임 중복을 허용하지 않는 것을 권장하며, 닉네임 중복 사용 시 발생하는 상황은 뒤끝챗에서 다음과 같은 문제점이 발생할 수 있습니다.
      • 채팅 로그 분석이 어려울 수 있음
      • 귓속말이 다수의 유저에게 전송될 수 있음

    ErrorInfo

    ValueTypeDescription
    CategoryErrorCodeErrorCode 카테고리
    DetailErrorCodeErrorCode 상세내용
    SocketErrorCodeSocketErrorSocket 클래스에 대한 오류 코드
    Reasonstring성공/실패 사유

    ErrorCode (enum)

    Value Description
    Success 요청 성공
    Exception 내부 알 수 없는 예외 발생 에러 코드
    SocketOpertatonError 소켓 작업이 실패 했을 경우 발생
    AuthenticationFailed 채팅 서버에서 인증이 실패 했을 경우 발생
    BrokenStream 소켓 관련 송/수신 스트림에 문제가 생겼을 경우 발생
    NetworkTimeout 채팅서버와 비정상적인 이유로 연결이 끊어진 후 재접속에 실패한 경우 발생
    DisconnectFromLocal 어떠한 이유로 SDK가 채팅서버와 연결을 끊었을 경우 발생
    DisconnectFromRemote 어떠한 이유로 채팅 서버가 연결을 끊었을 경우 발생
    InvalidMessage 잘못된 메시지 송/수신 시 발생
    InvalidOperation 잘못된 요청 시 발생
    InvalidSession 채팅서버에서 식별 불가능한 이유로 유효하지 않은 세션 에러
    ChannelTimeOut 일정시간동안 채팅을 하지 않았을 경우 발생
    BannedChat 일정시간동안 N회의 채팅 메시지를 전송할 경우 발생 & 어드민이 아닌 유저가 GlobalChat을 사용하는 경우 발생
    DuplicateConnection 중복 로그인 시 발생
    NetworkOffline 채팅서버와 비정상적인 이유로 연결이 일시적으로 끊어지면 발생 (자기자신 / 다른유저 모두 포함)
    NetworkOnline NetworkOffline 이후 채팅서버와 연결이 회복되면 발생 (자기자신 / 다른유저 모두 포함)

    SessionInfo

    ValueTypeDescription
    NickNamestring해당 세션 유저의 닉네임
    IsRemoteboolremote 여부 (나의 세션인 경우 false, 타인의 세션인 경우 true)