Documentation Index
Fetch the complete documentation index at: https://docs.hyperx.dev/llms.txt
Use this file to discover all available pages before exploring further.
경제와 설정 기능은 운영자가 Console에서 값을 게시하고, Unity 클라이언트가 게시된 값을 읽거나 서버 검증을 요청하는 방식으로 동작합니다.
게임 설정
게임 설정은 밸런스 값, 기능 플래그, 시즌 설정처럼 클라이언트가 읽어야 하는 JSON 설정입니다.
var balance = await HyperX.Core.GameConfigs.Get("balance");
int maxLevel = (int)balance.Data["max_level"];
var season = await HyperX.Core.GameConfigs.Get("season", "v2");
확률표
확률표는 아이템 키, 가중치, 선택적 payload를 가진 항목으로 구성됩니다. Console에서 저장할 때 가중치와 형식을 검증하고, 게시된 버전만 SDK에서 사용할 수 있습니다.
var table = await HyperX.Core.Probability.Get("starter_box");
var draw = await HyperX.Core.Probability.Draw(
tableKey: "starter_box",
accessToken: session.AccessToken,
seed: "tutorial-reward"
);
Debug.Log(draw.ItemKey);
seed를 전달하면 같은 유저, 같은 게시 버전, 같은 seed에 대해 같은 결과를 얻습니다. 보상 지급은 게임의 지급 정책에 맞게 처리하세요.
인앱 결제 검증
스토어 결제가 완료되면 클라이언트는 HyperX에 영수증 정보를 전달합니다. HyperX는 Console에 등록된 스토어 자격증명으로 provider API를 호출하고 성공한 구매만 저장합니다.
var purchase = await HyperX.Core.Purchases.ValidateJson(
provider: "google_play",
productId: "gold_pack_100",
transactionId: "GPA.1234-5678-9012-34567",
accessToken: session.AccessToken,
receiptJson: "{\"purchase_token\":\"STORE_PURCHASE_TOKEN\",\"app_identifier\":\"com.example.game\"}",
rewardJson: "{\"gold\":100}"
);
google_play, app_store, one_store입니다.
| Provider | 필요한 receipt 값 |
|---|
google_play | purchase_token 또는 token, app_identifier |
app_store | StoreKit transaction ID를 transactionId로 전달, app_identifier |
one_store | purchase_token 또는 token, app_identifier |
provider + transaction_id 조합은 중복 호출해도 같은 구매 기록을 반환합니다. 결제 성공 후 보상 지급은 서버 구매 이력과 게임 정책을 기준으로 처리하세요.
구매 이력과 환불
var history = await HyperX.Core.Purchases.History(session.AccessToken, limit: 20);
