en zh

SDK 和示例

Samsung 应用程序内购买 SDK v6.1.1
(7 MB) 3/15/2024


发行说明

2024 年 3 月 15 日


发行版本：Samsung 应用程序内购买 SDK v6.1.1


  • 发行目录
目录 说明
SDK 库 提供 IAP SDK
示例 提供 IAP 示例应用程序

更改历史记录


Samsung 应用程序内购买 6.1.1 (2024.03.15)

已发布的应用程序内购买 6.1.1

新内容

  • 分发 aar 库，而不分发项目文件
  • minSdkVersion 设为 23，targetSdkVersion 设为 34

已改进

  • 增强支付安全性

Samsung 应用程序内购买 6.1 (2020.10.14)

已发布的应用程序内购买 6.1

新内容

  • 应用 One UI 2 概念

已改进

  • 重构错误代码
  • 出现网络错误时移除错误弹出窗口
  • 根据 Android 11 中程序包可见性政策的变化进行了相应修改

已弃用

  • startPayment() API 中的 _showSuccessDialog 参数
Samsung 应用程序内购买 SDK v6.1
(785 KB) 10/14/2020

Samsung 应用程序内购买 6.0 (2019.12.12)

已发布的应用程序内购买 6.0

新内容

  • 低层和常规层订阅定价功能
  • 订阅测试功能
  • 订阅适用期限
  • 功能和卖家门户设置
  • Samsung 结账 UI/UX
  • 可通过“卖家门户”>“统计信息”获取订阅销售数据
  • startPayment() 方法响应的 PurchaseVO 对象中的 getOrderId() API
  • RESTful/iap/v6/receipt API，用于收据验证

已改进

  • 通过电子邮件发送收据的格式
  • getSubscriptionStatus() API

已弃用

  • getPurchaseReceipt API

Samsung 应用程序内购买 5.1.0 (2018.05.24)
  • 本次发布增强了稳定性并提高了性能。

Samsung 应用程序内购买 5.0.1 (2017.12.07)
  • 修复了由于 Android Oreo 政策改变导致的漏洞。（修改了示例应用程序）。

Samsung 应用程序内购买 5.0.0 (2017.11.09)
  • 将四种现有的复杂产品类型（消耗性、非消耗性、非定期订阅 (NRS) 和自动定期订阅）简化为两种类型（项目和订阅）。
  • 版本 5.0 提供了一个新的 API 集，不支持先前版本中的 API 集。新的 API 集具有下列主要特征：
    • 支持托管项目：从版本 5.0 起，IAP 系统将管理已拥有的消耗性项目的历史记录。利用这些信息，IAP 系统可以防止在购买完成之前再次购买项目，并保证在出现意外事件时（例如网络或电池问题）项目正常工作。
    • 已拥有的产品列表：此功能用于提供当前未消耗项目和可用订阅的列表，而不是提供购买历史记录。启动应用程序时，此功能将调用 getOwnedList。如果存在未消耗项目的列表，则必须使用 consumePurchasedItems 功能发布这些项目。
    • 产品详细信息：此功能不仅提供所有产品的列表，还提供已请求产品的列表。
    • 直通参数：这是当存在付款请求时开发者创建和发送的一种交易 ID 类型，响应内容为已处理的 IAP 付款结果的相同值，旨在提高安全性。

Samsung 应用程序内购买 4.0.0 (2016.09.08)

问题详细信息

  • 用户设备中未更新 Samsung Billing 4.0 时出现运行时异常。

此问题的解决方案

  • 使用 Samsung 应用程序内购买 4.0.1 文件中的新 iap4Helper

Samsung 应用程序内购买 3.0.1 (2016.01.15)

问题详细信息

此问题的解决方案（选择下面的 1 或 2）

1.修改 iap3Helper 中已存在的源代码。注释掉或删除 styles.xml 中 windowNoDisplay 对应的行（路径：\Samples\iap3Helper\src\main\res\values\styles.xml）：

