函數的用法
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
指定的訂閱。