WorldRankService

WorldRankService : Instance

Overview

WorldRankService는 플레이어가 월드에서 획득한 점수를 리더보드 형태로 저장하고 조회할 수 있도록 제공되는 서비스입니다.

점수 증가(Increment) 및 점수 조회(GetScore)와 같은 핵심 기능을 통해 플레이어 간 경쟁을 유도하고, 월드와 아웃게임 환경 모두에서 순위 기반 콘텐츠를 손쉽게 구현할 수 있습니다.

등록된 점수는 백엔드에서 자동으로 내림차순 정렬되며, 월드 진입 전 앱(아웃게임)의 월드 상세 화면에 위치한 Top Scorer 섹션에도 표시됩니다.

이 서비스는 서버 환경에서만 동작하며, 클라이언트 스크립트에서는 호출할 수 없습니다.

리더보드에 등록된 해당 player의 현재 점수를 반환합니다.

Player Player

현재 점수를 확인할 플레이어입니다.

number

반환된 점수입니다.

지정한 player의 점수 변화량을 리더보드에 등록합니다. 점수는 정수만 허용되며, 변화량은 양수만 입력할 수 있습니다. 입력 가능한 최대 변화량은 100,000이며, 이 값을 초과한 요청은 처리되지 않습니다.

Player Player

점수를 등록할 플레이어입니다.

number Score

점수 변화량입니다.

void

Last updated 3 hours ago