测试待定购买(中国不支持此功能)
测试待定购买(中国不支持此功能)
可以通过Amazon Kids体验发起待定购买。儿童可以提出购买请求,然后由父母在自己的设备上异步进行审查和批准。有关Amazon Kids的更多信息,请参阅什么是Amazon Kids?帮助文章。
要测试待定购买,请按照本页上的说明操作。待定购买功能仅适用于权利和消费品应用内购买。待定购买不可用于订阅。
有关如何在应用中实现亚马逊应用内购买 (IAP) API其他功能的更多信息,请参阅实现Appstore SDK IAP。有关实现待定购买功能的具体信息,请参阅实现待定购买。
先决条件
要使用本指南,您需要准备好以下事项:
- Fire平板电脑设备
- Android Studio IDE
下载Appstore SDK
可以从SDK下载页面下载Appstore SDK。下载项包括JAR文件、API文档和示例。
实现待定购买
要在您的应用中实现待定购买,请按照实现待定购买中的说明进行操作。然后,返回本页,继续下一部分。
为待定购买设置App Tester
App Tester是一种工具,使您能够在将应用上传到亚马逊应用商店或动态应用测试之前,在本地测试应用内购买流程。本部分介绍如何安装App Tester以及如何使用它来测试待定购买。
要查看详细说明,请单击以下按钮。
安装App Tester
App Tester是能够在Android移动设备上运行的免费应用。从亚马逊应用商店下载App Tester。
重要须知: App Tester仅适用于应用的调试版本。不能对发行版本使用App Tester。如果您使用的是从亚马逊应用商店上的动态应用测试下载的应用版本,请将其卸载并改为安装调试版本。
本节介绍如何设置App Tester。
沙盒模式
运行以下命令以打开沙盒模式。沙盒模式对通常会转到亚马逊应用商店客户端的调用进行路由,以改为前往App Tester客户端。
adb shell setprop debug.amazon.sandboxmode debug
如果您想退出沙盒模式,请使用以下命令。
adb shell setprop debug.amazon.sandboxmode none
上传您的IAP JSON文件
App Tester必须有一个JSON列表,列出您想要测试的应用内购买。您可以使用以下步骤通过开发者控制台自动创建JSON文件:
- 登录开发者控制台并选择您的应用。
- 转到应用的“应用程序内商品”部分,如果您尚未添加商品,请添加商品。
- 选择导出多个IAP > JSON。
- 生成文件后,会显示一个下载链接。下载文件。
- 将已下载的文件命名为
amazon.sdktester.json
。
- 使用以下命令将该文件复制到设备文件系统内的
/sdcard/
文件夹中。
adb push <path to json file>/amazon.sdktester.json /sdcard/amazon.sdktester.json
如果成功完成,您的IAP商品应在App Tester的IAP Items in JSON File(JSON文件中的IAP商品)选项卡下列出,如下图所示。
有关配置App Tester的详细信息,请参阅安装和配置App Tester。
在App Tester中测试待定购买
本部分说明App Tester中的待定购买流程。
申请购买
打开您的应用并选择应用程序内商品以启动购买。如果您的应用中启用了“待定购买”,则显示的对话框中会有一个Request Purchase(请求购买)按钮。
如果点击Request Purchase,将不会立即购买商品。请求会被转发,以进行批准或拒绝。在实际的客户体验中,此请求会发送给家长或监护人。对于此测试,您可以在App Tester中管理请求。
管理购买请求
请求购买后,可以从App Tester的Manage Transactions(管理交易)选项卡中批准或拒绝。
打开App Tester并选择Manage Transactions。待定交易即会显示,并有批准或拒绝请求的选项。
如果选择Approve Request,则会购买应用程序内商品。与其他常规购买的商品一样继续进行IAP流程,并且必须履行该流程。
如果选择Decline Request,则会取消应用内购买。
设置实时集成测试
在应用中实现待定购买并使用App Tester进行本地测试后,您可以开始实时集成测试。
注意: 开始之前,请使用以下命令卸载应用的调试版本和App Tester。
adb uninstall <your debug app package>
adb uninstall com.amazon.sdktestclient
按照以下步骤设置并运行测试。
- 创建一个带有家长和儿童个人资料的亚马逊家庭共享。
- 使用具有待定购买代码的应用版本设置动态应用测试。
- 在Fire平板电脑上的Amazon Kids应用中,将您的应用添加到儿童个人资料中,并启用应用内购买。
- 从儿童体验中发起IAP,以测试待定购买流程。
要查看详细说明,请单击以下按钮。
创建亚马逊账户
如果您没有亚马逊账户,请访问您所在市场的亚马逊网站,如Amazon.com,并创建一个账户。悬停在账户及心愿单上方,然后选择“立即登录”按钮下方的免费注册。
重要须知: 您在测试的Fire平板电脑需要使用此账户进行注册。
添加儿童个人资料
可以通过亚马逊网站或在Fire平板电脑上添加儿童个人资料。
方法1: 从亚马逊网站添加儿童个人资料
- 登录,悬停在账户及心愿单上方,并选择我的账户下方的账户。
- 滚动至购物计划,然后选择亚马逊家庭共享。
- 选择添加一名儿童。最多可添加四个儿童个人资料。
方法2: 从Fire平板电脑添加儿童个人资料。
- 在您的Fire平板电脑上,从家长个人资料中启动Amazon Kids应用。
- 遵照屏幕上的说明添加儿童个人资料。
在添加儿童个人资料之后,如果在设备上启动Amazon Kids应用,就会看到新创建的个人资料。
创建动态应用测试
亚马逊应用商店的动态应用测试(LAT)功能允许您在亚马逊的生产环境中测试您的应用。使用LAT,您可以将应用交付至Fire平板电脑,并测试应用内购买。按照以下步骤设置设备。
- 转到开发者控制台主信息页面,登录您的账户并选择应用。如果您还没有此应用的应用列表,请执行以下步骤:
- 在顶部导航栏中,选择应用与服务>我的应用程序。
- 选择添加新应用 > Android。
- 完成“新应用程序提交”页面,单击保存,然后转到步骤2。
- 从应用名称下方选择动态应用测试。
- 选择Create a new Live App Test(新建动态应用测试)。
- 上传您的二进制文件和待定购买代码更改,并完成表单。有关如何使用LAT的更多详细信息,请参阅动态应用测试入门。完成所有必填字段后,单击提交。
注意: 请确保将测试人员邀请发送到注册到Fire平板电脑的“亚马逊家庭共享”家长账户。
- 您将收到一封电子邮件,表明已邀请您参加动态应用测试。单击亚马逊网站的链接,该链接将转到您的应用的零售网页。或者,您可以通过以下步骤访问应用的网页:
- 转到您所在市场的亚马逊网站(例如Amazon.com)。
- 在顶部导航栏中选择全部。
- 在数字内容和设备下,选择亚马逊应用商店,然后选择您的应用和订阅。
- 找到您的测试应用并选择它以打开其零售网页。
- 您的应用网页将与下图类似。选择将应用交付至您的Fire平板电脑。
测试应用将出现在您的Fire平板电脑的家长个人资料中。
将您的应用添加至儿童个人资料
在您的应用在家长个人资料账户中可用后,您需要将其添加到儿童账户。请按照以下步骤操作。
- 打开Amazon Kids应用。
- 您将看到您的家庭共享中的儿童个人资料列表。点击儿童个人资料旁边的齿轮图标,进入设置屏幕。
- 选择Add Content(添加内容),然后选择Share Content(共享内容)。
- 点击Games & Apps(游戏和应用),然后找到并选择您的应用。
- 点击Done(完成)。
启用应用内购买
现在,您需要为儿童账户启用应用内购买。在儿童设置屏幕上,打开Enable In-App Purchasing(启用应用内购买)选项。
如果禁用此选项,则当您尝试在儿童个人资料中购买权利和消费品时,会看到一条“feature is blocked”(功能被阻止)消息,如下图所示。
按后退箭头返回到儿童个人资料列表。点击儿童个人资料,启动儿童体验。
从儿童个人资料发起购买
启动儿童体验后,找到您的测试应用,点击图标下载该应用。下载并打开应用后,您可以测试权利和消费品购买。
要测试权利和消费品的“待定购买”,请按照以下步骤操作。
测试权利的待定购买
-
选择要从测试应用购买的权利。出现与此处所示类似的对话框。
-
要发起“待定购买”流程,单击Request Purchase。这会致使待定状态被发送到您的应用。您不需要在应用中实现状态管理,也不需要担心重复请求的处理,因为亚马逊的IAP API会处理这些。
在该对话框中,您还可以通过单击Grown ups, purchase on device,来发起常规的应用内购买流程。在这个流程中,家长在设备上输入他们的密码,购买会立即完成。
-
创建请求后,前往parents.amazon.com的Parent Dashboard(家长控制面板)查看请求。请确保使用亚马逊家庭共享的家长账户登录。您还将收到一封请求电子邮件。
- 单击You have notifications(您有新的通知)。
-
单击儿童个人资料下的Store(存储)以打开存储请求页面并查看请求。您可以在此页面上查看所有消费品和权利。
-
单击Review request(查看请求)可查看请求的详细信息。
-
在请求详细信息屏幕上,选择Buy Now(立即购买)以批准请求,或选择Decline(拒绝)以拒绝申请。
如果您选择Buy Now,则该权利将添加到儿童个人资料中。带有家长批准消息的推送通知将与儿童个人资料一起发送到Fire平板电脑,如下图所示。
注意: 此通知不同于实时开发者通知(RTN)。RTN是getPurchaseUpdates()
的补充,可让您的应用收到购买收据通知并将内容交付给客户。
点击通知即可启动应用并发起getPurchaseUpdates()
流程。新的权利即会出现在应用中。
提示: 在客户端存在缓存。如果您没有立即看到收据,请等待20分钟,然后重试onResume()
调用。
如果您选择Decline,则该权利将不会添加到儿童个人资料中。儿童会收到一条推送通知,上面有一条消息,说明应用内购买未被批准,如下图所示。
getPurchaseUpdates()
响应不会更新,儿童可以再次请求权利。
测试消费品的待定购买
-
选择要从测试应用购买的消费品。出现与此处所示类似的对话框。
-
要发起“待定购买”流程,单击Request Purchase。这会致使待定状态被发送到您的应用。您不需要在应用中实现状态管理,也不需要担心重复请求的处理,因为亚马逊的IAP API会处理这些。
在该对话框中,您还可以通过单击Grown ups, purchase on device,来发起常规的应用内购买流程。在这个流程中,家长在设备上输入他们的密码,购买会立即完成。
-
创建请求后,前往parents.amazon.com的Parent Dashboard(家长控制面板)查看请求。请确保使用亚马逊家庭共享的家长账户登录。您还将收到一封请求电子邮件。
- 单击You have notifications(您有新的通知)。
-
单击儿童个人资料下的Store(存储)以打开存储请求页面并查看请求。您可以在此页面上查看所有消费品和权利。
-
单击Review request(查看请求)可查看请求的详细信息。
-
在请求详细信息屏幕上,选择Buy Now(立即购买)以批准请求,或选择Decline(拒绝)以拒绝申请。
如果您选择Buy Now,则该消费品将添加到儿童个人资料中。带有家长批准消息的推送通知将与儿童个人资料一起发送到Fire平板电脑,如下图所示。
注意: 此通知不同于实时开发者通知(RTN)。RTN是getPurchaseUpdates()
的补充,可让您的应用收到购买收据通知并将内容交付给客户。
点击通知即可启动应用并发起getPurchaseUpdates()
流程。新的权利即会出现在应用中。
提示: 在客户端存在缓存。如果您没有立即看到收据,请等待20分钟,然后重试onResume()
调用。
如果您选择Decline,则该消费品将不会添加到儿童个人资料中。儿童会收到一条推送通知,上面有一条消息,说明应用内购买未被批准,如下图所示。
getPurchaseUpdates()
响应不会更新,儿童可以再次请求消费品。
Last updated: 2024年5月22日