기술 자료

지원

Economy

Economy

플레이어 잔액

Use the SDK to manage player currency balances.
읽는 시간 1분최근 업데이트: 17일 전
PlayerBalances
네임스페이스에는 플레이어의 재화 잔액을 가져오고 업데이트하는 것과 관련된 모든 메서드가 포함되어 있습니다. 이러한 메서드는 현재 Authentication SDK에서 로그인된 플레이어의 잔액을 반환합니다.

GetBalancesAsync

현재 사용자의 재화 잔액을 가져옵니다. 필요에 따라 
GetBalancesOptions
를 사용합니다. 잔액을 가져올 때 
GetBalancesOptions
를 사용하여 가져오려는 잔액 수의 제한(1~100까지)을 설정할 수 있습니다. 이는 페이지 지정에 유용합니다. 기본 수는 20입니다. 다음 샘플 코드는 현재 사용자의 처음 잔액 5개를 가져온 다음, 구성에서 삭제된 재화를 포함하여 다음 잔액 5개를 가져옵니다. 
// Optional, defaults to 20GetBalancesOptions options = new GetBalancesOptions{    ItemsPerFetch = 5};GetBalancesResult getBalancesResult = await EconomyService.Instance.PlayerBalances.GetBalancesAsync(options);List<PlayerBalance> firstFiveBalances = getBalancesResult.Balances;// do something with your balancesif (getBalancesResult.HasNext) {    getBalancesResult = await getBalancesResult.GetNextAsync(options.ItemsPerFetch);    List<PlayerBalance> nextFiveBalances = getBalancesResult.Balances;    // do something with your balances}
이 메서드는 
GetBalancesResult
를 반환합니다. GetBalancesResult를 참고하십시오.

GetBalancesOptions

GetBalancesAsync
호출의 옵션 오브젝트입니다. 포함되는 필드는 다음과 같습니다. 
  • ItemsPerFetch
    : 정수입니다. 기본값은 20입니다. 이 필드를 사용하여 1~100까지 호출당 가져올 최대 잔액 수를 설정합니다.

GetBalancesResult

GetBalancesResult
는 가져온 잔액 목록에 대해 페이지가 지정된 액세스를 제공합니다. 포함되는 필드는 다음과 같습니다. 
  • Balances
    : 
    List<PlayerBalance>
    와 현재 가져온 잔액이 있습니다.
포함되는 메서드는 다음과 같습니다. 
  • GetNextAsync(int itemsToFetch = 20)
    : 이 메서드는 비동기식으로 더 많은 결과를 가져옵니다. 여기에는 필요에 따라 가져오는 결과를 제한하는 파라미터 1개가 포함됩니다. 1~100으로 설정할 수 있으며 기본값은 20입니다. 
    Balances
    목록에는 원래 아이템과 새로 가져온 아이템이 모두 포함된 새 결과가 반환됩니다.

SetBalanceAsync

특정 재화의 잔액을 특정 값으로 설정합니다. 이 메서드는 필요에 따라 쓰기 잠금을 설정하는 데 사용되는 
SetBalancesOptions
오브젝트를 사용합니다. 이 내용이 입력된 경우 
writeLock
이 이전 읽기에서 수신한 
writeLock
과 일치하지 않으면 낙관적 동시성을 제공하기 위해 예외가 발생합니다. 입력되지 않은 경우 데이터의 기존 
writeLock
에 구애받지 않고 거래가 진행됩니다. 작업이 성공하면 이 메서드는 업데이트가 적용된 후 현재 잔액을 반환합니다. 
string currencyID = "GOLD_BARS";int newAmount = 1000;string writeLock = "someLockValueFromPreviousRequest";SetBalanceOptions options = new SetBalanceOptions{    WriteLock = writeLock};PlayerBalance newBalance = await EconomyService.Instance.PlayerBalances.SetBalanceAsync(currencyID, newAmount);// ORPlayerBalance otherNewBalance = await EconomyService.Instance.PlayerBalances.SetBalanceAsync(currencyID, newAmount, options);

SetBalanceOptions

SetBalanceAsync
호출의 옵션 오브젝트입니다. 포함되는 필드는 다음과 같습니다. 
  • WriteLock
    : 문자열이며, 기본값은 
    null
    입니다. 이 문자열을 사용하여 낙관적 동시성을 위한 쓰기 잠금을 설정합니다. 쓰기 잠금을 참고하십시오.

IncrementBalanceAsync

