测试奖励

Play Billing Lab 是一款配套应用，可帮助您测试与 Google Play 结算系统的集成。您可以使用 Play Billing Lab 的应用外购买 (OOAP) 测试功能，验证您的应用和后端是否已正确配置，以便处理在应用外获取的商品，包括 Play 游戏奖励。

借助 OOAP 测试功能，您可以选择 Play 游戏奖励优惠，模拟 Google Play 直接从 Play Billing Lab 向用户发放奖励，并验证端到端使用权获取和履单流程。

前提条件

在使用 Play Billing Lab 测试应用外购买 (OOAP) 流程以验证 Play 游戏奖励 设置之前，请确保您满足以下要求：

1. 已获许可的测试人员状态：您的测试账号必须注册为游戏的已获许可测试人员。如需了解详情，请参阅 Google Play 许可测试人员文档。

   注意：虽然任何用户都可以查看 Play Billing Lab 应用，但只有获得许可的测试人员才能配置和触发 OOAP 替换。

2. 各平台账号一致：您必须使用同一许可测试人员账号登录 Play Billing Lab 和 Google Play 商店。如果账号不匹配，Play 商店可能不会显示被覆盖的测试商品或优惠，也可能无法完成测试购买交易。

下载并安装

您可以从 Google Play 下载并安装 Play Billing Lab 应用。

分步集成和测试指南

以下步骤详细介绍了如何使用 Play Billing Lab 集成和测试 Play 游戏奖励。如需了解有关测试应用外购买交易的一般信息，请参阅测试应用外购买交易。

第 1 步：启动 Play Billing Lab 并登录

安装后首次打开 Play Billing Lab 时：

• 点按使用 Google 账号登录。
• 选择已注册为应用许可测试人员的 Google 账号。
• 登录后，您会看到主信息中心。

Play Billing Lab 信息中心。

第 2 步：前往应用外购买 (OOAP) 测试

• 在信息中心内，找到应用外购买卡片。
• 点按测试以打开 OOAP 配置设置界面。

注意：如果您的账号不是应用的许可测试人员，则此卡片不会显示，并且系统会阻止您发起 OOAP 测试。

第 3 步：指定应用包名称和产品 ID

注意：Play 游戏奖励仅支持一次性商品。

在 OOAP 设置界面中，输入所需的应用标识符：

1. 软件包名称：应用的具体 Android 软件包名称（例如 com.example.app）。
2. 商品类型：使用下拉菜单选择一次性商品（应用内商品）。
3. 商品 ID (SKU)：一次性商品的商品 ID，该商品具有您要测试的 Play 游戏奖励优惠。

指定应用包名称和产品 ID。

第 4 步：选择 Play 游戏奖励优惠

输入软件包名称、商品 ID 和商品类型后，Play Billing Lab 会查询后端并显示该商品的可用优惠列表。

注意：系统只会显示并允许选择当前符合您特定测试人员账号条件的优惠。对于非消耗型商品，您目前不得拥有该商品。对于消耗型商品，您必须先消耗掉所有现有购买交易，然后才能进行测试。

• 选择要测试的 Play 游戏奖励优惠。

  

  选择符合条件的优惠。

第 5 步：启动 OOAP 测试

选择 Play 游戏奖励优惠后，点按开始测试。配置会保存并与 Google Play 后端服务器同步。

激活后，您的信息中心会在应用外购买卡片上显示有效标记，其中会显示已配置的软件包名称、商品 ID (SKU) 和剩余时长。

• 测试窗口：默认情况下，有效的 OOAP 测试配置会保持有效状态 2 小时，然后自动过期。在此时间之后，您必须重新配置测试。

  

  启动 OOAP 测试。

第 6 步：发放奖励并验证是否已成功发放

当 Play 游戏奖励优惠的 OOAP 测试处于有效状态时，您可以直接从 Play Billing Lab 发放奖励，而无需从 Google Play 商店购买：

1. 发放奖励：在 Play Billing Lab 的应用外购买界面上，点击发放奖励，以模拟 Google Play 向用户发放奖励。必须先处理现有奖励，然后才能授予其他奖励。

   

   Play 游戏奖励测试流程。

