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

函數的用法

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 指定的訂閱。