GS2-SDK‎ > ‎GS2 SDK for Unity‎ > ‎

GS2-ConsumableItem

消費型アイテムの管理を GS2 SDK for Unity から利用する手順を解説します。

アイテムプールを作成する

GS2マネージメントコンソールの GS2-ConsumableItem から新しくアイテムプールを作成します。
アイテムプールは複数種類のアイテムの所持数をまとめて管理する単位です。



『アイテムプールの新規作成』をクリックします。



アイテムプールの名前をつけます。
サービスクラスは想定されるアクセス数に応じたサイズを選択します。

続けて、管理したいアイテムを登録します。


「アイテム」タブを選択し、「アイテムの新規作成」を選択します。


アイテムの付与・消費時に指定することになる名前と最大所持数を指定します。

これで、GS2マネージメントコンソールでおこなう準備は完了です。

消費型アイテム処理を実装

ここからは Unity での実装になります。
まずはログイン処理を実装する必要があります。ログインして Gs2.GameSession を取得するまでの手順は GS2-Auth をご参照ください。
ここからはログインが完了している前提で説明を進めます。

所持アイテム一覧を取得

  1. public class GameLogic : MonoBehaviour {
  3. private const string CLIENT_ID = "your client id";
  4. private const string CLIENT_SECRET = "your client secret";
  6. Gs2.Client gs2;
  7. Gs2.GameSession session;
  9. void Start () {
  10. // GS2 Client を初期化
  11. gs2 = new Gs2.Client (new Gs2.Profile ()
  12. .WithClientId (CLIENT_ID)
  13. .WithClientSecret (CLIENT_SECRET));
  15. StartCoroutine (Login ());
  16. }
  18. IEnumerator Login() {
  19. // GS2-Account を利用して認証します
  20. string GAME_NAME = "game-0001";
  21. string KEY_NAME = "account";
  22. string USER_ID = "user";
  23. string PASSWORD = "password";
  24. string authenticationToken = null;
  25. yield return gs2.Account.Authentication (
  26. result => {
  27. if(result.Error != null) throw result.Error;
  28. authenticationToken = result.Result;
  29. },
  30. GAME_NAME,
  31. KEY_NAME,
  32. USER_ID,
  33. PASSWORD);
  34. // GS2-Account の認証情報を利用して GS2 にログインします
  35. yield return gs2.Auth.Login (
  36. result => {
  37. if(result.Error != null) throw result.Error;
  38. session = result.Result;
  39. },
  40. USER_ID,
  41. KEY_NAME,
  42. authenticationToken);
  43. StartCoroutine (GetInventory ());
  44. }
  46. IEnumerator GetInventory() {
  47. // インベントリの内容を取得
  48. yield return gs2.ConsumableItem.GetInventory(
  49. r => {
  50. if(r.Error != null) throw r.Error;
  51. var itemName = r.Result[0].ItemName; // アイテム名
  52. var count = r.Result[0].Count; // 所持数量
  53. },
  54. session,
  55. "itemPool-0001"); // アイテムプール名
  56. }
  58. void Update () {
  60. }
  61. }

アイテムを消費
  1. public class GameLogic : MonoBehaviour {
  3. private const string CLIENT_ID = "your client id";
  4. private const string CLIENT_SECRET = "your client secret";
  6. Gs2.Client gs2;
  7. Gs2.GameSession session;
  9. void Start () {
  10. // GS2 Client を初期化
  11. gs2 = new Gs2.Client (new Gs2.Profile ()
  12. .WithClientId (CLIENT_ID)
  13. .WithClientSecret (CLIENT_SECRET));
  15. StartCoroutine (Login ());
  16. }
  18. IEnumerator Login() {
  19. // GS2-Account を利用して認証します
  20. string GAME_NAME = "game-0001";
  21. string KEY_NAME = "account";
  22. string USER_ID = "user";
  23. string PASSWORD = "password";
  24. string authenticationToken = null;
  25. yield return gs2.Account.Authentication (
  26. result => {
  27. if(result.Error != null) throw result.Error;
  28. authenticationToken = result.Result;
  29. },
  30. GAME_NAME,
  31. KEY_NAME,
  32. USER_ID,
  33. PASSWORD);
  34. // GS2-Account の認証情報を利用して GS2 にログインします
  35. yield return gs2.Auth.Login (
  36. result => {
  37. if(result.Error != null) throw result.Error;
  38. session = result.Result;
  39. },
  40. USER_ID,
  41. KEY_NAME,
  42. authenticationToken);
  43. StartCoroutine (ListMessage ());
  44. }
  46. IEnumerator GetInventory() {
  47. // アイテムを消費
  48. yield return gs2.ConsumableItem.ConsumeItem(
  49.          r => {
  50.                 if(r.Error != null) throw r.Error;
  51.          },
  52.          session,
  53.          "itemPool-0001", // アイテムプール名
  54.          "item-0001", // 消費するアイテム名
  55.          1 // 消費数量
  56.          );
  57. }
  59. void Update () {
  61. }
  62. }

Comments