2. 处理并交付使用权：您的应用应检测应用外购买交易（例如，在游戏启动或进入前台时调用 queryPurchasesAsync），然后将商品交付给相应用户。如需了解完整流程，请参阅处理购买交易。

第 7 步：停止并清除 OOAP 测试

完成测试后：

1. 前往应用外购买页面。
2. 点按清除测试以停止 OOAP 测试并清除 OOAP 测试设置。

清除 OOAP 测试。

修改测试配置

在 OOAP 测试正在运行期间，您无法更改软件包名称、商品 ID、优惠选择，也无法更改 Play 商店国家/地区替换设置。

为此，您需要停止并清除当前的 OOAP 测试。

如何修改商品或优惠

如果您目前正在运行 OOAP 测试，并希望测试其他商品或优惠，请执行以下操作：

1. 打开 Play Billing Lab，然后点按有效的应用外购买交易卡片上的查看。
2. 点按修改，即可修改软件包名称、商品 ID 或测试优惠。
3. 在系统提示时，确认停止测试。测试将停止，所有相关输入都将被清除。
4. 输入新商品或选择新优惠，然后重新开始测试。

修改商品或优惠。

如何使用国家/地区覆盖设置测试地区配置

借助 Play Billing Lab，您可以替换 Google Play 商店国家/地区，以测试不同地区的优惠资格条件。如果您未选择国家/地区，Play Billing Lab 会使用您的许可测试账号的 Play 国家/地区。国家/地区变更必须与 OOAP 测试同步：

1. 停止正在进行的 OOAP 测试：如果您在 OOAP 测试进行期间尝试通过信息中心或“应用外购买”页面修改国家/地区替换设置，Play Billing Lab 会显示警告，提示您先停止测试。点按停止测试进行确认，将停止当前的 OOAP 测试并清除测试输入。

2. 设置国家/地区替换：停止 OOAP 测试后，您可以在配置设置页面中修改国家/地区设置（或在应用外购买界面中点按设置国家/地区替换）。选择目标国家/地区（例如日本、英国），然后点按应用。

3. 重新开始 OOAP 测试：国家/地区覆盖设置生效后，返回应用外购买卡片，选择您的商品和优惠，然后点按开始测试。

   您的信息中心现在会同时显示有效的国家/地区替换和有效的 OOAP 测试。

测试具有国家/地区替换设置的区域级配置。

问题排查和常见问题解答

为什么在 Play Billing Lab 中设置商品时，我无法选择或看到任何优惠？

• 优惠资格条件：Play Billing Lab 仅显示您的特定测试人员账号目前有资格获取的优惠。对于非消耗型商品，您目前不得拥有该商品。对于消耗型商品，您必须先消耗掉所有现有购买交易，然后才能进行测试。
• 许可测试人员状态：验证您的账号是否在 Play 管理中心内列为活跃的许可测试人员。

为什么我无法在 Play Billing Lab 中发放其他奖励？

• 未处理的奖励：必须先处理（确认或消耗）现有奖励，然后才能授予其他奖励。打开游戏，验证之前的奖励是否已处理。
• 到期时间：有效的 OOAP 测试会在 2 小时后到期。打开 Play Billing Lab，检查测试标记是否已更改为已过期。如果是，请开始新的测试。

为什么我没有在游戏中收到已发放的奖励？

• 账号一致性：验证登录 Play Billing Lab、Google Play 商店应用和游戏的账号是否为完全相同的许可测试人员账号。
• 应用外购买交易处理：检查游戏的 queryPurchasesAsync 实现和购买交易处理逻辑。由于奖励是在应用的标准界面之外发放的，因此您的游戏或后端服务器必须检测未确认的购买交易并进行处理。

如何在 2 小时计时器到期之前停止或清除正在进行的测试？

• 打开 Play Billing Lab，找到有效卡片（应用外购买或配置设置），然后点按停止或删除（或在应用外购买界面上点按清除测试）。出现提示时，确认您的选择。系统会立即从 Google Play 服务器中移除该替换。