詐騙防範快速入門

本快速入門可讓您開始在 Microsoft Store (Windows 10/11、XBOX、Android) 上執行收據驗證。

​

必要條件

PlayFab Economy v2 快速入門可協助您完成設定，並準備好執行收據驗證。

​

Microsoft Store 市集收據驗證

• GetMicrosoftStoreAccessTokens
• RedeemMicrosoftStoreInventoryItems

若要使用兌換 API，您首先要在所使用的任何市集 (Apple Store、Steam、Google Play 等) 中設定您的產品 ID 和價格。一開始，所有產品都是無實體的，也就是玩家可以購買的數位項目，但在 PlayFab 中沒有任何意義。 為了賦予這些項目意義，我們需要在 PlayFab 目錄中鏡像它們。鏡像會將這些無實體的實體轉換為目錄套件組合。當您在新服務中呼叫 RedeemMicrosoftStoreInventoryItems 時，我們會在目錄中尋找相符的套件組合，以授與至實體玩家的虛擬庫存。 每個套件組合都可以藉由新增 AlternateId，連結至一或多個合作夥伴市集產品。AlternateId 是 PlayFab 與任何外部 IAP 市集之間的連結。當您的遊戲為指定的玩家實體呼叫兌換時，我們會將此 ID 傳遞至 IAP 市集進行檢查。一般流程如下：

1. 在 Microsoft Store 中建立 1 個 (或多個) 真實世界優惠
2. 在 PlayFab 中以 IAP 市集呼叫權限填入附加元件，並在 PlayFab 中建立連結至您所建立優惠的對應套件組合
3. 呼叫 RedeemMicrosoftStoreInventoryItems

​

步驟 1 - 設定您的市集整合

您必須在 GameManager 的 Add-ons 區段下設定每個 IAP 市集整合，以允許 PlayFab 代表遊戲呼叫市集。

​

步驟 2 - 建立用於收據驗證的套件組合

您可以在 GameManager 中或藉由呼叫 CreateDraftItem 來建立套件組合。套件組合至少需要 Title、Description 和 Items。在 GameManager 中，您可以使用 Marketplace Mapping 區段連結市集項目。 如果您使用 API 建置套件組合，則需要在套件組合的 alternateIds 區段下新增您的 IAP 市集對應。市集列舉是特定的且區分大小寫；您必須使用下列其中一個附加元件：

• Apple = “AppleAppStore”
• Google Play = “GooglePlay”
• Nintendo = “NintendoEShop”
• Microsoft = “MicrosoftStore”
• PlayStation = “PlayStationStore”
• Steam = “Steam”

​

步驟 3 - 從您的遊戲呼叫兌換

您的遊戲會使用實體和收據詳細資料呼叫 RedeemMicrosoftStoreInventoryItems API，以「兌換」真實世界優惠並填入對應的實體庫存。您需要在呼叫中提供幾項內容，才能讓它正確運作：

• 要求標頭中的必要項目
  • X-EntityToken - 唯一識別 PlayFab 實體的權杖
  • Content-Type - Application/Json
• 要求本文中的必要項目
  • CollectionsIdKey

每個 IAP 市集發出這些呼叫的需求都略有不同。例如，Apple 和 GooglePlay 購買需要附加市集收據。 當您的遊戲用戶端啟動時，請先為市集發起 PlayFab 兌換呼叫。兌換呼叫可讓 PlayFab 與任何可能在離線時或遊戲範圍之外發生的購買進行同步。每當發生市集優惠的遊戲內購買時，您的遊戲都應該使用這些呼叫。 兌換可確保在呼叫兌換端點之後，玩家實體的庫存貨幣已填入。

​

第 4 部分：購買項目

​

Game Manager

您可以在個別的玩家檢視中確認項目或貨幣是否存在。在 GameManager 中，選取 Players，然後瀏覽至個別的玩家實體。使用 Inventory 索引標籤來檢視及更新該實體玩家擁有的內容。

​

API

在您的遊戲中，以已獲得虛擬貨幣的玩家身分登入。 呼叫 SearchItems 以使用先前發佈的目錄 itemId。 使用目錄項目的 itemId 和所授與的虛擬貨幣 ID 呼叫 PurchaseInventoryItems。 最後，呼叫 GetInventoryItems 並檢視該方法的結果。

---

若要深入了解在 Microsoft 平台上營利，請參閱這裡。