用法範例
以下範例重點介紹了開發人員如何在內容中使用 VIVEPORT Arcade 排行榜 API。
在執行任何 API 函數之前,請確認您的內容擁有 VIVEPORT ID 和金鑰。
-
使用
Viveport.Api.Init
調用頂級 API 以初始化 VIVEPORT SDK。對於 Unity 開發人員,通常調用 MonobehaviorStart()
。 -
調用
Viveport.Arcadeleaderboard.IsReady()
以初始化 VIVEPORT Arcade 排行榜 API。 -
調用
Viveport.ArcadeLeaderboard.DownloadLeaderBoardScores()
以下載得分。 -
請執行下列任一操作:
-
調用
Viveport.ArcadeLeadboard.GetCount()
以檢查排行榜得分的分數,該分數可用於確定GetLeaderboardScore()
的索引值。 -
調用
GetLeaderboardSortMethod()
以取得用於排行榜得分順序的排序方法。這可用於統整本地顯示的資訊。 -
調用
GetLeaderboardDisplayType()
以確定排行榜儲存的數據類型。關於完整列表,請參見LeaderBoardDisplayType()
。
-
調用
-
使用正確的索引調用
GetLeaderboardScore()
以取得得分。 - 向使用者展示排行榜。
-
如果要上傳新得分,請調用
UpLoadLeaderboardScore()
將其上傳到 VIVEPORT 後端。
請記住,將依據 VIVEPORT 開發者主控台 中的排行榜設定來處理更改,例如累計或是替換得分。 -
不再需要時,請調用
Viveport.Api.Shutdown
以釋放 VIVEPORT SDK 資源。在 Unity 中,通常是在 MonoBehaviorOnDestroy()
中或在Application.Quit()
之前。