PlayFab(旧版 Economy)、Unity IAP 和 Android 入门
Economy v1 API 处于维护模式,不会接收任何新功能,只有 bug 修复。**v1 API 在可预见的将来将持续维护。**参见 Economy v2 概览,了解有关 PlayFab Economy 下一版本的更多信息!
开始之前
设置 IAP 可能很繁琐,尤其是当你不确定不同的服务应如何集成和协作时。 下图展示了 Android Billing API 和 PlayFab 如何协同工作,为你的客户端提供稳定的 IAP 体验。 首先通过 PlayMarket 设置你的 Product IDs 和 Prices。最初,所有产品都是无标识的——它们是玩家能够购买的数字实体——但对于 PlayFab 玩家来说没有意义。 为了让这些实体有用,我们需要在 PlayFab 物品目录中镜像它们。这会把无标识的实体变成捆绑包、容器和单个物品。 每个都有自己独特的标识,包括:- Titles
- Descriptions
- Tags
- Types
- Images
- Behaviors
设置客户端应用程序
本节向你展示如何配置一个非常初级的应用程序,使用 PlayFab、UnityIAP 和 Android Billing API 测试 IAP。 先决条件:- 一个 Unity 项目。
- 已导入并配置为可与你的游戏协同工作的 PlayFab SDK。
- 导航到 Services。
- 确保选中 Services 选项卡。
- 选择你的 Unity Services 配置文件或组织。
- 选择 Create 按钮。
- 接下来,导航到 In-App Purchasing (IAP) 服务。
- 通过设置 Simplify cross-platform IAP 开关,确保启用服务。
- 然后选择 Continue 按钮。
- 选择 Import 按钮。
- 验证插件已就绪。
- 然后创建一个名为 AndroidIAPExample.cs 的新脚本。
AndroidIAPExample.cs 将包含以下所示的代码(请参阅代码注释以获得进一步的解释)。
- 创建一个名为 Code 的新 Game 对象。
- 向其添加
AndroidIAPExample组件(2 步过程)。 - 向其添加
AndroidIAPExample组件。 - 确保保存场景。
- 验证你的场景已添加到 Scenes In Build 区域。
- 确保已选择 Android 平台。
- 移动到 Player Settings 区域。
- 分配你的 Package Name。
确保设定你自己的包名以避免任何 PlayMarket 冲突。
为 IAP 设置 PlayMarket 应用程序
本节介绍如何为你的 PlayMarket 应用程序启用 IAP 的具体细节。设置应用程序本身超出了本教程的范围。我们假设你已经拥有一个应用程序,并且已配置为至少发布 Alpha 版本。
- 达到该点将需要你上传一个 APK。请使用我们在上一节中构建的 APK。
- 当要求你上传 APK 时,你可以将其作为 Alpha 或 Beta 应用程序上传,以启用 IAP 沙盒。
- 配置 Content Rating 将包括有关如何在应用程序中启用 IAP 的问题。
- PlayMarket 不允许发布者使用或测试 IAP——所以请为测试目的选择另一个 Google 帐户,并将其添加为你的 Alpha/Beta 版本的测试者。
- 从菜单中选择 In-app products。
- 如果要求你提供 Merchant Account,请关联或创建一个。
- 选择 Add New Product 按钮。
- 在下面显示的此屏幕上,选择 Managed Product。
- 给它一个描述性的 Product ID。
- 选择 Continue。
- 进一步滚动并选择 Add a price 按钮。
- 输入一个有效价格(注意每个国家/地区如何单独换算价格)。
- 选择 Apply 按钮。
- 最后,滚动回屏幕顶部,将物品的状态更改为 Active。
- 在菜单中导航到 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 按钮提交更改。
- 选择 Economy。
- 验证已选中 Catalogs 子选项卡。
- 选择 New Catalog。
- 提供一个 Catalog version 名称。
- 选择 Save Catalog。
- 选择该物品以编辑 Item ID,使其与 PlayMarket 中的 ID 匹配。
- 现在,编辑 Display name 并添加 Description。
请记住,此数据与 Play Market Item Title 和 Description 毫无关系——它完全独立。
- 为你的 Item 分配一个 Price。
- 选择 Save Item 以提交更改。
在本教程中,IAP 主要指用真实货币的购买。这就是为什么我们使用 RM - 特殊的真实货币。PlayFab 金额以美分定义。
- 观察 Item ID 列表中的物品。
测试
出于测试目的,使用 Alpha/Beta 版本下载应用程序。- 确保使用测试帐户和真实的 Android 设备。
- 一旦启动应用程序,你应该会看到 IAP 已初始化,并且一个按钮代表你的物品。
- 选择该按钮。
