開始使用 Economy v2、Unity 和 Android
Economy v2 現已正式推出。如需支援與意見反應,請前往 PlayFab 論壇。
開始之前
Android Billing API 與 PlayFab 會共同運作,為您的用戶端提供 IAP 體驗:
- 標題
- 描述
- 標籤
- 類型
- 影像
- 行為
設定用戶端應用程式
本節說明如何設定應用程式,以使用 PlayFab、UnityIAP 和 Android Billing API 測試 IAP。 必要條件:- Unity 專案。
- 已匯入並設定為搭配您遊戲使用的 PlayFab Unity SDK。
- 已安裝並設定為搭配您 Unity 專案使用的編輯器,例如 Visual Studio。
- 瀏覽至 Services。
- 確定已選取 Services 索引標籤。
- 選取您的 Unity Services 設定檔或組織。
- 選取 Create 按鈕。

- 接著,瀏覽至 In-App Purchasing (IAP) 服務。

- 請務必設定 Simplify cross-platform IAP 切換開關,以啟用 Service。
- 然後選取 Continue 按鈕。

- 選取 Import 按鈕。

- 確認外掛程式已就緒。
- 然後建立名為 AndroidIAPExample.cs 的新指令碼。

AndroidIAPExample.cs 包含下列程式碼 (如需進一步說明,請參閱程式碼註解)。
- 建立名為 Code 的新 GameObject。
- 將
AndroidIAPExample元件新增至其中 (按一下並拖曳,或)。 - 請務必儲存場景。

- 確認您的場景已新增至 Scenes In Build 區域。
- 確定已選取 Android 平台。
- 移至 Player Settings 區域。
- 指派您的 Package Name。
請務必自行想出_您自己的_套件名稱,以避免任何 PlayMarket 衝突。

為 IAP 設定 PlayMarket 應用程式
本節說明如何為您的 PlayMarket 應用程式啟用 IAP 的詳細資訊。設定應用程式本身不在本教學課程的範圍內。我們假設您_已經有_應用程式,且該應用程式已設定為至少可發佈 Alpha 版本。

- 若要進行到這一步,您必須已上傳 APK。請使用我們在上一節中建構的 APK。
- 將 APK 上傳為 Alpha 或 Beta 應用程式,以啟用 IAP 沙箱。
- 設定內容分級時,會包含有關應用程式中如何啟用 IAP 的問題。
- PlayMarket 不_允許發行者使用或測試 IAP。請挑選_另一個 Google 帳戶用於測試,並將其新增為 Alpha/Beta 組建的測試人員。
- 發佈應用程式組建。
- 從功能表中選取 In-app products。
- 如果系統要求您提供 Merchant Account,請連結或建立一個。
- 選取 Add New Product 按鈕。

- 在新產品畫面上,選取 Managed Product。
- 為其指定描述性的_產品識別碼_,例如
100diamonds。 - 選取 Continue。

- PlayMarket 要求您填寫 Title (1) 和 Description (2),例如
100 Diamonds和A pack of 100 diamonds to spend in-game。Data Item 資料完全來自 PlayFab 服務,只需要識別碼相符即可。
- 繼續向下捲動並選取 Add a price 按鈕。

- 輸入有效的價格,例如 “$0.99” (請注意價格會針對每個國家/地區分別轉換)。
- 選取 Apply 按鈕。

- 最後,捲動回畫面頂端,並將項目的狀態變更為 Active。

- 儲存 Licensing Key 以連結 PlayFab 與 PlayMarket。
- 瀏覽至功能表中的 Services & APIs。
- 然後找到並儲存 Key 的 Base64 版本。

- 瀏覽至 Home。
- 在左側功能表中找到並選取 Account details。
- 找到 License Testing 區域。
- 確認您的 Test Accounts 在清單中。
- 確定 License Test Response 設定為 RESPOND_NORMALLY。

設定 PlayFab 遊戲
我們的最後一個步驟是設定 PlayFab 遊戲以反映我們的產品,並與 Google Billing API 整合。- 選取 Add-ons。
- 然後選取 Google 附加元件。

- 填寫您的 Package ID。
- 填寫您在上一節中取得的 Google App License Key。
- 選取 Install Google 按鈕以認可您的變更。
Game Manager
- 建立新的 Economy Catalog (V2) 貨幣。
- 編輯 Title 並新增 Description,例如
Diamonds、Our in-game currency of choice.。 - 新增 Friendly ID 以便更容易找到您的貨幣,例如
diamonds。 - 選取 Save and publish 以完成變更。
- 在 Currency 清單中查看您的貨幣。
- 接著,建立新的 Economy Catalog (V2) 組合。
- 編輯 Title 並新增 Description,例如
100 Diamonds Bundle、A pack of 100 diamonds to spend in-game.。
請記住,此資料與 Play Market Item Title 和 Description 毫無關係,兩者是獨立的。
- 您可以使用內容類型來組織您的組合,例如
appstorebundles。內容類型是在 ⚙️ > Title Settings > Economy (V2) 中管理。 - 將當地語系化的價格新增至 Display properties,以追蹤真實世界的價格。
- 將新項目新增至組合。在篩選條件中選取 Currencies,然後選擇您在上一個步驟中建立的貨幣。將 Quantity 設定為您想要在此組合中販售的貨幣數量。
- 為 “GooglePlay” 市集新增平台。如果您還沒有 GooglePlay 市集,可以在 Economy Settings 頁面中建立。將 Marketplace ID 設定為與您在上一節中建立的 Google Play Console 產品識別碼相符。
- 選取 Save and publish 以完成變更。
- 在 Bundles 清單中查看您的組合。
REST API
接著,我們可以透過代表遊戲內 NPC 商人的 PlayFab 商店,設定讓玩家花費貨幣的遊戲內購買:
Game Manager
- 建立新的 Economy Catalog (V2) 項目。
- 編輯 Title 並新增 Description,例如 “Golden Sword”、“A sword made of gold.”。
- 您可以新增當地語系化的關鍵字,協助玩家在商店中找到您的項目。新增標籤和內容類型,以協助您組織項目,以便日後透過 API 擷取。使用 Display Properties 來儲存遊戲資料,例如護甲值、美術資產的相對路徑,或您的遊戲需要儲存的任何其他資料。
- 新增價格,並選取您在上一個步驟中建立的貨幣。將 Amount 設定為您想要的預設價格。您之後可以在您建立的任何商店中覆寫價格。
- 選取 Save and publish 以完成變更。
- 在 Items 清單中查看您的項目。
- 最後,建立新的 Economy Catalog (V2) 商店。
- 編輯 Title 並新增 Description,例如
Villager Store、A humble store run by a humble villager.。 - 為其指定 Friendly ID 以便於擷取,例如
villagerstore。 - 將您在上一個步驟中建立的項目新增至商店。您可以將多個項目新增至商店,並視需要覆寫任何預設價格。
- 選取 Save and publish 以完成變更。
- 在 Stores 清單中查看您的商店。
REST API
我們已完成 PlayFab 遊戲的設定。
測試
為了進行測試,請使用 Alpha/Beta 版本下載應用程式。- 請務必使用測試帳戶和實體 Android 裝置。
- 啟動應用程式後,您應該會看到 IAP 已初始化,以及代表您項目的_一個按鈕_。
- 選取該按鈕。


後續步驟
- 建置用於購買的 Unity UI Toolkit 介面,以取代示範用的 IMGUI 顯示。
- 建立自訂 Unity Logger 來處理 PlayFab 錯誤,並向使用者顯示這些錯誤。
- 將圖示影像新增至您的 PlayFab 項目 Images 欄位,以在 Unity UI 中顯示。
