パート 2 - Game Manager の使用

コーディングを開始する前に、Game Manager を理解し、いくつかのセットアップを行う必要があります。

前提条件

パート 1 - 環境のセットアップ
PlayFab 開発者アカウント。無料で登録できます。

ステップ 1 - スタジオを作成する

サインイン (またはサインアップ) が成功したら、新しい Game Studio を作成できるようになります。これを行うには、Game Manager にログインするとすぐに New Studio ボタンが表示されます。クリックすると、スタジオに名前を付けるように求められます。好きな名前を付けることができます。この例では “New Game Studio” と名付けました。 スタジオ が作成されると、My Studios and Titles 画面に、または Game Manager に移動してログインすることで表示されるようになります。

ステップ 2 - タイトルを作成する

新しいタイトルを作成するには、次の手順に従います。

Game Manager の My Studios and Titles で、Upgrade account button の右側にある 3 つのドットを探し (ログインしたアカウントに既にプランが購入されてリンクされている場合は、3 つのドットのみが表示されます)、それを選択します。
選択すると、さまざまなオプションのメニューが開きます。New title を選択します。

タイトルの情報 (名前、Web サイト URL、既に持っている場合はゲームロゴなど) を入力します。ない場合でも心配は要りません。後で追加できます。

Create title を選択します。
作成されると、以前に作成したスタジオの下にタイトルが表示されます。‘カード’ として表示され、そこにはタイトルのロゴ、名前、プラン、ID と、他のタイトル設定にアクセスできる歯車 ⚙️ アイコンとして表示されるボタンがあります。

ステップ 3 - タイトル ID と Secret Key を取得する

スタジオとタイトルの両方が作成されたので、Title ID と Developer Secret Key を取得します。これらは両方ともコーディングを開始する際に使用され、開発環境内で認証と取引が実行される特定のタイトルを指すリンクポイントとして機能します。 Title ID を取得する最も簡単な方法は、スタジオ画面でタイトルを見るだけです。タイトルに対応するカードで、そのカードの右下に “ID” タグとそれに続く 5 文字の英数字コードが表示されます。これが ID です。 Developer Secret Key の取得に進みます。

Game Manager にサインインします。
スタジオ画面でタイトルカードを選択します。これにより、タイトルの概要ページが開きます。
左上隅で、タイトル名の横にある歯車アイコン ⚙️ を選択します。
Title settings オプションを選択します。

画面の上部にある Secret Keys ナビゲーションバーオプションを選択します。

Default Key という名前のキーが自動生成されているのがわかります。これが Developer Secret Key で、このチュートリアルの次のパートでコーディング環境の設定をセットアップする際に使用します。

ここまで来ておめでとうございます。スタジオとタイトルのセットアップと適切な構成、および Title ID と Developer Secret Key を手元に (または少なくとも必要に応じてどこで取得できるかを) 持っているはずです。

ステップ 4 - 最初のアイテムを作成する

作成しているのはクラフトゲームなので、プレイヤーが開始するとすぐにアイテムが利用可能になるように (そしてコーディングを開始できるように)、Game Manager でアイテムを作成する必要があります。

Game Manager

Game Manager にサインインします。
My Studios and Titles ページに移動し、ゲームタイトルを選択してダッシュボードを表示します。
左側のナビゲーションメニューから Engage > Economy を選択します。

Economy ページで、Items タブを選択してから New Item を選択します。Currency、UGC、Bundles、Stores などの他のタブもあります。

選択すると、新しいアイテムに追加したい詳細を入力するように求められるフォームにリダイレクトされます。この画面では、Prices、Files、Images、アイテムが利用可能になる Platforms など、アイテムのいくつかのプロパティを設定することもできます。

すべての必須情報とアイテムに追加したい追加情報を入力したら、New Item 画面の下部で続行するために 2 つの異なるオプションが表示されます: 1. Save as draft: これは下書きアイテムを作成し、ゲームでは利用できません (検索や購入などでも表示されません)。2. Save and publish: これはアイテムをゲームに直接保存および公開します。つまり、検索可能で、アクティブで、購入可能になります。

