LogParameters DescribePlayerSessionsRequest ProcessParameters StopMatchBackfillRequest

Amazon GameLift Server SDK(C#) 참조: 데이터 유형

이 Amazon GameLift C# Server SDK 참조를 사용하면 Amazon GameLift와 함께 사용할 멀티플레이어 게임을 준비하는 데 도움이 됩니다. 통합 프로세스에 대한 자세한 내용은 Amazon GameLift를 게임 서버에 추가 섹션을 참조하세요.

작업
데이터 유형

LogParameters

이 데이터 유형은 게임 세션 중에 생성된 파일 가운데 게임 세션 종료 시 Amazon GameLift가 업로드 및 저장하도록 하려는 파일을 식별합니다. 이 정보는 ProcessReady() 호출을 통해 Amazon GameLift 서비스에 전달됩니다.

Amazon GameLift가 향후 사용을 위해 저장하도록 하려는 게임 서버 로그 파일의 디렉터리 경로의 목록입니다. 이들 파일은 각 게임 세션 도중 서버 프로세스에 의해 생성됩니다. 파일 경로 및 이름은 게임 서버에서 정의되고 루트 게임 빌드 디렉터리에 저장됩니다. 로그 경로는 절대값이어야 합니다. 예를 들어, 게임 빌드가 MyGame\sessionlogs\와 같은 경로에 게임 세션 로그를 저장할 경우 로그 경로는 c:\game\MyGame\sessionLogs(Windows 인스턴스) 또는 /local/game/MyGame/sessionLogs(Linux 인스턴스)가 됩니다.

유형: List<String>

필수 항목 여부: 아니요

DescribePlayerSessionsRequest

이 데이터 형식은 검색할 플레이어 세션을 지정하는 데 사용됩니다. 이 형식은 다음과 같이 여러 방식으로 사용될 수 있습니다. (1) 특정 플레이어 세션을 요청하는 PlayerSessionId를 제공, (2) 지정한 게임 세션에서 모든 플레이어 세션을 요청하는 GameSessionId를 제공 또는 (3) 지정한 플레이어의 모든 플레이어 세션을 요청하는 PlayerId를 제공. 플레이어 세션이 대량일 경우 페이지 매김 파라미터를 사용하여 결과를 순차 페이지로 검색합니다.

고유한 게임 세션 식별자입니다. 지정한 게임 세션의 모든 플레이어 세션을 요청하려면 이 파라미터를 사용합니다. 게임 세션 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초) 이내에 연결하지 않았거나 확인되지 않았습니다.

유형: 문자열

필수 항목 여부: 아니요

ProcessParameters

이 데이터 유형에는 ProcessReady() 호출 시 Amazon GameLift 서비스로 보낸 파라미터 집합이 포함됩니다.

서버 프로세스가 새 플레이어 연결을 수신 대기하는 포트 번호입니다. 이 값은 이 게임 서버 빌드를 전개하는 플릿에 대해 구성된 포트 범위에 속해야 합니다. 이 포트 번호는 게임 세션 및 플레이어 세션 객체에 포함되며, 게임 세션이 서버 프로세스에 연결할 때 이 포트 번호를 사용합니다.

유형: 정수

필수 항목 여부: 예

logParameters

게임 세션 로그 파일의 디렉터리 경로 목록을 포함하는 객체입니다.

유형: Aws::GameLift::Server::LogParameters

필수 항목 여부: 예

onStartGameSession

Amazon GameLift가 새 게임 세션을 활성화하기 위해 호출하는 콜백 함수 이름입니다. Amazon GameLift는 클라이언트 요청 CreateGameSession에 대한 응답으로 이 함수를 호출합니다. 콜백 함수는 GameSession 객체를 사용합니다(Amazon GameLift Service API 참조에서 정의함).

유형: void OnStartGameSessionDelegate(GameSession gameSession)

필수 항목 여부: 예

