Unreal Engine용 Amazon GameLift 서버 SDK: 데이터 유형
Unreal용 Amazon GameLift 서버 SDK 참조를 사용하면 Amazon GameLift와 함께 사용할 멀티플레이어 게임을 통합하는 데 도움이 됩니다. 통합 프로세스에 대한 지침은 Amazon GameLift를 게임 서버에 추가 페이지를 참조하세요.
이 API는 GameLiftServerSDK.h 및 GameLiftServerSDKModels.h에 정의되어 있습니다.
Unreal Engine 플러그인을 설치하려면 코드 샘플 Amazon GameLift를 Unreal Engine 프로젝트에 통합 섹션을 참조하세요.
Unreal Engine용 Amazon GameLift 서버 SDK: 작업
주제
FDescribePlayerSessionsRequest
이 데이터 형식은 검색할 플레이어 세션을 지정하는 데 사용됩니다. 다음과 같이 사용할 수 있습니다.
-
특정 플레이어 세션을 요청하려면 PlayerSessionId를 제공합니다.
-
지정한 게임 세션의 모든 플레이어 세션을 요청하려면 GameSessionId를 제공합니다.
-
지정한 플레이어의 모든 플레이어 세션을 요청하려면 PlayerId를 제공합니다.
플레이어 세션이 대량일 경우 페이지 매김 파라미터를 사용하여 결과를 순차 블록으로 검색합니다.
내용
- GameSessionId
-
고유한 게임 세션 식별자입니다. 지정한 게임 세션의 모든 플레이어 세션을 요청하려면 이 파라미터를 사용합니다. 게임 세션 ID 형식은 다음과 같습니다.
arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>. <ID string> 값은 사용자 지정 ID 문자열(게임 세션을 만들 때 지정한 경우) 또는 생성 문자열입니다.유형: 문자열
필수 항목 여부: 아니요
- Limit
-
반환할 최대 결과 수입니다. 결과를 순차적인 일련의 페이지로 가져오려면 이 파라미터를 NextToken과 함께 사용합니다. 플레이어 세션 ID가 지정된 경우 이 파라미터가 무시됩니다.
유형: 정수
필수 항목 여부: 아니요
- NextToken
-
결과의 다음 순차 페이지의 시작을 나타내는 토큰입니다. 반환된 토큰을 이 작업에 대한 이전 호출과 함께 사용합니다. 결과 집합의 시작을 지정하려면 값을 지정하지 마십시오. 플레이어 세션 ID가 지정된 경우 이 파라미터가 무시됩니다.
유형: 문자열
필수 항목 여부: 아니요
- PlayerId
-
사용자의 고유 식별자입니다. 플레이어 ID는 개발자에 의해 정의됩니다. 플레이어 ID 생성 섹션을 참조하세요.
유형: 문자열
필수 항목 여부: 아니요
- PlayerSessionId
-
플레이어 세션의 고유 식별자입니다.
유형: 문자열
필수 항목 여부: 아니요
- PlayerSessionStatusFilter
-
결과를 필터링하는 기준이 되는 플레이어 세션 상태입니다. 다음과 같은 플레이어 세션 상태가 가능합니다.
-
RESERVED - 플레이어 세션 요청이 수신되었지만, 플레이어가 서버 프로세스에 연결되지 않았거나 확인되지 않았습니다.
-
ACTIVE - 플레이어가 서버 프로세스에 의해 확인되고 현재 연결되어 있습니다.
-
COMPLETED - 플레이어 연결이 끊어졌습니다.
-
TIMEDOUT - 플레이어 세션 요청이 수신되었지만 플레이어가 제한 시간(60초) 이내에 연결하지 않았거나 확인되지 않았습니다.
유형: 문자열
필수 항목 여부: 아니요
-
FProcessParameters
이 데이터 유형에는 ProcessReady() 호출 시 Amazon GameLift 서비스로 보낸 파라미터 집합이 포함됩니다.
내용
- 포트
-
서버 프로세스가 새 플레이어 연결을 수신 대기하는 포트 번호입니다. 이 값은 이 게임 서버 빌드를 전개하는 플릿에 대해 구성된 포트 범위에 속해야 합니다. 이 포트 번호는 게임 세션 및 플레이어 세션 객체에 포함되며, 게임 세션이 서버 프로세스에 연결할 때 이 포트 번호를 사용합니다.
유형: 정수
필수 여부: 예
- logParameters
-
게임 세션 로그 파일의 디렉터리 경로 목록을 포함하는 객체입니다.
유형: 어레이 <FString>
필수 항목 여부: 아니요
- onStartGameSession
-
Amazon GameLift가 새 게임 세션을 활성화하기 위해 호출하는 콜백 함수 이름입니다. Amazon GameLift는 클라이언트 요청 CreateGameSession에 대한 응답으로 이 함수를 호출합니다. 콜백 함수는 GameSession 객체를 사용합니다(Amazon GameLift Service API 참조에서 정의함).
형식: FOnStartGameSession
필수 여부: 예
- onProcessTerminate
-
Amazon GameLift 서비스가 서버 프로세스를 강제로 종료하기 위해 호출하는 콜백 함수 이름입니다. 이 함수를 호출한 후 Amazon GameLift는 서버 프로세스가 종료될 때까지 5분을 기다렸다가 ProcessEnding() 호출로 응답한 후 서버 프로세스를 종료합니다.
형식: FSimpleDelegate
필수 항목 여부: 아니요
- onHealthCheck
-
Amazon GameLift 서비스가 서버 프로세스에 상태 보고서를 요청하기 위해 호출하는 콜백 함수의 이름입니다. Amazon GameLift는 60초마다 이 함수를 호출합니다. 이 함수를 호출한 후 Amazon GameLift는 60초 동안 응답을 기다립니다. 아무 것도 수신되지 않으면 프로세스를 비정상으로 기록합니다.
형식: FOnHealthCheck
필수 항목 여부: 아니요
- onUpdateGameSession
-
업데이트된 게임 세션 객체를 서버 프로세스에 전달하기 위해 Amazon GameLift 서비스가 호출하는 콜백 함수 이름입니다. Amazon GameLift는 업데이트된 매치메이커 데이터를 제공하기 위해 매치 채우기 요청을 처리할 때 이 함수를 호출합니다. GameSession 객체, 상태 업데이트(
updateReason) 및 매치 채우기 티켓 ID를 전달합니다.유형: FonUpdateGameSession
필수 항목 여부: 아니요
FStartMatchBackfillRequest
이 데이터 형식은 매치메이킹 채우기 요청을 보내는 데 사용됩니다. 이 정보는 StartMatchBackfill() 호출을 통해 Amazon GameLift 서비스에 전달됩니다.
내용
- GameSessionArn
-
고유한 게임 세션 식별자입니다. GetGameSessionId() API 작업은 ARN 형식의 식별자를 반환합니다.
형식: FString
필수 여부: 예
- MatchmakingConfigurationArn
-
매치메이커가 이 요청에 사용할 ARN 형식의 고유 식별자입니다. 원본 게임 세션을 만드는 데 사용된 매치메이커를 찾으려면 게임 세션 객체에서 매치메이커 데이터 속성을 확인합니다. 매치메이커 데이터에 대한 자세한 내용은 매치메이커 데이터를 사용하는 작업을 참조하세요.
형식: FString
필수 여부: 예
- Players
-
현재 게임 세션에 있는 모든 플레이어를 나타내는 데이터 세트입니다. 매치메이커는 이 정보를 사용하여 현재 플레이어와 적절하게 일치하는 새로운 플레이어를 검색합니다. 플레이어 객체 형식에 대한 자세한 내용은 Amazon GameLift API 참조 가이드를 참조하세요. 플레이어 속성, ID 및 팀 배정을 찾으려면 매치메이커 데이터 속성에서 게임 세션 객체를 확인합니다. 매치메이커에서 지연 시간을 사용하는 경우 현재 리전에 대한 업데이트 지연 시간을 수집하여 각 플레이어의 데이터에 포함합니다.
유형: TArray<FPlayer>
필수 여부: 예
- TicketId
-
매치메이킹 또는 매치 채우기 요청 티켓의 고유 식별자입니다. 여기에 값이 제공되지 않으면 Amazon GameLift는 UUID 형식으로 값을 생성합니다. 이 식별자를 사용하여 매치 채우기 티켓 상태를 추적하거나 필요한 경우 요청을 취소합니다.
형식: FString
필수 항목 여부: 아니요
FStopMatchBackfillRequest
이 데이터 형식은 매치메이킹 채우기 요청을 취소하는 데 사용됩니다. 이 정보는 StopMatchBackfill() 호출을 통해 Amazon GameLift 서비스에 전달됩니다.
내용
- GameSessionArn
-
취소 중인 요청과 연결된 고유한 게임 세션 식별자입니다.
형식: FString
필수 여부: 예
- MatchmakingConfigurationArn
-
이 요청을 보낸 매치메이커의 고유 식별자입니다.
형식: FString
필수 여부: 예
- TicketId
-
취소할 채우기 요청 티켓의 고유 식별자입니다.
형식: FString
필수 여부: 예
