C#용 Amazon GameLift Server SDK 4.x: 데이터 유형

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

유형: List<String>

필수 여부: 아니요

고유한 게임 세션 식별자입니다. 지정한 게임 세션의 모든 플레이어 세션을 요청하려면 이 파라미터를 사용합니다. 게임 세션 ID 형식은 다음과 같습니다. arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>. <ID string> 값은 사용자 지정 ID 문자열(게임 세션을 만들 때 지정한 경우) 또는 생성 문자열입니다.

유형: 문자열

필수 항목 여부: 아니요

반환할 최대 결과 수입니다. 이 파라미터를 와 함께 사용하여 결과를 순차적 페이지 세트로 NextToken 가져옵니다. 플레이어 세션 ID가 지정된 경우 이 파라미터가 무시됩니다.

유형: 정수

필수 항목 여부: 아니요

결과의 다음 순차 페이지의 시작을 나타내는 토큰입니다. 반환된 토큰을 이 작업에 대한 이전 호출과 함께 사용합니다. 결과 집합의 시작을 지정하려면 값을 지정하지 마십시오. 플레이어 세션 ID가 지정된 경우 이 파라미터가 무시됩니다.

유형: 문자열

필수 항목 여부: 아니요

사용자의 고유 식별자입니다. 플레이어IDs는 개발자가 정의합니다. 플레이어 ID 생성을 참조하세요.

유형: 문자열

필수 항목 여부: 아니요

플레이어 세션의 고유 식별자입니다.

유형: 문자열

필수 항목 여부: 아니요

결과를 필터링하는 기준이 되는 플레이어 세션 상태입니다. 다음과 같은 플레이어 세션 상태가 가능합니다.

유형: 문자열

필수 항목 여부: 아니요

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

유형: 정수

필수 여부: 예

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

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

필수 항목 여부: 예

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

유형: void OnStartGameSessionDelegate(GameSession gameSession)

필수 항목 여부: 예

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

유형: void OnProcessTerminateDelegate()

필수 항목 여부: 예

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

유형: bool OnHealthCheckDelegate()

필수 항목 여부: 예

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

유형: void OnUpdateGameSessionDelegate ( UpdateGameSession updateGameSession )

필수 항목 여부: 아니요

고유한 게임 세션 식별자입니다. SDK 메서드는 식별자를 ARN 형식으로 GetGameSessionId() 반환합니다.

유형: 문자열

필수 항목 여부: 예

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

유형: 문자열

필수 항목 여부: 예

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

유형: 플레이어[ ]

필수 여부: 예

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

유형: 문자열

필수 항목 여부: 아니요

취소 중인 요청과 연결된 고유한 게임 세션 식별자입니다.

유형: 문자열

필수 항목 여부: 예

이 요청을 보낸 매치메이커의 고유 식별자입니다.

유형: 문자열

필수 항목 여부: 예

취소할 채우기 요청 티켓의 고유 식별자입니다.

유형: 문자열

필수 항목 여부: 예