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

플레이어 게이트웨이를 게임에 통합

플레이어 게이트웨이 지원 플릿을 생성한 후 플레이어 게이트웨이와 통합되도록 게임 클라이언트 및 게임 백엔드를 업데이트해야 합니다. 게임 백엔드는 릴레이 엔드포인트와 플레이어 게이트웨이 토큰을 검색한 다음 게임 클라이언트에 제공합니다. 게임 클라이언트는 모든 UDP 트래픽을 이러한 릴레이 엔드포인트로 전송합니다.

통합은 다음 호출 경로를 따릅니다.

백엔드 통합

게임 백엔드는 GetPlayerConnectionDetails API를 호출하여 플레이어에 대한 릴레이 엔드포인트 및 플레이어 게이트웨이 토큰을 검색해야 합니다. 그러면 백엔드가 게임 클라이언트에이 정보를 제공합니다.

GetPlayerConnectionDetails API

GetPlayerConnectionDetails API는 게임 세션의 플레이어에 대한 연결 세부 정보를 반환합니다.

게임 클라이언트는 두 연결 유형을 모두 처리하도록 설계되어야 합니다.

API 호출 예제:

// C++ example using AWS SDK
Aws::GameLift::GameLiftClient client;
Aws::GameLift::Model::GetPlayerConnectionDetailsRequest request;
request.SetGameSessionId(gameSessionId);
request.SetPlayerIds(playerIds);  // Vector of player IDs

auto outcome = client.GetPlayerConnectionDetails(request);
if (outcome.IsSuccess()) {
    auto result = outcome.GetResult();
    auto connectionDetails = result.GetPlayerConnectionDetails();
    
    // Process each player's connection details
    for (const auto& detail : connectionDetails) {
        std::string playerId = detail.GetPlayerId();
        
        // Get relay endpoints (IP address and port)
        auto endpoints = detail.GetEndpoints();
        for (const auto& endpoint : endpoints) {
            std::string ipAddress = endpoint.GetIpAddress();
            int port = endpoint.GetPort();
        }
        
        // Get player gateway token
        auto token = detail.GetPlayerGatewayToken();
        
        // Get expiration time
        auto expiration = detail.GetExpiration();
        
        // Send endpoints and token to game client
    }
}

API 참조의 GetPlayerConnectionDetails를 참조하세요. Amazon GameLift Servers

릴레이 엔드포인트 새로 고침

릴레이 엔드포인트가 비정상이 되면를 GetPlayerConnectionDetails 주기적으로 호출하여 플레이어에게 업데이트된 엔드포인트를 제공합니다. 게임 세션의 모든 플레이어에 대해 60초마다 API를 호출하는 것이 좋습니다. API 사용을 최적화하려면 단일 API 호출에서 여러 플레이어 IDs를 일괄 처리합니다.

클라이언트 통합

게임 클라이언트는 모든 발신 UDP 패킷에 플레이어 게이트웨이 토큰을 추가하고 제공된 릴레이 엔드포인트로 패킷을 전송해야 합니다. Amazon GameLift Servers 클라이언트 SDK for C++ 및 Unreal Engine은 이러한 통합을 간소화하는 유틸리티를 제공합니다.

클라이언트 요구 사항

플레이어 게이트웨이를 통해 트래픽을 라우팅하려면 게임 클라이언트가 다음을 수행해야 합니다.

클라이언트 SDK

C++ 및 Unreal Engine용 Amazon GameLift Servers 클라이언트 SDK는 플레이어 게이트웨이 통합을 간소화하는 유틸리티를 제공합니다.

엔드포인트 선택 알고리즘

클라이언트 SDK는 사용할 릴레이 엔드포인트를 선택하기 위한 두 가지 기본 제공 알고리즘을 제공합니다.

SDK의 기본 알고리즘 클래스를 확장하여 사용자 지정 알고리즘을 구현할 수도 있습니다.

클라이언트 SDK 리소스

전체 통합 지침 및 샘플 코드는 다음 리소스를 참조하세요.

통합 테스트

플릿에 배포하기 전에 플레이어 게이트웨이 테스트 도구를 사용하여 플레이어 게이트웨이 통합을 로컬에서 테스트합니다. 이 도구는 플레이어 게이트웨이 UDP 프록시 인프라를 시뮬레이션하고 게임 클라이언트가 플레이어 게이트웨이 토큰을 올바르게 우선시하고, 여러 엔드포인트를 통해 트래픽을 라우팅하고, 네트워크 성능 저하를 처리하는지 확인하는 데 도움이 됩니다.

설정 및 사용 지침은 GitHub의 플레이어 게이트웨이 테스트 앱을 참조하세요.

모범 사례

플레이어 게이트웨이를 통합할 때 다음 모범 사례를 따르세요.