函数的用法

IsReady()

void IsReady(IAPurchaseListener listener, string pchApiKey);

参数	类型	描述
listener	IAPurchaseListener	回调函数
pchApiKey	string	API 密钥

初始化应用程序内购买（IAP）API。初始化完成后，监听器回调的 OnSuccess() 函数将获取最终用户的货币类型。其他函数也可以使用该货币类型。

Request()

void Request(IAPurchaseListener listener, string pchPrice);

参数	类型	描述
listener	IAPurchaseListener	回调函数
pchPrice	string	最终用户货币的购买价格，格式为 `"1.50"` 。注意，小数点用句点标记，而不是逗号。

请求 IAP 项目的价格。请求完成后， IAPurchaseListener listener 的 OnRequestSuccess() 回调将获取所请求商品的购买 ID。购买 ID 是 Purchase() 的参数。

Request() [NEW]

void Request(IAPurchaseListener listener, string pchPrice, string pchItemName);

参数	类型	描述
listener	IAPurchaseListener	回调函数
pchPrice	string	最终用户货币的购买价格，格式为 `"1.50"` 。注意，小数点用句点标记，而不是逗号。
pchItemName	string	VIVEPORT 后端中指定的项目名称

请求 IAP 逐项名称 pchItemName 的价格。请求完成后， IAPurchaseListener listener 的 OnRequestSuccess() 回调将获取所请求项目的购买 ID。购买 ID 是 Purchase() 的参数。

Purchase()

void Request(IAPurchaseListener listener, string pchPurchaseId);

参数	类型	描述
listener	IAPurchaseListener	回调函数
pchPurchaseId	string	来自 `Request()` 的购买 ID

购买 pchPurchaseId 指定的项目。购买完成后， IAPurchaseListener listener 的 OnPurchaseSuccess() 回调将获取购买 ID，以供以后查询。

进行任何订阅和购买时，都会提示最终用户输入支付密码。支付密码的用户界面由 SDK 实现。

Query()

void Query(IAPurchaseListener listener, string pchPurchaseId);

参数	类型	描述
listener	IAPurchaseListener	回调函数
pchPurchaseId	string	来自 `Request()` 的购买 ID

检查最终用户是否已经购买了 pchPurchaseId 指定的项目。检查完成后， IAPurchaseListener listener 的 OnQuerySuccess() 函数将获取购买 ID，以供以后查询。

Query() [NEW]

void Query(IAPurchaseListener listener);

参数	类型	描述
listener	IAPurchaseListener	回调函数

显示最终用户的购买清单，以便开发者可以交付虚拟商品。显示完成后， IAPurchaseListener listener 的 OnQuerySuccess() 函数将通过 IaPurchase.QueryListResponse 获取所有已购买项目的列表。

GetBalance()

void GetBalance(IAPurchaseListener listener);

参数	类型	描述
listener	IAPurchaseListener	回调函数

获取最终用户的钱包余额。获取完成后， IAPurchaseListener listener 的 OnBalanceSuccess() 函数将通过 string pchBalance 输出最终用户的钱包余额。

RequestSubscription()

void RequestSubscription(IAPurchaseListener listener, string pchPrice, string pchFreeTrialType, 
int nFreeTrialValue, string pchChargePeriodType, int nChargePeriodValue, 
int nNumberOfChargePeriod, string pchPlanId);

参数	类型	描述
listener	IAPurchaseListener	回调函数
pchPrice	string	最终用户货币的购买价格，格式为 `"1.50"` 。注意，小数点用句点标记，而不是逗号。
pchFreeTrialType	string	免费试用期单位， `“month”` 或 `“day”`
nFreeTrialValue	int	免费试用期单位数量（月或天）
pchChargePeriodType	string	订阅期限单位， `“month”` 或 `“day”`
nChargePeriodValue	int	每个收费周期的月数/天数
nNumberOfChargePeriod	int	此订阅中的收费期数
pchPlanId	string	指定订阅计划 ID

请求订阅 ID，以订阅未在 VIVEPORT 开发者控制台中指定的计划。所有订阅详情均作为参数传递。请求完成后， IAPurchaseListener listener 的 OnRequestSubscriptionSuccess() 函数将获取可用作 Subscribe() 参数的订阅 ID。

对于 pchChargePeriodType ， nChargePeriodValue 和 nNumberofChargePeriod ，如果 pchChargePeriodType == "month" ， nChargePeriodValue == 2 ， nNumberofChargePeriod == 1 ，则每两个月会向最终用户收费一次。

RequestSubscriptionWithPlanID()

void RequestSubscriptionWithPlanID(IAPurchaseListener listener, string pchPlanId);

参数	类型	描述
listener	IAPurchaseListener	回调函数
pchPlanId	string	要订阅的计划 ID

使用计划 ID，以在 VIVEPORT 开发者控制台上订阅计划。计划 ID 于配置时在 VIVEPORT 开发者控制台中设置。完成后， IAPurchaseListener listener 的 OnRequestSubscriptionSuccess() 函数将获取可用作 Subscribe() 参数的订阅 ID。

Subscribe()

void Subscribe(IAPurchaseListener listener, string pchSubscriptionId);

参数	类型	描述
listener	IAPurchaseListener	回调函数
pchSubscriptionId	string	要订阅的计划 ID

订阅计划。来自 RequestSubscription() 或 RequestSubscriptionWithPlanID() 回调的 pchSubsciptionID ，用于完成订阅过程。

订阅成功后， IAPurchaseListener.OnSubscribeSuccess 将获取用于检查或取消订阅的 pchSubscriptionId 。

进行任何订阅和购买时，都会提示最终用户输入支付密码。支付密码的用户界面由 SDK 实现。

QuerySubscription()

void QuerySubscription(IAPurchaseListener listener, string pchSubscriptionId);

参数	类型	描述
listener	IAPurchaseListener	回调函数
pchSubscriptionId	string	要查询的订阅 ID

使用从 Subscribe() 回调中接收的订阅 ID 检查订阅状态。订阅通过 Subscription[] 类的 IAPurchaseListener.OnQuerySuccess.subscriptionlist 输出。

如果 pchSubscriptionId 为 null，则回调将以数组形式获取所有订阅。

QuerySubscriptionList(IAPurchaseListener listener)

void QuerySubscription(IAPurchaseListener listener);

参数	类型	描述
listener	IAPurchaseListener	回调函数

检查所有最终用户订阅的订阅状态。订阅通过 Subscription[] 类的 IAPurchaseListener.OnQuerySubscriptionListSuccess().subscriptionlist 获取。

CancelSubscription()

void CancelSubscription(IAPurchaseListener listener, string pchSubscriptionId);

参数	类型	描述
listener	IAPurchaseListener	回调函数
pchSubscriptionId	string	要取消的订阅 ID

取消由 pchSubscriptionId 指定的订阅。