GS2-Distributor API 레퍼런스

프로퍼티의 증가 처리를 중계하여, 대상 소지 수량이 상한에 도달한 경우 GS2-Inbox로 전송하는 기능을 제공합니다.
이 기능을 이용하면 소지 수량이 상한에 도달했을 때의 복잡한 분기 처리를 없앨 수 있어, 의도하지 않은 데이터 손실의 위험을 피할 수 있습니다.

그 밖에도, GS2 내에서 일관성 있는 처리를 실현하기 위한 구조인 트랜잭션의 실행 처리에도 사용됩니다.

검증 액션은 트랜잭션 실행을 시작하기 전에, 소비 액션이나 입수 액션을 실행할 수 있는 상태인지를 사전에 체크하는 액션입니다.
예를 들어 “특정 아이템을 소지하고 있는지”, “랭크가 일정 값 이상인지”, “특정 퀘스트를 클리어했는지” 와 같은 조건을, 소비가 발생하기 전에 확인할 수 있습니다.

소비 액션은 플레이어에게 불이익이 되는 처리를 나타내는 액션입니다.
아이템 소비, 통화 소비, 스태미나 소비, 횟수 제한 카운터 증가 등이 여기에 해당합니다.

입수 액션은 플레이어에게 이익이 되는 처리를 나타내는 액션입니다.
아이템 입수, 통화 입수, 경험치 입수, 퀘스트 시작 처리 등이 여기에 해당합니다.

GS2 의 트랜잭션은 여러 개의 검증 액션·여러 개의 소비 액션·여러 개의 입수 액션을 조합한 구조로 발행됩니다.
트랜잭션은 GS2-Showcase / GS2-Quest / GS2-Mission 등 각 마이크로서비스의 트랜잭션 발행 API 응답으로 받으며, 게임 클라이언트는 취득한 트랜잭션을 GS2-Distributor 를 통해 실행합니다.

또한 GS2 SDK 에는 트랜잭션 실행을 자동화하는 구조가 내장되어 있어, 대부분의 경우 게임 측에서 트랜잭션을 의식적으로 실행할 필요는 없습니다.
발행 API 결과에 포함된 TransactionDomain 의 WaitAsync 를 호출하는 것만으로, 소비 액션·입수 액션이 올바른 순서로 실행되어 결과를 취득할 수 있습니다.