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