変更を保存すると、選択に応じてアイテムは下書き状態または公開状態のいずれかになります。

API

PlayFab の API を使用してアイテムを作成するには、catalog/createDraftitem の下の CreateDraftItem 呼び出しを使用する必要があります。これは他のアイテム作成の例と同様に機能しますが、わずかな違いは、デフォルトで、特に指定しない限り作成されたアイテムは下書きアイテムになることです。 Publish ブール値があり、true の場合、アイテムは下書きとして保存されずに直接公開されます。以下の JSON は、CreateDraftItem リクエスト本文の例です。すべてのフィールドが必須ではないので、必要/好みに合わせてその JSON を自由にトリミングしてください。詳細については、CreateDraftItem を参照してください。

{
  "Item": {
    "Type": "ugc",
    "Title": {
      "NEUTRAL": "Neutral title",
      "en-US": "US English title"
    },
    "Description": {
      "NEUTRAL": "Neutral description",
      "en-US": "US English description"
    },
    "Keywords": {
      "NEUTRAL": {
        "Values": [
          "Keyword_1",
          "Keyword_2"
        ]
      }
    },
    "ContentType": "example item",
    "CreatorEntity": {
      "Id": "someId",
      "Type": "title_player_account",
      "TypeString": "title_player_account"
    },
    "IsHidden": false,
    "Tags": [
      "pirates",
      "holiday"
    ],
    "DisplayVersion": "1.0.0",
    "CreationDate": "2018-08-17T22:32:10.472Z",
    "Contents": [
      {
        "Id": "00000000-0000-0000-0000-000000000001",
        "Url": "https://endpoint.blob.core.windows.net/some-identifier-private/00000000-0000-0000-0000-000000000001/textures.zip",
        "MaxClientVersion": "2.4.1",
        "MinClientVersion": "2.0.0"
      }
    ],
    "Images": [
      {
        "Id": "00000000-0000-0000-0000-000000000003",
        "Type": "Thumbnail",
        "Url": "https://endpoint.blob.core.windows.net/some-identifier-private/00000000-0000-0000-0000-000000000003/splashscreen_thumb.jpg"
      }
    ],
    "DisplayProperties": {
      "mapDetails": {
        "mapType": "desertIsland",
        "gameMode": "capture",
        "maxPlayers": 16
      },
      "averageMatchLengthInSeconds": 947
    },
    "DefaultStackId": "Static_Default_Stack_Id"
  },
  "Publish": false
}

アイテム、インベントリ、およびその他の Economy 機能と用語の詳細については、Economy V2 のドキュメントを参照してください。

ステップ 5 - カタログを使用してアイテムを表示および編集する

左側のナビゲーションバーの Engage > Economy に戻ると (ステップ 4 で行ったように)、前述と同じオプション/タブのリストが表示されます。ページは既定で Items タブになっており、そこで Published または Draft でアイテムをフィルターする別のオプションが表示され、選択されたカテゴリのすべてのアイテムが表示されます。すべての Published または Draft アイテムを 1 か所で表示/一覧表示できるようになったので、個別に編集したり、一括で削除したりできます。削除するには、削除したいアイテムを選択して Delete ボタンを押します。アイテムを編集するには、アイテムのタイトルを選択します。これにより、前述の New Item 画面と同じ画面が表示され、アイテム作成時 (または最終更新以降) に追加した可能性のあるすべてのプロパティとカスタムフィールドが表示され、ページの末尾までスクロールして Edit draft item ボタンを選択することでカスタマイズおよび保存できます (Edit draft item ボタンのすぐ隣には、アイテムを削除する別の方法である Delete ボタンもあります)。

ステップ 6 - (ヒント) アイテムを購入で無料にする

このステップはオプションで、アイテムを購入で無料にする推奨方法の 1 つを説明します。使用される方法は、無料にしたいアイテムの数量 0 の価格として使用される新しい “Free Item” を作成することです。

