次の方法で共有

不正行為防止のクイックスタート

  • [アーティクル]

Important

エコノミー v2 が一般提供になりました。 サポートとフィードバックについては、PlayFab フォーラムにアクセスしてください。

このクイックスタートでは、Microsoft ストア (Windows 10/11、Xbox、Android) でのレシート検証を実行できるようになります。

前提条件

PlayFab Economy v2 クイックスタートを使用すると、受信確認をセットアップして実行できるようになります。

Microsoft Store Marketplace のレシートの検証

Redeem API を使用するには、使用しているマーケットプレイス (Apple Store、Steam、Google Play など) で製品 ID と価格を設定することから始めます。 最初は、すべての製品に顔がありません (プレイヤーが購入できるデジタル エントリ) が、PlayFab では意味がありません。

これらのエントリに意味を与えるには、それらを PlayFab カタログにミラーリングする必要があります。 それらをミラーリングすると、顔のないエンティティがカタログ バンドルに変わります。 新しいサービスで RedeemMicrosoftStoreInventoryItems を呼び出すと、エンティティ プレーヤーの仮想インベントリに付与するために一致するバンドルがカタログ内で検索されます。

各バンドルは、AlternateId を追加することで 1 つ以上のパートナー マーケットプレイス製品にリンクできます。 AlternateId は、PlayFab と外部 IAP マーケットの間のリンクです。 タイトルが特定のプレーヤー エンティティに対して Redeem を呼び出すと、この ID を IAP マーケットに渡して確認します。 一般的な流れは次のとおりです。

  1. Microsoft Store で 1 つ (または複数) の現実世界のオファーを作成する
  2. PlayFab のアドオンに IAP マーケット呼び出し権限を設定し、作成したオファーにリンクする対応するバンドルを Playfab で作成します。
  3. RedeemMicrosoftStoreInventoryItems を呼び出す

注意

Playfab の以前のバージョンとは異なり、新しいシステムではバンドル オファーを 1 つ作成するだけで、参照する必要がある各マーケット SKU を AlternateId リストに追加します。 IAP マーケットごとに新しいアイテムを作成する必要はありません。

ステップ 1 - マーケットプレイス統合のセットアップ

PlayFab がタイトルに代わってマーケットを呼び出せるようにするには、GameManager の [アドオン] セクションで各 IAP マーケット統合を設定する必要があります。

ステップ 2 - 受領書検証用のバンドルの作成

GameManager 内で、または CreateDraftItem を呼び出して、バンドルを作成できます。 バンドルには少なくともタイトル、説明、アイテムが必要です。 GameManager では、Marketplace マッピング セクションを使用して Marketplace エントリをリンクできます。

API を使用してバンドルを構築している場合は、バンドルの alterIds セクションに IAP マーケットプレイス マッピングを追加する必要があります。 マーケットプレイスの列挙型は固有であり、大文字と小文字が区別されます。 次のアドオンのいずれかを使用する必要があります。

  • Apple = "AppleAppStore"
  • Google Play = "GooglePlay"
  • 任天堂 ＝ "NintendoEShop"
  • マイクロソフト = "MicrosoftStore"
  • プレイステーション＝ "PlayStationStore"
  • Steam = "Steam"

ステップ 3 - ゲームから Redeem を呼び出す

ゲームは、エンティティと領収書の詳細を指定して RedeemMicrosoftStoreInventoryItems API を呼び出し、現実世界のオファーを「引き換え」、対応するエンティティ インベントリにデータを入力します。 正しく機能させるには、呼び出しでいくつかのことを指定する必要があります。

  • リクエストのヘッダーに必須
    • X-EntityToken - PlayFab エンティティを一意に識別するトークン
    • コンテンツタイプ - アプリケーション/Json
  • リクエストの本文で必須
    • CollectionsIdKey

各 IAP マーケットには、これらの呼び出しを行うための要件が若干異なります。 たとえば、Apple や GooglePlay で購入した場合は、マーケットプレイスのレシートを添付する必要があります。

ゲーム クライアントが起動したら、まずマーケットプレイスに対して PlayFab Redeem 呼び出しを開始します。 Redeem 呼び出しにより、PlayFab はオフラインまたはゲームの範囲外で発生した潜在的な購入と同期できるようになります。 マーケットプレイス オファーのゲーム内購入が発生するたびに、ゲームはこれらの呼び出しを使用する必要があります。

Redeem では、Redeem エンドポイントが呼び出された後にプレーヤー エンティティのインベントリ通貨が確実に設定されます。

パート 4: アイテムの購入

アイテムまたは通貨が個々のプレーヤー ビュー内に存在することを確認できます。 GameManager で、[プレーヤー] を選択し、個々のプレーヤー エンティティに移動します。 [インベントリ] タブを使用して、エンティティ プレーヤーが所有するものを表示および更新します。

Microsoft プラットフォームでの収益化の詳細については、こちらをご覧ください。