Show Lines <style name="Theme.Empty" parent="AppTheme">  
<item name="android:windowBackground">@android:color/transparent</item>  
<item name="android:colorBackgroundCacheHint">@null</item>  
<item name="android:windowIsTranslucent">true</item>  
<item name="android:windowAnimationStyle">@null</item>  
<item name="android:windowNoTitle">true</item>  
<item name="android:windowContentOverlay">@null</item>  
<item name="android:backgroundDimEnabled">true</item>  
<item name="android:windowDisablePreview">true</item>  
<!--<item name="android:windowNoDisplay">true</item>-->  
</style>

2.使用 Samsung 应用程序内购买 3.0.1 SDK 中的新 iap3Helper。


Samsung 应用程序内购买 3.0.0 (2015.05.21)
  • 应用程序内购买 3.0 支持自动定期订阅，这样应用程序开发者可以每个月通过自动化和定期计费方式销售应用程序内项目。
  • ItemGroupId 替换为第三方应用程序的程序包名称。因此，ItemGroupId 已弃用。
  • 应用程序内购买 3.0 支持使用自定义项目 ID，例如 "GUN"、"machinegun"、"bullet" 等。
  • 添加了用于获取缓存收件箱列表的新方法。此方法仅针对指定的产品项目 ID 获取已购买的项目列表。尤其是，由于支持客户端缓存，此新方法可以快速获取响应。

Samsung 应用程序内购买 2.0.1 (2014.12.31)
  • 修复了由于 Android 5.0 政策改变导致的漏洞。（修改了 Samsung 应用程序内购买库，以修复使用 Samsung 应用程序内购买时应用程序突然关闭的问题。）

开发者指南的内容更新 (2014.01.07)
  • 更新了 IAP 2.0 库和 IAP 2.0 编程指南、面向 Adobe AIR 开发者的库和编程指南，以及示例源代码。

Samsung 应用程序内购买 2.0 (2013.06.20)
  • 应用程序内购买 2.0 支持三种项目类型（消耗性、非消耗性和订阅），进一步方便了应用程序开发。
  • 先前基于 IMEI 的项目购买历史记录管理替换为基于帐户的管理。重新安装应用程序后，如果可以确认帐户的购买历史记录，则可以恢复使用用户帐户登录时购买的非消耗性项目。
  • 支持单点登录，这样用户在应用程序内购买中使用其 Samsung 帐户登录后，可以访问 Samsung 支持的所有内容服务。
  • 应用程序内购买 v2.0 现在支持在美国销售项目，这是全世界最大的市场。美国用户可以在使用应用程序内购买 2.0 的应用程序中通过信用卡购买项目。
  • 应用程序内购买 2.0 具备 Samsung Apps 最新版本的 UX，提供更出色的 UX（用户体验）。
  • 先前的库将切换为独立类型的 APK，可更轻松地在应用程序与应用程序内购买之间同步。

Samsung 应用程序内购买 1.95.0 (2013.02.15)
  • 在韩国，通过电话进行小额购买时，需要输入居民登记号。根据《信息与通信网络的利用促进法案》，居民登记号的收集者已从 Samsung 更改为 PG。
  • 2 月 18 日之后，无法在韩国使用 SDK v1.90.0 或更低版本进行应用程序内购买。但是，如果您使用此更新后的 SDK 开发应用程序，则可以像以前一样在韩国销售应用程序内项目。

Samsung 应用程序内购买 1.90.0 (2012.12.18)
  • 您可以将应用程序内购买应用于在 Unity 3D（游戏引擎）中开发的应用程序。用户界面进行了较大的改进。
  • 用户界面进行了较大的改进。
  • 您可以看到细分的错误代码和用户友好的错误消息。

Samsung 应用程序内购买 1.80.0 (~2012.06.29)
  • 2012.06.29 Samsung 应用程序内购买 1.80.0
  • 2012.05.07 Samsung 应用程序内购买 1.77.0
  • 2012.01.20 Samsung 应用程序内购买 1.60.0
  • 2011.10.27 Samsung 应用程序内购买 1.50.0

功能

概述

  • Samsung 帐户登录功能
  • 全世界各个国家/地区不同的付款方式
  • 免费的付款测试
  • Beta 版测试环境
  • 项目消耗管理
  • 利用直通参数增强了安全性
  • 灵活的免费试用期和多个订阅支付周期

产品类型

  • 项目
  • 订阅