로비 및 매치 메이킹 SDK 오류 처리
이 페이지는 PlayFab 로비 및 매치 메이킹 SDK에서 오류를 표시하는 방법과 이를 처리하는 방법에 대한 지침에 대한 빠른 참조를 제공하기 위한 것입니다.
다음 주제가 논의됩니다.
동기 오류 대 비동기 오류
많은 SDK API는 비동기식입니다. PFMultiplayerCreateAndJoinLobby와 같은 API를 호출하여 작업을 시작하고 나중에 해당 비동기 작업이 PFLobbyCreateAndJoinLobbyCompletedStateChange와 같은 "상태 변경"으로 완료됩니다.
즉, 비동기 로비 및 매치 메이킹 클라이언트 API를 사용할 때 처리해야 하는 두 가지 유형의 오류가 있습니다.
- 동기 오류
- 비동기 오류
SDK의 비동기 모델 및 상태 변경에 대한 자세한 내용은 비동기 작업 문서 페이지에서 확인할 수 있습니다.
PFLobbyGetLobbyId와 같은 동기 API의 경우 동기 오류만 처리하면 됩니다.
동기 오류
"동기 오류"는 API 호출의 반환 값으로 제공되는 HRESULT입니다. 이러한 유형의 오류는 일반적으로 잘못된 매개 변수를 통해 API를 호출하거나 라이브러리가 잘못된 상태에서 API를 호출한 경우 또는 내부 라이브러리에서 메모리 할당에 실패한 경우에 발생합니다. API에서 제공하는 모든 출력 매개 변수는 API가 동기 오류를 반환하는 경우 유효하지 않은 것으로 간주되어야 합니다.
비동기 API(예: PFMultiplayerCreateAndJoinLobby)를 호출할 때 동기 오류 값은 요청된 작업을 시작할 수 있는지 여부만 나타냅니다. 비동기 작업의 결과 이해에 대한 자세한 내용은 비동기 오류 섹션을 참조하세요.
비동기 오류
"비동기 오류"는 결과 필드인 각 작업의 비동기 완료와 관련된 상태 변경에서 HRESULT로 제공됩니다. 이러한 오류는 일반적으로 동기 오류보다 타이틀에 더 관심이 있습니다. 비동기적으로 보고되는 일부 유형의 오류 목록은 다음과 같습니다.
- 서비스 제한 오류
- 클라이언트에서 동기식으로 유효성을 검사할 수 없는 잘못된 매개 변수 오류
- 실시간 알림 서비스와 상호 작용하는 오류
- 연결 오류
비동기 및 동기 오류 모두에 대해 사람이 읽을 수 있는 오류 메시지를 얻는 방법에 대한 지침은 오류 코드 및 오류 메시지 섹션을 참조하세요.
오류 코드 및 오류 메시지
오류(동기 또는 비동기)는 라이브러리에서 HRESULT(4바이트 숫자 오류 코드) 형식으로 표시됩니다. 이 간단한 오류 코드는 예기치 않은 타이틀 동작을 디버깅하는 데 사용되는 원격 측정 및 기타 진단 도구에 기록하는 데 이상적입니다.
이러한 오류 코드는 PFMultiplayerGetErrorMessage를 호출하여 사람이 읽을 수 있는 메시지로 변환할 수 있습니다. 해당 오류 메시지는 개발자들만 확인할 수 있게 되어 있습니다. 현지화되지 않았거나 최종 사용자가 사용하기 위한 것이 아니므로 내부 개발 로그에 가장 적합합니다.
또한 오류 메시지와 함께 SDK의 오류 코드 목록은 PlayFab 멀티 플레이어 SDK 오류 코드에서 확인할 수 있습니다.