IAP概述

开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅发行说明。

应用内购买 (IAP) API允许您的应用在应用内呈现、处理和完成数字内容和订阅的购买。亚马逊支持适用于Vega应用的IAP API。本页简要介绍了IAP API以及预览版中可用的功能。

注意： 使用@amazon-devices/keplerscript-appstore-iap-lib的较新版本时（高于2.12.2），可在设备和Vega虚拟设备 (VVD) 模拟器上进行IAP测试。

@amazon-devices/keplerscript-appstore-iap-lib有较新版本，该版本迁移至系统Bundle中以获得内存优势。升级以避免任何IAP集成问题。安装最新的Vega SDK并将@amazon-devices/keplerscript-appstore-iap-lib大约升级到2.12.10。

重要须知： 从v0.20版本开始，@amazon-devices/keplerscript-appstore-iap-lib的旧版本 (< 2.12.2) 将不再可用。将@amazon-devices/keplerscript-appstore-iap-lib版本大约升级到2.12.2或最新的可用版本。

@amazon-devices/keplerscript-appstore-iap-lib有较新版本，该版本迁移至系统Bundle中以获得内存优势。升级以避免任何IAP集成问题。安装最新的Vega SDK并将@amazon-devices/keplerscript-appstore-iap-lib大约升级到2.12.10。

有关如何升级的更多详细信息，请参阅以下说明。

什么是应用内购买 (IAP)？

通过应用内购买 (IAP)，应用的用户可以在应用中购买各类数字商品，如游戏中的额外生命或优质内容的订阅。

下面是一些可能会用到IAP的案例说明：

为您的应用创建“免费增值”模式，其中，应用本身是免费的，但对高级服务或功能收费。
允许您的客户购买商品来增强他们的游戏体验，例如货币、额外的移动次数或生命。
允许用户购买此内容的访问权，从而解锁奖励关卡或迷你游戏。
使客户能够订阅应用中提供的内容。

IAP API可处理有关购买流程、付款处理、向应用提供收据以及可购买内容权利管理的详细信息，这样您就不必自己对以上功能进行编程。

在应用中包含必要的程序包依赖项

在package.json文件中，添加@amazon-devices/keplerscript-appstore-iap-lib和@amazon-devices/package-manager-lib程序包作为依赖项。

已复制到剪贴板。

{
  "dependencies": {
    "@amazon-devices/keplerscript-appstore-iap-lib": "~2.12.10",
    "@amazon-devices/package-manager-lib": "^1.0.0"
  }
},

Fire OS与Vega的IAP方法

API	描述	Fire OS对象 (Java)	Vega对象 (JS)	Vega与Fire OS是否有区别	具体区别
`getUserData`	发起检索当前登录用户的用户ID的请求。	`UserDataRequest` `UserDataResponse`	`UserDataRequest` `UserDataResponse`	否	不适用
`getProductData`	发起检索多达一百个SKU的商品数据的请求。	作为getProductData API调用的一部分发送SKU列表。响应将通过`ProductDataResponse`提供。	`ProductDataRequest` `ProductDataResponse`	是	1. 价格在Fire OS中是一个字符串，但在Vega中，它是一个对象，包含以微单位表示的`currencyFormattedPrice`、`currencyCode`和`priceValue`。这也适用于`promotionPrice`。 2.`Promotion`对象内的`promotionPlans`字段已更改为Vega中的计划。 3. `promotionPrice`、`promotionPriceCycles`、`promotionPricePeriod`已更改为`price`、`priceCycles`和`period`。
`purchase`	发起产品的购买流程。	作为购买API调用的一部分发送单个SKU。响应将通过`PurchaseResponse`提供。	`PurchaseRequest` `PurchaseResponse`	否	不适用
`getPurchaseUpdates`	发起请求以检索客户已购买和/或取消的商品的更新信息。	作为getPurchaseUpdates API调用的一部分发送重置标记。响应将通过`PurchaseUpdatesResponse`提供。	`PurchaseUpdatesRequest` `PurchaseUpdatesResponse`	否	不适用
`modifySubscription`	发起针对订阅的`modifySubscription`请求。	向modifySubscription API调用发送SKU和按比例分配模式。响应将通过`ModifySubscriptionResponse`提供。	`ModifySubscriptionRequest` `ModifySubscriptionResponse`	否	不适用
`notifyFulfillment`	将有关购买履行的信息通知亚马逊。	在请求中发送receiptId和`FulfillmentResult`。不会发送任何响应。这是一个无效的调用。	`NotifyFulfillmentRequest` `NotifyFulfillmentResponse`	是	会发送`NotifyFulfillmentResponseCode`（仅提供英文版）

适用于Fire OS的IAP与适用于Vega的IAP

在Fire OS上，IAP SDK适用于用Java编写的Android应用。在Vega上，IAP API与用JavaScript编写的Vega SDK集成在一起。您可以向亚马逊应用商店提交应用内商品，并可以为生产功能（例如动态应用测试）实现API。

下表列出了Vega支持的当前IAP组件。

IAP组件	描述	文档
IAP API	用于运行和履行应用内购买的API	IAP API概述
App Tester	用于在本地测试应用的工具	配置App Tester
收据验证服务 (RVS) 云沙盒	在沙盒模式中验证交易收据的有效性	适用于IAP应用的RVS

Last updated: 2025年9月30日