IAP概述 - Amazon Vega Docs

Amazon Developer

Console

as

Settings

Sign out

Notifications

Alexa

亚马逊应用商店

Ring

AWS

文档

Support

Contact Us

My Cases

Console

as

Vega开发者文档

新手入门

设计和开发

应用发布

参考

支持

应用内购买 (IAP) API允许您的应用在应用内呈现、处理和完成数字内容和订阅的购买。亚马逊支持适用于Vega应用的IAP API。本页简要介绍了IAP API以及预览版中可用的功能。 @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. `promotionPlans`对象内的`Promotion`字段在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

最后修改于 2026年10月26日