跳轉到主要內容

開始使用 PlayFab (舊版 Economy)、Unity IAP 和 Android

Economy v1 API 處於維護模式,不會再推出任何新功能,只會修正錯誤。**v1 API 在可預見的未來仍會持續維護。**請參閱 Economy v2 概觀,深入了解下一版的 PlayFab Economy!
本教學課程說明如何使用 PlayFab、Unity + IAP 服務和 Android Billing API 設定應用程式內購買 (IAP)。

開始之前

設定 IAP 可能很繁瑣,尤其是當您不確定不同的服務應該如何整合和協同運作時。 下圖說明 Android Billing API 和 PlayFab 如何共同運作,為您的用戶端提供穩固的 IAP 體驗。 Android Billing - PlayFab - 整合時間軸 首先透過 PlayMarket 設定您的 Product IDs 和 Prices。一開始,所有產品都是沒有外觀的,它們是玩家能夠購買的數位實體,但對 PlayFab 玩家而言沒有任何意義。 為了讓這些實體發揮作用,我們需要在 PlayFab 物品目錄中鏡像它們。這會將沒有外觀的實體轉換為組合包、容器和個別物品。 每個實體都有自己獨特的外觀,包括:
  • 標題
  • 描述
  • 標籤
  • 類型
  • 影像
  • 行為
這些全都透過共用 ID 連結至市集產品。 存取可供購買之真實金錢物品的最佳方式,是使用 GetCatalogItems 和 GetStoreItems。這些是免費貨幣商店所使用的相同 API 方法,因此您應該會對此流程感到熟悉。 物品的 ID 是 PlayFab 與任何外部 IAP 系統之間的連結。因此我們會將物品 ID 傳遞給 IAP 服務。 此時,購買流程隨即開始。玩家會與 IAP 介面互動,如果購買成功,您就會取得收據。 接著 PlayFab 能夠驗證收據並登錄購買,將玩家剛購買的物品授與該 PlayFab 玩家。 這是 IAP 整合運作方式的大致概念,下列範例會實際示範大部分內容。

設定用戶端應用程式

本節說明如何設定一個非常簡單的應用程式,以使用 PlayFab、UnityIAP 和 Android Billing API 測試 IAP。 必要條件:
  • Unity 專案。
  • 已匯入 PlayFab SDK,並設定為可搭配您的遊戲運作。
我們的第一步是設定 UnityIAP:
  1. 瀏覽至 Services。
  2. 確定已選取 Services 索引標籤。
  3. 選取您的 Unity Services 設定檔或組織。
  4. 選取 Create 按鈕。
設定 UnityIAP 服務
  1. 接下來,瀏覽至 In-App Purchasing (IAP) 服務。
瀏覽至 UnityIAP 服務
  1. 請務必透過設定 Simplify cross-platform IAP 切換開關來啟用 Service。
  2. 然後選取 Continue 按鈕。
啟用 UnityIAP 服務 隨即會出現包含外掛程式清單的頁面。
  1. 選取 Import 按鈕。
UnityIAP 服務 - 匯入外掛程式 繼續進行 Unity 安裝和匯入程序,直到匯入所有外掛程式為止。
  1. 確認外掛程式已就緒。
  2. 然後建立名為 AndroidIAPExample.cs 的新指令碼。
UnityIAP 建立新指令碼 AndroidIAPExample.cs 將包含下方所示的程式碼 (如需進一步說明,請參閱程式碼註解)。
  1. 建立名為 Code 的新 Game 物件。
  2. 將 AndroidIAPExample 元件新增至該物件 (2 步驟程序)。
  3. 將 AndroidIAPExample 元件新增至該物件。
  4. 請務必 Save 場景。
UnityIAP 建立範例遊戲物件 最後,瀏覽至 Build Settings。
  1. 確認您的場景已新增至 Scenes In Build 區域。
  2. 確定已選取 Android 平台。
  3. 移至 Player Settings 區域。
  4. 指派您的 Package Name。
請務必想出您自己的套件名稱,以避免任何 PlayMarket 衝突。
UnityIAP 新增範例遊戲物件 最後,照常建置應用程式,並確保您已妥善取得 APK。 我們目前還沒有辦法測試它。我們需要先設定 PlayMarket 和 PlayFab,下列各節將說明相關內容。

為 IAP 設定 PlayMarket 應用程式

本節說明如何為您的 PlayMarket 應用程式啟用 IAP 的具體細節。
設定應用程式本身超出本教學課程的範圍。我們假設您已經有應用程式,且已設定為至少可發佈 Alpha 版本。
啟用 PlayMarket 應用程式 實用注意事項:
  • 若要進行到這個步驟,您需要已上傳 APK。請使用我們在上一節中建構的 APK。
  • 當系統要求您上傳 APK 時,您可以將其上傳為 Alpha 或 Beta 應用程式,以啟用 IAP 沙箱。
  • 設定 Content Rating 時會包含應用程式中如何啟用 IAP 的相關問題。
  • PlayMarket 不允許發行者使用或測試 IAP,因此請挑選另一個 Google 帳戶用於測試,並將其新增為 Alpha/Beta 組建的測試人員。
