函數的用法

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 後端中指定的項目名稱

請求應用程式內購買逐項名稱 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，以供日後查詢。

進行任何訂閱和購買時，都會提示使用者輸入 PIN 碼。PIN 碼的使用者介面由 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

訂閱方案。 pchSubsciptionID 用於完成訂閱過程，從 RequestSubscription() 或 RequestSubscriptionWithPlanID() 回調 pchSubsciptionID 取得。

訂閱成功後， IAPurchaseListener.OnSubscribeSuccess 將取得用於檢查或取消訂閱的 pchSubscriptionId 。

進行任何訂閱和購買時，都會提示使用者輸入 PIN 碼。PIN 碼的使用者介面由 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 指定的訂閱。