기술 자료

​
​

Development

User Acquisition

Monetization

산업 분야

Leaderboards

Unity SDK

Admin API

Client API

Open Unity Dashboard

Leaderboards

이 페이지는 선택한 언어로 제공되지 않습니다.
LiveOps
​
​
Leaderboards
  • Overview
  • Get started
  • Concepts
  • Tutorials
    • Configuration
    • Unity SDK tutorial
      • Add a new score
      • Get the player's score
      • Get scores
      • Get a range of scores centered around the player
      • Get scores for other players
      • Get scores for a certain tier
      • Get a list of available leaderboard versions
      • Get the player's score from a leaderboard version
      • Get scores from a leaderboard version
      • Get a range of scores centered around the player from a leaderboard version
      • Get scores for other players from a leaderboard version
      • Get scores for a certain tier from a leaderboard version
    • Unity SDK sample
    • Cloud Code samples
  • Reference
  • Privacy and consent
  1. Leaderboards
  2. Unity SDK tutorial

Add a new score

Add or update a score for a player in a leaderboard.
읽는 시간 1분
최근 업데이트: 12시간 전

To add or update an entry for the player in the specified leaderboard, use the
AddPlayerScoreAsync
method.
public async void AddScore(string leaderboardId, int score) { var playerEntry = await LeaderboardsService.Instance .AddPlayerScoreAsync(leaderboardId, score); Debug.Log(JsonConvert.SerializeObject(playerEntry)); }

Add a new score with metadata

To add a score with metadata, use the
Metadata
option on the
AddPlayerScoreOptions
configuration object:
[Serializable] public class ScoreMetadata { public string levelName; public int timeTaken; } public async void AddScoreWithMetadata(string leaderboardId, int score) { var scoreMetadata = new ScoreMetadata { levelName = "LEVEL_01", timeTaken = 120 }; var playerEntry = await LeaderboardsService.Instance .AddPlayerScoreAsync( leaderboardId, score, new AddPlayerScoreOptions { Metadata = scoreMetadata } ); Debug.Log(JsonConvert.SerializeObject(playerEntry)); }
If a score that has stored metadata is updated with null metadata, the new metadata value will be null.
Leaderboard score metadata can be up to 1024 bytes (1 KB).

Copyright © 2026 Unity Technologies
법률 정보개인정보 처리방침쿠키Documentation Terms of Use개인 정보 판매 또는 공유 금지개인정보 보호 선택(쿠키 설정)

'Unity', Unity 로고 및 기타 Unity 상표는 미국 및 기타 지역 내 Unity Technologies 또는 그 계열사의 상표 또는 등록상표입니다(자세한 내용은 여기에서 확인하세요). 기타 명칭 또는 브랜드는 해당 소유자의 상표입니다.

일부 페이지는 편의를 위해 기계 번역되었으며 부정확한 내용이 있을 수 있습니다. 정보가 상충되는 경우, 영어 버전을 우선으로 참조하세요.

  • 보고 있는 페이지
    • Add a new score with metadata


이 페이지의 문제 보고