Skip to main content
Version: 5.16.0

GetOtherGuildLeaderboardPlace

public BackendGuildLeaderboardReturnObject GetOtherGuildLeaderboardPlace(string leaderboardUuid, string userInDate);\ public BackendGuildLeaderboardReturnObject GetOtherGuildLeaderboardPlace(string leaderboardUuid, string userInDate, int gap);

Parameters

ValueTypeDescriptionDefault
leaderboardUuidstringuuid of the leaderboard to look up-
userIndatestringinDate of the guild to look up-
gapintNumber of rank holders above/below to be looked up together(0 - 25)0

leaderboardUuid 값은 아래 방법을 통해 확인할 수 있습니다.

Description

uuid 값과 userIndate를 이용하여 해당 리더보드에서 해당 길드의 리더보드을 조회합니다.

  • If there is a tie between guilds (with the same rank), guilds with the same ranks may be returned when the gap method is used for the lookup.
  • This method cannot be called using SendQueue.

BackendGuildLeaderboardReturnObject

namespace BackEnd.Leaderboard
{
public class GuildLeaderboardItem
{
public string guildInDate;
public string guildName;
public string score;
public string index;
public string rank;
}

public class BackendGuildLeaderboardReturnObject : BackendReturnObject
{
public long GetTotalCount();
public List<GuildLeaderboardItem> GetGuildLeaderboardList();
}
}

Example

Synchronous


BackEnd_TEST.Leaderboard.BackendGuildLeaderboardReturnObject bro = null;
// 자기 자신의 랭킹만 조회
bro = Backend.Leaderboard.Guild.GetOtherGuildLeaderboardPlace("01920444-612d-7802-8e30-f983de5220a9", "2024-05-08T07:17:20.830Z");
// 위아래 3명의 길드를 포함하여 리더보드 조회
// 해당 길드가 4등인 경우 1 ~ 7등 길드가 조회됨
bro = Backend.Leaderboard.Guild.GetOtherGuildLeaderboardPlace("01920444-612d-7802-8e30-f983de5220a9", "2024-05-08T07:17:20.830Z", 3);

Debug.Log("리더보드 총 길드 등록 수 : " + bro.GetTotalCount());
foreach (BackEnd_TEST.Leaderboard.GuildLeaderboardItem item in bro.GetGuildLeaderboardList())
{
Debug.Log($"{item.rank}위 : {item.guildName}");
Debug.Log(item.ToString());
}

Asynchronous

// 해당 길드의 리더보드만 조회
Backend.Leaderboard.Guild.GetOtherGuildLeaderboardPlace("01920444-612d-7802-8e30-f983de5220a9", "2024-05-08T07:17:20.830Z", bro => {

if(bro.IsSuccess() == false) {
return;
}

Debug.Log("리더보드 총 길드 등록 수 : " + bro.GetTotalCount());

foreach (BackEnd_TEST.Leaderboard.GuildLeaderboardItem item in bro.GetGuildLeaderboardList())
{
Debug.Log($"{item.rank}위 : {item.guildName}");
Debug.Log(item.ToString());
}
});

// 위아래 3명의 길드를 포함하여 리더보드 조회
// 해당 길드가 4등인 경우 1 ~ 9등 길드가 조회됨
Backend.Leaderboard.Guild.GetOtherGuildLeaderboardPlace("01920444-612d-7802-8e30-f983de5220a9", "2024-05-08T07:17:20.830Z", 5, callback => {
// 이후 처리
});

ReturnCase

Success cases

When the guild is in the leaderboard\ statusCode : 200\ message : Success\ returnValue : Refer to GetReturnValuetoJSON

Error cases

When uuid is null or string.Empty\ statusCode : 400\ errorCode : ValidationException\ message : leaderboardUuid is null or empty

존재하지 않는 uuid로 조회를 시도한 경우\ StatusCode : 404\ ErrorCode : NotFoundException\ Message : leaderboard not found, leaderboard을(를) 찾을 수 없습니다

존재하지 않는 guildIndate로 조회를 시도한 경우\ statusCode : 404\ errorCode : NotFoundException\ message : guild not found, guild을(를) 찾을 수 없습니다

해당 길드가 랭킹에 존재하지 않는 경우\ statusCode : 404\ errorCode : NotFoundException\ message : guildRank not found, guildRank을(를) 찾을 수 없습니다

GetReturnValuetoJSON

gap이 0인 경우

{
"rows": [
{
"guildName": "My Guild",
"guildInDate": "2024-05-08T07:17:20.830Z",
"rank": 5,
"index": 4,
"score": "20"
}
],
"totalCount": 36
}

gap이 1 인 경우(내길드(2024-05-08T07:17:20.830Z) 기준)

{
"rows": [
{
"guildName": "guild3",
"guildInDate": "2024-05-08T07:17:21.347Z",
"rank": 4,
"index": 3,
"score": "24"
},
{
"guildName": "My Guild",
"guildInDate": "2024-05-08T07:17:20.830Z",
"rank": 5,
"index": 4,
"score": "20"
},
{
"guildName": "guild5",
"guildInDate": "2024-09-12T05:04:53.047Z",
"rank": 6,
"index": 5,
"score": "18"
}
],
"totalCount": 36
}