onProcessTerminate

Amazon GameLift 서비스가 서버 프로세스를 강제로 종료하기 위해 호출하는 콜백 함수 이름입니다. 이 함수를 호출한 후 Amazon GameLift는 서버 프로세스가 종료될 때까지 5분을 기다렸다가 ProcessEnding() 호출로 응답한 후 서버 프로세스를 종료합니다.

유형: void OnProcessTerminateDelegate()

필수 항목 여부: 예

onHealthCheck

Amazon GameLift 서비스가 서버 프로세스에 상태 보고서를 요청하기 위해 호출하는 콜백 함수의 이름입니다. Amazon GameLift는 60초마다 이 함수를 호출합니다. 이 함수를 호출한 후 Amazon GameLift는 60초 동안 응답을 기다립니다. 아무 것도 수신되지 않으면 프로세스를 비정상으로 기록합니다.

유형: bool OnHealthCheckDelegate()

필수 항목 여부: 예

onUpdateGameSession

업데이트된 게임 세션 객체를 서버 프로세스에 전달하기 위해 Amazon GameLift 서비스가 호출하는 콜백 함수 이름입니다. Amazon GameLift는 업데이트된 매치메이커 데이터를 제공하기 위해 매치 채우기 요청을 처리할 때 이 함수를 호출합니다. GameSession 객체, 상태 업데이트(updateReason) 및 매치 채우기 티켓 ID를 전달합니다.

유형: void OnUpdateGameSessionDelegate ( UpdateGameSession updateGameSession )

필수 항목 여부: 아니요

StartMatchBackfillRequest

이 데이터 형식은 매치메이킹 채우기 요청을 보내는 데 사용됩니다. 이 정보는 StartMatchBackfill() 호출을 통해 Amazon GameLift 서비스에 전달됩니다.

매치메이커가 이 요청에 사용할 ARN 형식의 고유 식별자입니다. 원본 게임 세션을 만드는 데 사용된 매치메이커를 찾으려면 게임 세션 객체에서 매치메이커 데이터 속성을 확인합니다. 매치메이커 데이터에 대한 자세한 내용은 매치메이커 데이터를 사용하는 작업을 참조하세요.

유형: 문자열

필수 항목 여부: 예

Players

현재 게임 세션에 있는 모든 플레이어를 나타내는 데이터 세트입니다. 매치메이커는 이 정보를 사용하여 현재 플레이어와 적절하게 일치하는 새로운 플레이어를 검색합니다. 플레이어 객체 형식에 대한 자세한 내용은 Amazon GameLift API 참조 가이드를 참조하세요. 플레이어 속성, ID 및 팀 배정을 찾으려면 매치메이커 데이터 속성에서 게임 세션 객체를 확인합니다. 매치메이커에서 지연 시간을 사용하는 경우 현재 리전에 대한 업데이트 지연 시간을 수집하여 각 플레이어의 데이터에 포함합니다.

유형: 플레이어[ ]

필수 항목 여부: 예

TicketId

매치메이킹 또는 매치 채우기 요청 티켓의 고유 식별자입니다. 여기에 값이 제공되지 않으면 Amazon GameLift는 UUID 형식으로 값을 생성합니다. 이 식별자를 사용하여 매치 채우기 티켓 상태를 추적하거나 필요한 경우 요청을 취소합니다.

유형: 문자열

필수 항목 여부: 아니요

StopMatchBackfillRequest

이 데이터 형식은 매치메이킹 채우기 요청을 취소하는 데 사용됩니다. 이 정보는 StopMatchBackfill() 호출을 통해 Amazon GameLift 서비스에 전달됩니다.

Amazon GameLift Server SDK(C#) 참조: 데이터 유형

LogParameters

목차

DescribePlayerSessionsRequest

목차

ProcessParameters

목차

StartMatchBackfillRequest

목차

StopMatchBackfillRequest

목차