Skip to main content

Lobby 및 Matchmaking SDK 오류 처리

이 페이지는 PlayFab Lobby 및 Matchmaking SDK가 오류를 표시하는 방식과 이를 처리하는 방법에 대한 빠른 참조 역할을 하기 위한 것입니다. 다음 주제가 논의됩니다.

동기 대 비동기 오류

많은 SDK API는 비동기입니다. PFMultiplayerCreateAndJoinLobby와 같은 API를 호출하여 작업을 시작하고, 나중에 해당 비동기 작업은 PFLobbyCreateAndJoinLobbyCompletedStateChange와 같은 “상태 변경”으로 완료됩니다. 즉, 비동기 Lobby 및 Matchmaking Client API를 사용할 때 처리해야 하는 두 가지 유형의 오류가 있습니다.
  1. 동기 오류
  2. 비동기 오류
SDK의 비동기 모델 및 상태 변경에 대한 자세한 정보는 비동기 작업 문서 페이지에서 찾을 수 있습니다. PFLobbyGetLobbyId와 같은 동기 API의 경우, 동기 오류만 처리하면 됩니다.

동기 오류

“동기 오류”는 API 호출의 반환 값으로 제공되는 HRESULT입니다. 이러한 오류는 일반적으로 잘못된 매개 변수로 API를 호출하거나, 라이브러리가 잘못된 상태에 있는 동안 API를 호출하거나, 메모리 할당에 대한 내부 라이브러리 실패로 인해 발생합니다. API가 동기 오류를 반환하는 경우, API에서 제공하는 출력 매개 변수는 유효하지 않은 것으로 간주해야 합니다. 비동기 API(예: PFMultiplayerCreateAndJoinLobby)를 호출할 때, 동기 오류 값은 요청된 작업이 시작될 수 있었는지 여부만 나타냅니다. 비동기 작업의 결과를 이해하는 방법에 대한 정보는 비동기 오류 섹션을 참조하세요.

비동기 오류

“비동기 오류”는 각 작업의 비동기 완료와 관련된 상태 변경의 result 필드에서 HRESULT로 제공됩니다. 이러한 오류는 일반적으로 동기 오류보다 타이틀에게 더 흥미롭습니다. 비동기로 보고되는 오류 유형의 일부(전체 목록은 아님)는 다음과 같습니다.
  • 서비스 스로틀링 오류
  • 클라이언트에서 동기적으로 유효성 검사할 수 없는 잘못된 매개 변수 오류
  • 실시간 메시지 서비스와의 상호 작용 오류
  • 연결 오류
비동기 및 동기 오류 모두에 대해 사람이 읽을 수 있는 오류 메시지를 얻는 방법에 대한 지침은 오류 코드 및 오류 메시지 섹션을 참조하세요.

오류 코드 및 오류 메시지

오류(동기 또는 비동기)는 라이브러리에서 HRESULT 형태로 제공됩니다. HRESULT는 4바이트 숫자 오류 코드입니다. 이러한 간결한 오류 코드는 예기치 않은 타이틀 동작을 디버깅하는 데 사용되는 원격 분석 및 기타 진단 도구에 기록하기에 이상적입니다. 이러한 오류 코드는 PFMultiplayerGetErrorMessage를 호출하여 사람이 읽을 수 있는 메시지로 변환할 수 있습니다. 이러한 오류 메시지는 개발자만 볼 수 있도록 의도되었습니다. 지역화되지 않았거나 최종 사용자가 소비하도록 의도되지 않았으므로, 내부 개발 로그에 가장 적합합니다. 또한 오류 메시지와 함께 SDK의 오류 코드 목록은 PlayFab Multiplayer SDK Error Codes에서 확인할 수 있습니다.
마지막 수정일 2026년 8월 13일