發佈應用程式組建之後:
  1. 從功能表選取 In-app products。
    • 如果系統要求您提供 Merchant Account,請連結或建立一個帳戶。
  2. 選取 Add New Product 按鈕。
PlayMarket 新增產品
  1. 在下方顯示的畫面上,選取 Managed Product。
  2. 為其指定描述性的 Product ID。
  3. 選取 Continue。
PlayMarket 新增產品 ID PlayMarket 會要求您填寫 Title (1) 和 Description (2)。不過,這些在我們的案例中沒有太大用處。 我們只會從 PlayFab 服務擷取 Data Item 資料,而且只需要 ID 相符即可。 PlayMarket 新增產品標題描述
  1. 進一步捲動並選取 Add a price 按鈕。
PlayMarket 新增產品價格
  1. 輸入有效的價格 (請注意價格會針對每個國家/地區分別轉換)。
  2. 選取 Apply 按鈕。
PlayMarket 新增產品套用當地價格
  1. 最後,捲動回畫面頂端,並將物品的狀態變更為 Active。
PlayMarket 將產品設為作用中 雖然這樣就完成了應用程式的設定,但我們還需要進行一些調整。首先,讓我們儲存 Licensing Key (這在連結 PlayFab 與 PlayMarket 時會派上用場。
  1. 瀏覽至功能表中的 Services & APIs。
  2. 然後找出並儲存 Key 的 Base64 版本。
PlayMarket 儲存產品授權金鑰 下一步是啟用 IAP 測試。雖然 Alpha 和 Beta 組建會自動啟用沙箱,但我們需要設定獲授權測試應用程式的帳戶:
  1. 瀏覽至 Home。
  2. 在左側功能表中找出並選取 Account details。
  3. 找出 License Testing 區域。
  4. 確認您的 Test Accounts 位於清單中。
  5. 確定 License Test Response 已設定為 RESPOND_NORMALLY。
別忘了套用設定! PlayMarket 啟用 IAP 測試 此時應該已完成整合中 Play Market 端的設定。

設定 PlayFab 遊戲

我們的最後一步是設定 PlayFab 遊戲以反映我們的產品,並與 Google Billing API 整合。
  1. 選取 Add-ons。
  2. 然後選取 Google 附加元件。
PlayFab 開啟 Google 附加元件
  1. 填寫您的 Package ID。
  2. 填寫您在上一節中取得的 Google App License Key。
  3. 選取 Install Google 按鈕以認可您的變更。
PlayFab 安裝 Google 附加元件 我們的下一步是在 PlayFab 中反映我們的 Golden Sword 物品:
  1. 選取 Economy。
  2. 確認已選取 Catalogs 子索引標籤。
  3. 選取 New Catalog。
  4. 提供 Catalog version 名稱。
  5. 選取 Save Catalog。
PlayFab 儲存目錄 如果目錄中沒有物品,就會自動移除。這就是為什麼任何新目錄都會附帶一個名為 One 的預先新增物品。 我們隨時都可以建立新物品,但為了保持整潔,讓我們修改現有的 One 物品。
  1. 選取物品以編輯 Item ID,使其與 PlayMarket 中的 ID 相符。
  2. 現在,編輯 Display name 並新增 Description。
請記住,此資料與 Play Market Item Title 和 Description 毫無關係,兩者完全獨立。
  1. 為您的 Item 指派 Price。
  2. 選取 Save Item 以認可您的變更。
PlayFab 編輯並儲存目錄物品
在本教學課程中,IAP 主要是指以真實金錢進行的購買。這就是我們使用 RM (特殊的真實金錢貨幣) 的原因。PlayFab 金額是以美分定義。
  1. 在 Item ID 清單中查看您的物品。
PlayFab 目錄物品清單 這樣就完成了 PlayFab 遊戲的設定。

測試

為了進行測試,請使用 Alpha/Beta 版本下載應用程式。
  • 請務必使用測試帳戶和實體 Android 裝置。
  • 啟動應用程式後,您應該會看到 IAP 已初始化,以及代表您物品的一個按鈕。
  • 選取該按鈕。
測試應用程式 - 購買 Golden Sword 按鈕 IAP 購買隨即開始。依照 Google Play 指示操作,直到購買成功為止。 測試應用程式 - Google Play - 付款成功 最後,在 PlayFab Game Manager 儀表板中瀏覽至您的遊戲,並找出 New Events。 Game Manager 儀表板新事件 這表示購買已成功提供、驗證,並傳送至 PlayFab 生態系統。 此時,您已成功將 UnityIAP 和 Android Billing API 整合到您的 PlayFab 應用程式中。
最後修改於 2026年10月6日