アイテムを無料にする方法は、価格を付けないことだと思うかもしれません。現在のところそうではなく、価格なしでアイテムを作成すると、購入不可 と見なされます。

無料にしたいアイテムの価格として使用できる “Free Item” を作成するには、ステップ 4 で行ったのと同じ手順に従う必要があります。これはただ ‘通常の’ アイテムを作成するのと同じです。そのアイテムに追加するプロパティや値についてあまり深く考える必要はありません。それはゲームでアクティブにするアイテムではなく、その目的は価格として設定されることだけだからです。それに価格を付ける必要もありません。 2 つのアイテムを作成したら (“Free Item” と、無料にしたいアイテム)、無料にしたいアイテムを編集して価格を設定する必要があります。これを行うには、アイテムリストから目的のアイテムを選択し、ステップ 5 で説明したように、その名前を選択してアイテム編集画面に移動します。末尾までスクロールして Edit Mode を有効にすると、“Prices” セクションの下に Add new price ボタンが表示されるようになります。 Add new price をクリックすると、現在のすべてのアイテムのリストが表示されるウィンドウがポップアップし、価格として選択するアイテムを選ぶことができます (“Items”、“UGC Items”、“Currencies” でフィルターすることもでき、特定のテキストで検索することもできます)。この場合、“Free Item” 以外のアイテムはまだ 1 つだけです (既に複数のアイテムを作成していない限り)。 “Free Item” のすぐ隣にある “Add” オプションを選択すると、価格として希望する “Free Item” の数量を選択するよう促されます。この新しいアイテムを無料にするには、この値 (既定は 1) をゼロに変更する必要があります。価格の設定が完了したら、変更を保存および公開する必要があります。これで完了です。このアイテムは無料で購入できるようになりました。C# および直接 API 呼び出しを使用してアイテム (無料のものでも) を購入する方法については、後ほど説明します。

ステップ 7 - FriendlyId を追加する

これは別のオプションのステップで、既存のアイテムを編集して FriendlyId を追加する方法を説明します。この方法により、既定で指定された長い英数字 ID の代わりに、この FriendlyId を使用してアイテムを検索できます。

FriendlyId を追加するには、Economy > Items に移動し、目的のアイテムを選択する必要があります。選択したら、Edit mode を有効にしてアイテムに変更を加えることができるようにします。次のスクリーンショットでは、FriendlyId フィールド (赤で強調表示されている) を確認できます。ここに、アイテムのよりわかりやすい名前や ID を入れることができ、それはその特定のアイテムに即座にリンクされます。

XBOX Services

PlayFab

クラフトゲームパート 2 - Game Manager

パート 2 - Game Manager の使用

前提条件

ステップ 1 - スタジオを作成する

ステップ 2 - タイトルを作成する

ステップ 3 - タイトル ID と Secret Key を取得する

ステップ 4 - 最初のアイテムを作成する

Game Manager

API

ステップ 5 - カタログを使用してアイテムを表示および編集する

ステップ 6 - (ヒント) アイテムを購入で無料にする

ステップ 7 - FriendlyId を追加する

​パート 2 - Game Manager の使用

​前提条件

​ステップ 1 - スタジオを作成する

​ステップ 2 - タイトルを作成する

​ステップ 3 - タイトル ID と Secret Key を取得する

​ステップ 4 - 最初のアイテムを作成する

​Game Manager

​API

​ステップ 5 - カタログを使用してアイテムを表示および編集する

​ステップ 6 - (ヒント) アイテムを購入で無料にする

​ステップ 7 - FriendlyId を追加する

パート 2 - Game Manager の使用

前提条件

ステップ 1 - スタジオを作成する

ステップ 2 - タイトルを作成する

ステップ 3 - タイトル ID と Secret Key を取得する

ステップ 4 - 最初のアイテムを作成する

Game Manager

API

ステップ 5 - カタログを使用してアイテムを表示および編集する

ステップ 6 - (ヒント) アイテムを購入で無料にする

ステップ 7 - FriendlyId を追加する