用法示例
以下示例重点介绍了开发者如何在内容中使用 VIVEPORT 应用程序内购买(IAP)API。
开始之前:
- 在尝试实现任何 API 函数之前,请确保您的内容具有 VIVEPORT ID 和密钥 。
- 在实现任何 IAP API 函数之前,请确保您具有 API 密钥 。
- 请务必以可结算货币设置价格。开发者负责管理自己的汇率。
-
使用
Viveport.Api.Init
调用最高级别的 API 以初始化 VIVEPORT SDK。对于 Unity 开发者,通常调用 MonobehaviorStart()
。 -
调用
IAPurchase.IsReady()
以初始化 Session Token API。 -
请执行下列任一操作:
-
调用
Request()[NEW]
以通过项目名称pchItemName
请求 IAP 项目的价格。 -
调用
Purchase()
以购买pchPurchaseId
指定的项目。 -
若最终用户已经购买了
pchPurchaseId
指定的项目,请调用Query()
。调用不含pchPurchaseID
的函数以获取完整的购买列表。 -
调用
GetBalance()
以获取最终用户的钱包余额。 -
调用
RequestSubscription()
以生成订阅 ID,以便订阅未在 VIVEPORT 开发者控制台中指定的计划。 -
调用
RequestSubscriptionWithPlanID()
以在 VIVEPORT 开发者控制台中订阅具有计划 ID 的计划。 -
调用
Subscribe()
以使用RequestSubscription()
或RequestSubscriptionWithPlanID()
中的SubscriptionID
订阅计划。 -
调用
QuerySubscription()
以使用从Subscribe()
的回调中接收的订阅 ID 检查订阅状态。如果pchSubscriptionId
是 null,则回调函数将以数组形式获取所有订阅。 -
调用
QuerySubscriptionList()
以数组形式检查所有订阅。 -
调用
CancelSubscription()
以取消pchSubscriptionId
指定的订阅。
-
调用
-
不再需要时,请调用
Viveport.Api.Shutdown
以释放 VIVEPORT SDK 资源。在 Unity 中,通常是在 MonoBehaviorOnDestroy()
中或在Application.Quit()
之前。