用法範例
以下範例重點介紹了開發人員如何在內容中使用 VIVEPORT 應用程式內購買 (IAP) API。
開始之前:
- 在嘗試執行任何 API 函數之前,請確認您的內容具有 VIVEPORT ID 和金鑰 。
- 在執行任何 IAP API 函數之前,請確認您具有 API 金鑰 。
- 請務必以可結算貨幣設定價格。開發者負責管理自己的匯率。
-
使用
Viveport.Api.Init
調用頂級 API 以初始化 VIVEPORT SDK。對於 Unity 開發人員,通常調用 MonobehaviorStart()
。 -
調
IAPurchase.IsReady()
以初始化 Session Token API。 -
請執行下列任一操作:
-
調用
Request()[NEW]
以透過項目名稱pchItemName
請求 IAP 項目的價格。 -
調用
Purchase()
以購買pchPurchaseId
指定的項目。 -
假如使用者購買了
pchPurchaseId
指定的項目,請調用Query()
。調用不含pchPurchaseID
的函數以取得完整購買清單。 -
調用
GetBalance()
以取得使用者的錢包餘額。 -
調用
RequestSubscription()
以產生訂閱 ID,以便訂閱未在 VIVEPORT 開發者主控台中指定的方案。 -
調用
RequestSubscriptionWithPlanID()
以在 VIVEPORT 開發者主控台中訂閱具有方案 ID 的方案。 -
調用
Subscribe()
以使用RequestSubscription()
或RequestSubscriptionWithPlanID()
中的SubscriptionID
訂閱方案。 -
調用
QuerySubscription()
以使用從Subscribe()
的回調中接收的訂閱 ID 檢查訂閱狀態。如果pchSubscriptionId
是 null,則回調函數將以陣列形式取得所有訂閱。 -
調用
QuerySubscriptionList()
以陣列形式檢查所有訂閱。 -
調用
CancelSubscription()
以取消pchSubscriptionId
指定的訂閱。
-
調用
-
不再需要時,請調用
Viveport.Api.Shutdown
以釋放 VIVEPORT SDK 資源。在 Unity 中,通常是在 MonoBehaviorOnDestroy()
中或在Application.Quit()
之前。