특정 재화의 잔액을 특정 값에 따라 증액합니다. 이 메서드는 필요에 따라 쓰기 잠금을 설정하는 데 사용되는 
IncrementBalancesOptions
오브젝트를 사용합니다. 이 내용이 입력된 경우 
writeLock
이 이전 읽기에서 수신한 
writeLock
과 일치하지 않으면 낙관적 동시성을 제공하기 위해 예외가 발생합니다. 입력되지 않은 경우 데이터의 기존 
writeLock
에 구애받지 않고 거래가 진행됩니다. 작업이 성공하면 이 메서드는 업데이트가 적용된 후 현재 잔액을 반환합니다. 
string currencyID = "GOLD_BARS";int incrementAmount = 1000;string writeLock = "someLockValueFromPreviousRequest";IncrementBalanceOptions options = new IncrementBalanceOptions{    WriteLock = writeLock};PlayerBalance newBalance = await EconomyService.Instance.PlayerBalances.IncrementBalanceAsync(currencyID, newAmount);// ORPlayerBalance otherNewBalance = await EconomyService.Instance.PlayerBalances.IncrementBalanceAsync(currencyID, newAmount, options);

IncrementBalanceOptions

IncrementBalanceAsync
호출의 옵션 오브젝트입니다. 포함되는 필드는 다음과 같습니다. 
  • WriteLock
    : 문자열이며, 기본값은 
    null
    입니다. 이 문자열을 사용하여 낙관적 동시성을 위한 쓰기 잠금을 설정합니다. 쓰기 잠금을 참고하십시오.

DecrementBalanceAsync

특정 재화의 잔액을 특정 값에 따라 감액합니다. 이 메서드는 필요에 따라 쓰기 잠금을 설정하는 데 사용되는 
DecrementBalanceOptions
오브젝트를 사용합니다. 이 내용이 입력된 경우 
writeLock
이 이전 읽기에서 수신한 
writeLock
과 일치하지 않으면 낙관적 동시성을 제공하기 위해 예외가 발생합니다. 입력되지 않은 경우 데이터의 기존 
writeLock
에 구애받지 않고 거래가 진행됩니다. 작업이 성공하면 이 메서드는 업데이트가 적용된 후 현재 잔액을 반환합니다. 
string currencyID = "GOLD_BARS";int decrementAmount = 1000;string writeLock = "someLockValueFromPreviousRequest";DecrementBalanceOptions options = new DecrementBalanceOptions{    WriteLock = writeLock};PlayerBalance newBalance = await EconomyService.Instance.PlayerBalances.DecrementBalanceAsync(currencyID, newAmount);// ORPlayerBalance otherNewBalance = await EconomyService.Instance.PlayerBalances.DecrementBalanceAsync(currencyID, newAmount, options);

DecrementBalanceOptions

DecrementBalanceAsync
호출의 옵션 오브젝트입니다. 포함되는 필드는 다음과 같습니다. 
  • WriteLock
    : 문자열이며, 기본값은 
    null
    입니다. 이 문자열을 사용하여 낙관적 동시성을 위한 쓰기 잠금을 설정합니다. 쓰기 잠금을 참고하십시오.

PlayerBalance

플레이어 잔액은 플레이어의 단일 재화 잔액을 나타냅니다. 포함되는 필드는 다음과 같습니다. 
  • CurrencyId
    : 이 잔액이 나타내는 재화의 ID입니다.
  • Balance
    : 플레이어가 보유한 이 재화의 금액(정수)입니다.
  • WriteLock
    : 현재 
    writeLock
    문자열입니다.
  • Created
    : 이 잔액이 생성된 날짜입니다. EconomyDate 오브젝트입니다.
  • Modified
    : 이 잔액이 수정된 날짜입니다. EconomyDate 오브젝트입니다.
다음의 헬퍼 메서드도 포함되어 있습니다.

GetCurrencyDefinitionAsync

이 잔액과 연결된 재화의 재화 정의를 가져올 수 있는 간편한 메서드입니다. CurrencyDefinition이 반환됩니다. 
PlayerBalance myPlayerBalance = ... // Get a player balance from one of the above methodsCurrencyDefinition currencyDefForMyPlayerBalance = myPlayerBalance.GetCurrencyDefinitionAsync();

BalanceUpdated

이 이벤트를 구독하면 SDK에서 특정 재화의 잔액이 업데이트될 때 알림을 받을 수 있습니다. 구독자에게는 업데이트된 잔액의 재화 ID가 전달됩니다. 
EconomyService.Instance.PlayerBalances.BalanceUpdated += currencyID => {    Debug.Log($"The currency that was updated was {currencyID}");};