用法範例
以下範例重點介紹了開發人員如何在內容中使用 VIVEPORT Arcade 計次型 (Session) API。
在嘗試執行任何 API 函數之前,請確認您的內容具有 VIVEPORT ID 和金鑰。
重要:
您將需要第三方伺服器身份認證的憑證和設定,例如在多人遊戲或網路使用自己的伺服器。有關詳細資訊,請參閱
第三方伺服器身份驗證
。
-
使用
Viveport.Api.Init
調用頂級 API 以初始化 VIVEPORT SDK。對於 Unity 開發人員,通常調用 MonobehaviorStart()
。 -
Viveport.Api.Init
完成後,調用Session.IsReady()
以初始化 Arcade 計次型 (Session) API。對於街機環境,強烈建議在內容啟動後立即調用此函數。 -
調用
Start()
以開始回合,回合開始後,listener.OnStartSuccess()
將取得string pchAppID
形式的app ID
和唯一的回合 GUIDstring pchGuid
。可在玩家選擇角色或設定載入後調用此函數。 -
調用
Stop()
以結束回合。回合結束後,listener.OnStopSuccess()
將取得string pchAppID
形式的app ID
和唯一的回合 GUIDstring pchGuid
,其應與listener.OnStartSuccess()
相符合。可在玩家完成一款遊戲後調用此函數,也可以在「三局兩勝」或類似設定結束時調用。 -
不再需要時,請調用
Viveport.Api.Shutdown
以釋放 VIVEPORT SDK 資源。在 Unity 中,通常是在 MonoBehaviorOnDestroy()
中或在Application.Quit()
之前。
重要:
請務必在內容啟動時調用
Session.IsReady()
,並在適當時間調用
Start()
和
Stop()
以避免收入損失。