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程序包作为依赖项。

已复制到剪贴板。

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

Fire OS与Vega的IAP方法

API	描述	Fire OS对象 (Java)	Vega对象 (JS)	Vega与Fire OS是否有区别	具体区别
`getUserData`	发起检索当前登录用户的用户ID的请求。	`UserDataRequest` `UserDataResponse`	`UserDataRequest` `UserDataResponse`	否	不适用
`getProductData`	发起检索多达100个SKU的商品数据的请求。	作为`getProductData` API调用的一部分发送SKU列表。`ProductDataResponse`提供响应。	`ProductDataRequest` `ProductDataResponse`	是	1. 价格在Fire OS中是一个字符串，但在Vega中，它是一个对象，包含以微单位表示的`currencyFormattedPrice`、`currencyCode`、`promotionPrice`和`priceValue`。 2. `Promotion`对象内的`promotionPlans`字段在Vega中更改为`plans`。 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`	是	会发送`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: 2026年1月23日