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

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

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

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

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

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

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

      • Amazon GameLift 관리형 EC2플릿 또는 Anywhere Amazon GameLift Agent를 사용하는 플릿:

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

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

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

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