다음을 통해 공유

Economy V2 TurboLoading

  • 아티클

TurboLoading을 사용하면 GetInventoryItems API에 대한 단일 요청으로 전체 인벤토리를 로드할 수 있습니다. 이렇게 하면 인벤토리 컬렉션에서 모든 항목을 로드하기 위해 여러 번의 호출을 수행할 필요가 없으므로 시작 대기 시간과 성능이 향상됩니다. 청구를 위해 250개 항목마다 단일 페이지로 처리되므로 비용은 변경되지 않습니다.

TurboLoading은 어떻게 작동하나요?

TurboLoading은 현재 Economy V2 REST API를 사용하여 모든 타이틀에 사용할 수 있습니다. PlayFab 서비스 C# 및 Unity SDK는 압축 해제를 투명하게 처리하는 등 압축에 대한 추가 지원을 제공합니다. TurboLoading을 활성화하려면 다음을 수행해야 합니다.

  • GetInventoryItems API의 Count 매개 변수를 250개 이상의 항목으로 설정합니다. 인벤토리 컬렉션의 최대 크기(10,000개 항목)까지 설정할 수 있습니다.
  • 요청에 Accept-Encoding: gzip 헤더를 포함합니다.
  • 인벤토리 데이터를 사용하기 전에 gzip을(를) 사용하여 응답을 압축 해제합니다.

예를 들어 700개 항목의 전체 인벤토리를 로드하려는 경우 개수 700개와 Accept-Encoding: gzip 헤더를 사용하여 GetInventoryItems API를 한 번 호출할 수 있습니다. 모든 인벤토리 항목과 압축된 응답을 받습니다. 데이터를 사용하려면 gzip을 사용하여 응답을 압축 해제해야 합니다.

PlayFab 서비스 C# 및 Unity SDK에서 TurboLoading 사용

다음과 같이 PlayFab 서비스 C# 및 Unity SDK를 사용하여 모든 API 응답의 압축(및 자동 압축 해제)을 설정할 수 있습니다.

PlayFabSettings.staticSettings.CompressResponses = true;

또는 다음과 같이 Economy API 인스턴스에 대한 압축(및 자동 압축 해제)만 설정할 수 있습니다.

var economyApi = new PlayFabEconomyInstanceAPI(new PlayFabApiSettings { CompressResponses = true }, authContext);

결제

TurboLoading은 반환된 페이지당 요금이 청구됩니다. 즉, 반환되는 총 항목 수는 250(반올림됨)으로 나눈 값입니다. 페이지당 250개 항목을 로드하는 경우와 동일한 요금을 지불합니다. 예를 들어 TurboLoading을 사용하여 700개의 항목을 로드하면 3개의 요청(700/250 = 2.8, 최대 3으로 반올림됨)에 대한 요금이 청구됩니다.

장점

TurboLoading은 다음과 같은 몇 가지 이점을 제공합니다.

  • 인벤토리 항목을 로드하기 위해 여러 차례 호출할 필요가 없으므로 게임 성능이 향상되고 시작 대기 시간이 단축됩니다.
  • 페이지 매김 및 반복 논리를 처리할 필요가 없으므로 복잡성 및 코드 유지 관리가 줄어듭니다.

참고 항목