게임 세션 대기열 생성

대기열은 여러 플릿 및 리전에서 사용 가능한 최적의 호스팅 리소스로 새 게임 세션을 배치하는 데 사용됩니다. 게임에서 대기열을 빌드하는 방법에 대한 자세한 내용은 게임 세션 대기열 설계 섹션을 참조하세요.

게임 클라이언트에서는 배치 요청을 사용하여 대기열에서 새로운 게임 세션이 시작됩니다. 게임 세션 만들기 섹션에서 게임 세션 배치에 대한 자세한 내용을 알아봅니다.

대기열의 대기열 대상을 업데이트할 때 짧은 전환 기간(최대 30초)이 발생하며, 이 기간 동안 대기열 대상에 배치된 게임 세션이 이전 플릿으로 넘어갈 수 있습니다.

Console

1. Amazon GameLift 콘솔의 탐색 창에서 대기열을 선택합니다.

2. 대기열 페이지에서 대기열 생성을 선택합니다.

3. 대기열 생성 페이지의 대기열 설정에서 다음을 수행하세요.

   1. 이름에는 고유한 이름을 입력합니다.

   2. 제한 시간에는 Amazon GameLift가 중지하기 전에 게임 세션을 배치하도록 하려는 시간을 입력합니다. Amazon GameLift는 요청 시간이 될 때까지 모든 플릿에서 사용 가능한 리소스를 검색합니다.

   3. (선택 사항) 플레이어 지연 시간 정책에는 Amazon GameLift가 정의된 최대 지연 시간 내에서 리소스를 찾는 시간을 입력합니다. 정책을 추가하여 최대 지연 시간을 점진적으로 완화시킵니다. 정책을 더 추가하려면 정책 추가를 선택합니다.

4. 게임 세션 배치 위치에서 대기열에 포함할 위치를 선택합니다. 기본적으로 모든 위치가 포함됩니다. 대기열에 있는 모든 플릿에는 동일한 인증서 구성이 있어야 합니다. 모든 플릿이 대기열을 사용하는 게임 클라이언트와 호환되는 게임 빌드를 실행하고 있어야 합니다.

5. 대상 순서에서 하나 이상의 대상을 대기열에 추가합니다.

   1. 대상 추가를 선택합니다.

   2. 대상이 있는 위치를 선택합니다.

   3. 대상 유형을 선택합니다.

   4. 결과로 얻는 플릿 또는 별칭 이름 목록에서 추가하려는 것을 하나 선택합니다.

   5. 대상이 여러 개 있는 경우 대상 왼쪽에 있는 점 6개 아이콘을 드래그하여 기본 순서를 설정합니다. Amazon GameLift는 새 게임 세션 배치에 사용할 수 있는 리소스를 대상에서 검색할 때 이 순서를 사용합니다.

6. 게임 세션 배치 우선순위의 경우 지연 시간, 비용, 대상 및 위치 값을 추가하고 드래그하여 Amazon GameLift가 대기열에 있는 플릿의 우선 순위를 지정하는 방법을 정의합니다. 플릿의 우선 순위 지정에 대한 자세한 내용은 게임 세션 배치 우선순위 섹션을 참조하세요.

7. 위치 순서에 위치를 추가하고 대기열이 사용해야 하는 우선 순위로 드래그합니다. 위치가 게임 세션 배치의 마지막 우선 순위인 경우 Amazon GameLift는 위치를 타이브레이커로 사용합니다.

8. (선택 사항) 이벤트 알림 설정에서 다음을 수행합니다.

   1. 배치 관련 이벤트 알림을 수신할 SNS 주제를 선택하거나 생성합니다. 이벤트 알림에 대한 자세한 내용은 게임 세션 배치의 이벤트 알림 설정 섹션을 참조하세요.

   2. 이 대기열에서 생성된 이벤트에 추가할 사용자 지정 이벤트 데이터를 추가합니다.

9. (선택 사항) 태그를 추가합니다. 태그 지정에 대한 자세한 내용은 AWS 리소스 태그 지정을 참조하세요.

10. 생성을 선택합니다.

AWS CLI

예 대기열 생성

다음 예제에서는 다음과 같은 구성으로 게임 세션 대기열을 생성합니다.

• 5분 제한 시간

• 2개의 플릿 대상

• us-east-1, us-east-2, us-west-2, ca-central-1의 위치만 허용하도록 필터링합니다.

• 비용을 기준으로 대상의 우선 순위를 정한 다음 정의된 순서대로 위치를 지정합니다.

aws gamelift create-game-session-queue \
    --name "sample-test-queue" \
    --timeout-in-seconds 300 \
    --destinations DestinationArn="arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-772266ba-8c82-4a6e-b620-a74a62a93ff8" DestinationArn="arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-33f28fb6-aa8b-4867-85b4-ceb217bf5994" \
    --filter-configuration "AllowedLocations=us-east-1, ca-central-1, us-east-2, us-west-2" \
    --priority-configuration PriorityOrder="LOCATION","DESTINATION",LocationOrder="us-east-1","us-east-2","ca-central-1","us-west-2" \
    --notification-target "arn:aws:sns:us-east-1:111122223333:gamelift-test.fifo"

참고

플릿 또는 별칭 ID로 describe-fleet-attributes 또는 describe-alias를 호출하여 플릿 및 별칭 ARN 값을 가져올 수 있습니다.

create-game-session-queue 요청이 성공하면 Amazon GameLift가 새 대기열 구성과 함께 GameSessionQueue 객체를 반환합니다. 이제 StartGameSessionPlacement를 사용하여 대기열에 요청을 제출할 수 있습니다.

예 플레이어 지연 시간 정책이 포함된 대기열 생성

다음 예제에서는 다음과 같은 구성으로 게임 세션 대기열을 생성합니다.

• 10분 제한 시간

• 3개의 플릿 대상

• 플레이어 지연 시간 정책 세트

aws gamelift create-game-session-queue \
    --name "matchmaker-queue" \
    --timeout-in-seconds 600 \
    --destinations DestinationArn=arn:aws:gamelift:us-east-1::alias/alias-a1234567-b8c9-0d1e-2fa3-b45c6d7e8910 \
               DestinationArn=arn:aws:gamelift:us-west-2::alias/alias-b0234567-c8d9-0e1f-2ab3-c45d6e7f8901 \
               DestinationArn=arn:aws:gamelift:us-west-2::fleet/fleet-f1234567-b8c9-0d1e-2fa3-b45c6d7e8912 \
    --player-latency-policies "MaximumIndividualPlayerLatencyMilliseconds=50,PolicyDurationSeconds=120" \
               "MaximumIndividualPlayerLatencyMilliseconds=100,PolicyDurationSeconds=120" \
               "MaximumIndividualPlayerLatencyMilliseconds=150" \

create-game-session-queue 요청이 성공하면 Amazon GameLift가 새 대기열 구성과 함께 GameSessionQueue 객체를 반환합니다.