Amazon GameLift 서버 SDK 5.x로 마이그레이션 - Amazon GameLift

Amazon GameLift 서버 SDK 5.x로 마이그레이션

Server SDK 버전 5.x를 사용하도록 게임 프로젝트를 업데이트하려면 다음과 같이 변경합니다.

  1. 개발 환경에 대한 최신 Amazon GameLift Server SDK 패키지[다운로드 사이트]를 다운로드합니다. 다운로드한 패키지 및 버전에 대한 Readme 파일의 설치 지침을 따릅니다. 게임 프로젝트에서 서버 SDK를 사용하려면 다음 지침을 참조하세요.

  2. 다음과 같이 서버 코드를 업데이트합니다.

    • 서버 코드 콜백 함수 onCreateGameSession()을 onStartGameSession()으로 변경합니다.

    • 필요에 따라 InitSDK() 입력을 업데이트합니다.

      • Amazon GameLift 관리형 EC2 플릿 또는 Amazon GameLift 에이전트를 사용하는 Anywhere 플릿에 게임 서버 빌드를 배포하려는 경우:

        (C++) (C#) (Unreal) 파라미터 없이 InitSDK()를 호출합니다. 호출 후 컴퓨팅 환경과 Amazon GameLift 서비스에 대한 WebSocket 연결이 설정됩니다.

      • Amazon GameLift 에이전트 없이 게임 서버 빌드를 Anywhere 플릿에 배포하려는 경우:

        (C++) (C#) (Unreal) 서버 파라미터로 InitSDK()를 호출합니다. 게임 서버 프로세스가 이러한 파라미터를 사용하여 Amazon GameLift 서비스와의 연결을 설정합니다.

  3. 게임 서버 빌드 또는 기타 호스팅 애플리케이션이 실행 중에 다른 AWS 리소스와 통신하는 경우 애플리케이션이 해당 리소스에 액세스하는 방법을 변경해야 합니다. AssumeRoleCredentials의 사용을 새 Amazon GameLift 서버 SDK 작업 GetFleetRoleCredentials()(게임 서버용)로 바꾸거나 공유 자격 증명(다른 애플리케이션의 경우)을 사용합니다. 이 변경 사항을 구현하는 방법에 대한 자세한 내용은 플릿에서 다른 AWS 리소스와 통신 페이지를 참조하세요.

  4. 프로젝트가 서버 SDK 작업 GetInstanceCertificate()을 호출하여 TLS 인증서를 검색한 경우 대신 새 GetComputeCertificate()(C++) (C#) (Unreal )를 사용하도록 코드를 수정합니다.

  5. Amazon GameLift에 게임 빌드를 업로드할 때(예: upload-build 또는 CreateBuild()) ServerSdkVersion 파라미터를 사용 중인 5.x 버전으로 설정합니다(이 파라미터는 현재 기본값이 4.0.2임). 이 파라미터는 게임 서버 빌드의 실제 서버 SDK 라이브러리와 일치해야 합니다. 업로드된 게임 서버 빌드에 잘못된 버전을 지정하면 해당 빌드로 생성한 모든 플릿이 실패합니다. Amazon GameLift 호스팅을 위한 사용자 지정 서버 빌드 배포 섹션을 참조하세요.

    다음 예제에서는 서버 SDK 버전을 지정하는 방법을 보여줍니다.

    aws gamelift upload-build \
    --operating-system AMAZON_LINUX_2023 \
    --server-sdk-version "5.0.0" \
    --build-root "~/mygame" \
    --name "My Game Nightly Build" \
    --build-version "build 255" \
    --region us-west-2

  6. 스크립트를 사용하여 관리형 플릿에 원격으로 연결하는 경우 Amazon GameLift 플릿 인스턴스 원격 액세스에 설명된 대로 새 프로세스를 사용하도록 스크립트를 업데이트합니다.