오류 코드

네트워크 함수 대부분은 성공과 실패 콜백을 모두 다 이용합니다. 실패 콜백은 함수 실패의 사유를 결정하는 데 유용한 정보를 리턴합니다.

실패 콜백에는 오류 코드와 Strix Strix Error Category 이넘이 포함되어 있습니다. 아래 목록에 각 코드에 대한 설명이 나와 있습니다.

EStrixErrorCategory::StrixNet

네트워킹 오류

오류 코드	이름	설명
0	STRIX_NET_ERROR_SUCCESS	일반적 성공
1	STRIX_NET_ERROR_FAILURE	일반적 실패
1000	STRIX_NET_ERROR_CHANNEL_RESOLVE_ADDRESS_FAILED	채널 연결 중 네트워크 주소를 해결하지 못함
1001	STRIX_NET_ERROR_CHANNEL_CONNECT_FAILED	채널에 연결하지 못함
1002	STRIX_NET_ERROR_CHANNEL_SERVER_LISTEN_FAILED	서버 소켓이 연결을 듣지 못함
1003	STRIX_NET_ERROR_CHANNEL_SERVER_ACCEPT_FAILED	서버 소켓이 연결 시도를 수신하지 못함
1004	STRIX_NET_ERROR_CHANNEL_CONNECTION_CLOSED	채널 연결 차단
1005	STRIX_NET_ERROR_CHANNEL_CONNECTION_TIMEOUT	채널 연결 시간 초과
1006	STRIX_NET_ERROR_CHANNEL_RECEIVE_ERROR	채널에서 데이터 수신할 때 오류
1007	STRIX_NET_ERROR_CHANNEL_SEND_ERROR	채널에서 데이터 보낼 때 오류
1008	STRIX_NET_ERROR_CHANNEL_INSUFFICIENT_BUFFER	채널 버퍼가 수신 데이터에 비해 크지 않을 때 오류
1009	STRIX_NET_ERROR_CHANNEL_BAD_FORMAT	수신 데이터의 형식이 불량일 때 오류
1100	STRIX_NET_ERROR_SSL_ERROR	SSL 오류
1101	STRIX_NET_ERROR_SSL_HANDSHAKE_TIMEOUT	SSL 핸드쉐이크 시간 초과
1200	STRIX_NET_ERROR_LICENSE_VERIFICATION_FAILED	Strix 라이센스를 확인하지 못함

EStrixErrorCategory::StrixClient

클라이언트 로직 오류

기본 오류

오류 코드	이름	설명
0	UnknownError	알 수 없는 오류 발생
1	InternalError	내부 오류 발생
2	PermissionDenied	시도한 동작에 대해 권한 거부
3	LockFailed	리소스 잠금 실패
4	LockTimeout	리소스에 대해 잠금 시도 중 시간 초과
5	InstantiationFailed	Strix 인스턴스화를 하지 못함
6	NoSuchProperty	평가 중인 속성이 존재하지 않음
7	InvalidPropertySetting	유효하지 않은 속성 설정
8	IncorrectMessageType	바르지 않은 메시지 형식 수신
9	RequestTimeout	요청이 시간 초과됨
10	ModelNotFound	요청받은 모델을 찾지 못함

인증 오류

오류 코드	이름	설명
1000	DuplicateConnectionForSameUid	고유 식별자가 같은 연결에 연결 시도 중
1001	CouldNotCalculateHash	SHA 해시를 계산하지 못함
1002	InvalidCredentialsType	잘못된 허가 크리덴셜 형식
1003	InvalidCredentialsValue	유효하지 않은 허가 크리덴셜
1004	WrongCredentials	허가 크리덴셜이 허가 받은 크리덴셜과 맞지 않음
1005	DuplicateUid	중복 UID 사용 시도
1006	UnsupportedLibraryVersion	지원하지 않은 라이브러리 버전 사용 중
1007	InvalidApplicationIdToken	유효하지 않은 애플리케이션 ID 토큰 사용
1008	ApplicationIdRequired	연결 시 애플리케이션 ID 필요
1009	UserNotFound	요청받은 사용자를 찾지 못함
1010	InvalidDigest	유효하지 않은 해시
1011	InvalidNonce	유효하지 않은 논스
1012	NonceExpired	만료된 논스
1013	NonceGenerationFailed	논스값 생성 실패
1014	RegisterFailed	클라이언트 등록 실패
1015	TokenAuthorizationRequired	토큰 허가 필요
1016	AuthorizationNotEnabled	활성화되지 않았을 때 인증 시도

세션 오류

오류 코드	이름	설명
2000	InvalidSessionToken	유효하지 않은 세션 토큰
2001	SessionNotFound	세션을 찾지 못함

메신저 오류

오류 코드	이름	설명
3000	SendingToSelfUidNotAllowed	자신에게 보내기 시도

노드 오류

오류 코드	이름	설명
4000	NoNodesAvailable	연결할 노드 없음
4001	NodeAlreadyExists	이미 존재하는 노드를 만들려고 시도

방 오류

오류 코드	이름	설명
5000	MessageLimitReached	해당 방에 초당 메시지가 너무 많음
5001	NotRoomMember	이 방에 없는 방 멤버에 대해 작동하려고 시도
5002	NotRoomOwner	이 멤버는 방장이 아님
5003	RoomFullOfMembers	방이 가득 참
5004	RoomNotFound	방을 찾지 못함
5005	RoomMemberNotFound	방 멤버를 찾지 못함
5006	NotAllowedForOtherRoomMember	다른 방 멤버에게는 할 수 없는 동작
5007	AlreadyInRoom	연결 중일 때 방에 연결 시도
5008	WrongRoomPassword	이 방에는 맞지 않는 비밀번호
5009	RoomNotJoinable	입장할 수 없는 방에 입장 시도
5010	NoRoomsAvailable	이용 가능한 방 없음
5011	MaxRoomCountReached	이 서버에는 방을 더 이상 만들 수 없음

레플리카 오류

오류 코드	이름	설명
6000	NotReplicaOwner	레플리카의 주인이 아니면 실행할 수 없는 동작
6001	NotRoomMember	방 멤버가 아니면 할 수 없는 동작
6002	NotRoomOwner	방장이 아니면 할 수 없는 동작
6003	WrongPropertyMapFormat	이 레플리카의 속성 맵 형식 오류

EStrixErrorCategory::StrixUESDK

SDK 관련 오류

오류 코드	이름	설명
1	MasterServerAlreadyConnected	이미 연결된 상태에서 마스터에 연결 시도
2	MasterServerNotConnected	서버가 연결되지 않았을 때 마스터 서버 작동 시도
101	RoomServerAlreadyConnected	이미 연결된 상태에서 방 서버에 연결 시도
102	RoomServerNotConnected	서버가 연결되지 않았을 때 방 서버 작동 시도
201	RoomContextAlreadyExists	이미 연결된 상태에서 방에 연결 시도
202	RoomContextDoesNotExist	방 컨텍스트 없이 방 작동 시도

EStrixErrorCategory::External

Strix 밖에서 일어난 오류