Please Select Your Location

Thailand
Australia
Österreich
België
Canada
Canada - Français
中国
Česká republika
Denmark
Deutschland
France
HongKong
Iceland
India
Ireland
Italia
日本
Korea
Latvija
Lietuva
Lëtzebuerg
Malaysia
Malta
Mexico
Nederland
New Zealand
Norge
Polska
Portugal
Russia
Saudi Arabia
Singapore
Southeast Asia
España
Suisse
Suomi
Sverige
台灣
Ukraine
United Kingdom
United States
Việt Nam
المملكة العربية السعودية (Arabic)

函数的用法

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 指定的订阅。