게임 아이디어와 기능

다음에 추가할 기능

기프트 코드

플레이어가 선물 코드를 입력하고 교환하게 하세요.

플레이어 세션 필요
Unity
기프트 코드 일러스트
확인할 수 있는 결과

테스트 코드가 교환됩니다. 재교환은 설정한 규칙을 따릅니다.

기프트 코드 만들기1:42

이 동영상은 영어로 재생됩니다.

동영상 별도로 열기 ↗
동영상 준비 중

이 단계의 동영상은 아직 없습니다. 안내와 MCP 요청은 바로 사용할 수 있습니다.

서버 플레이어 값

같은 프로젝트 준비

  1. 게임 설정과 같은 프로젝트를 대시보드에서 선택하세요.

    기프트 코드 →
  2. 대시보드 양식에서 다음 테스트 항목을 만들거나 기존 항목을 사용하세요. 표시된 값은 현재 프로젝트 데이터가 아닌 예시입니다.

    코드
    WELCOME
    기프트 데이터 (JSON)
    {}
    사용자당 최대 횟수
    1

    교환 시 서버가 설정된 값을 최대 8개 지급합니다. giftData는 별도의 게임 데이터로 유지됩니다. 반환된 잔액을 표시하고 보상을 로컬에서 다시 더하지 마세요.

    플레이어 값 →
  3. 예제를 실행하기 전에 저장하고 다시 불러와 확인하세요. 관련 없는 정의는 유지하세요.

이 기능 구현하기

가이드는 미리 볼 수 있습니다. 실행하려면 활성 프로젝트 키가 필요합니다. 프로젝트 준비

SDK 설치와 프로젝트 설정 가져오기가 완료되고 플레이어가 로그인해야 합니다.

교환 시 서버가 설정된 값을 최대 8개 지급합니다. giftData는 별도의 게임 데이터로 유지됩니다. 반환된 잔액을 표시하고 보상을 로컬에서 다시 더하지 마세요. 이 SDK 예제는 develop을 사용합니다. 필요한 API가 설치된 SDK에 있는지 확인하세요.

C# 파일을 저장하고 GameObject에 연결한 뒤 Play를 시작하세요. Console을 확인하세요.

C#
Assets/Scripts/GiftCodesDemo.cs
horizOn 호출준비
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// 이 스크립트를 첫 씬의 GameObject에 붙이세요.
6public class GiftCodesDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // 준비: 초기화, 연결, 플레이어 로그인.
11 HorizonApp.Initialize();
12 await new HorizonServer().Connect();
13 if (!UserManager.Instance.IsSignedIn)
14 {
15 bool authenticated = UserManager.Instance.HasCachedAnonymousToken()
16 ? await UserManager.Instance.RestoreAnonymousSession()
17 : await UserManager.Instance.SignUpAnonymous("StatisticsPlayer");
18 if (!authenticated) return;
19 }
20​
21 // horizOn: 기프트 코드를 확인하고 사용하기.
22 // Run from one explicit player action; serialize this handler until it completes.
23 string userId = UserManager.Instance.CurrentUser.UserId;
24 string project = HorizonApp.Network.GetApiKey();
25 string scope = PM.horizOn.Cloud.Objects.Network.Responses.GiftCodeIntent.ProjectFingerprint(project);
26 string pendingKey = "horizOn_gift_v2_" + scope + "_" + userId;
27 // Preserve an old V1 demo record for reconciliation. Never reinterpret its UUID as a count.
28 if (PlayerPrefs.HasKey("horizOn_gift_pending_" + userId)) return;
29 PM.horizOn.Cloud.Objects.Network.Responses.GiftCodeIntent pending;
30 if (PlayerPrefs.HasKey(pendingKey)) {
31 pending = JsonUtility.FromJson<PM.horizOn.Cloud.Objects.Network.Responses.GiftCodeIntent>(PlayerPrefs.GetString(pendingKey));
32 if (pending == null || !pending.IsValidFor(project, userId)) return;
33 } else {
34 pending = await GiftCodeManager.Instance.PrepareRedemption("WELCOME");
35 if (pending == null || !pending.IsValidFor(project, userId) || PlayerPrefs.HasKey(pendingKey)) return;
36 PlayerPrefs.SetString(pendingKey, JsonUtility.ToJson(pending));
37 PlayerPrefs.Save(); // All seven fields before the first mutating request.
38 }
39 string original = JsonUtility.ToJson(pending);
40 if (PlayerPrefs.GetString(pendingKey) != original) return;
41 var result = await GiftCodeManager.Instance.RedeemPrepared(pending);
42 if (result == null || !result.success) return; // Keep the exact tuple after any uncertain result.
43 if (PlayerPrefs.GetString(pendingKey) == original) {
44 PlayerPrefs.DeleteKey(pendingKey);
45 PlayerPrefs.Save();
46 }
47 if (result.playerValues != null) {
48 foreach (var value in result.playerValues.values) Debug.Log(value.key + "=" + value.balance);
49 }
50 // alreadyApplied/replayed means the sequence slot was consumed, with no copied historical rewards.
51 // Replace balances with playerValues. Never add grantedValues locally.
52 }
53}
전체 SDK 예제 열기 ↗

새 기능을 테스트하세요.

테스트 코드가 교환됩니다. 재교환은 설정한 규칙을 따릅니다.

게임 설정과 같은 프로젝트를 대시보드에서 선택하세요.

엔드포인트
  • POST/gift-codes/validate
  • POST/gift-codes/redeem
API 레퍼런스의 모든 엔드포인트
리더보드 일러스트
다음 단계에 대한 추천

모든 라운드에 최고 점수를 더하세요.

라운드가 끝나면 점수를 저장하고 선두를 보여주세요. 기존 연결과 플레이어 세션을 계속 사용하세요.