본문으로 건너뛰기
버전: SDK-5.11.2

GetGuildRank

public BackendReturnObject GetGuildRank(string rankUuid, string guildIndate);
public BackendReturnObject GetGuildRank(string rankUuid, string guildIndate, int gap);

안내

구버전 랭킹은 해당 함수를 이용할 수 없습니다.

파라미터

ValueTypeDescriptionDefault
rankUuidstring조회할 랭킹의 uuid-
guildIndatestring조회할 길드의 inDate-
gapint함께 조회할 위아래 길드의 수(0 ~ 25)0

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

설명

uuid 값과 guildIndate를 이용하여 해당 랭킹에서 해당 길드의 랭킹을 조회합니다.

  • 동점(랭킹이 같은) 길드가 존재할 경우 gap 함수를 통해 조회 시 동일한 랭킹의 길드가 리턴될 수 있습니다.

Example

동기

// 자신이 가입한 길드의 랭킹만 조회
Backend.URank.Guild.GetGuildRank("rankUuid", "guildIndate");

// 위아래 3개의 길드를 포함하여 랭킹 조회
// 자신의 길드가 4등인 경우 1 ~ 7등 길드가 조회됨
Backend.URank.Guild.GetGuildRank("rankUuid", "guildIndate", 3);

비동기

// 자신이 가입한 길드의 랭킹만 조회
Backend.URank.Guild.GetGuildRank("rankUuid", "guildIndate", callback => {
// 이후 처리
});

// 위아래 3개의 길드를 포함하여 랭킹 조회
// 자신의 길드가 4등인 경우 1 ~ 9등 길드가 조회됨
Backend.URank.Guild.GetGuildRank("rankUuid", "guildIndate", 5, callback => {
// 이후 처리
});

SendQueue

// 자신이 가입한 길드의 랭킹만 조회
SendQueue.Enqueue(Backend.URank.Guild.GetGuildRank, "rankUuid", "guildIndate", callback => {
// 이후 처리
});

// 위아래 3개의 길드를 포함하여 랭킹 조회
// 랭킹에 총 10개의 길드가 있고, 자신의 길드가 9등인 경우
// 6 ~ 10등 길드가 조회됨
SendQueue.Enqueue(Backend.URank.Guild.GetGuildRank, "rankUuid", "guildIndate", 3, callback => {
// 이후 처리
});

ReturnCase

Success cases

해당 길드의 랭킹 조회에 성공한 경우
statusCode : 200
message : Success
returnValue : GetReturnValuetoJSON 참조

Error cases

uuid가 null 혹은 string.Empty인 경우
statusCode : 400
errorCode : ValidationException
message : rankUuid is null or empty

guildIndate가 null 혹은 string.Empty인 경우
statusCode : 400
errorCode : ValidationException
message : guildIndate is null or empty

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

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

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

GetReturnValuetoJSON

gap이 0인 경우

{
"rows": [
{
// 길드 이름
"guildName": {
"S": "guildName"
},
// 길드의 inDate
"guildInDate": {
"S": "2021-03-11T03:23:24.913Z"
},
// 길드의 점수
// 메타 랭킹, 굿즈 랭킹 관계없이 모두 score입니다.
"score": {
"N": 9999
},
// offset
"index": {
"N": 0
},
// 길드의 랭킹
"rank": {
"N": 1
}
}
],
// 랭킹에 등록된 총 길드의 수
"totalCount": 100
}

gap이 1 인 경우

{
"rows": [
// 검색한 길드보다 랭킹이 1 낮은 유저
{
"guildName": {
"S": "guildName0"
},
"guildInDate": {
"S": "2021-03-11T03:23:24.913Z"
},
"score": {
"N": 10000
},
"index": {
"N": 0
},
"rank": {
"N": 1
}
},
// 검색한 길드
{
"guildName": {
"S": "guildName1"
},
"guildInDate": {
"S": "2021-03-11T03:23:24.912Z"
},
"score": {
"N": 9999
},
"index": {
"N": 1
},
"rank": {
"N": 2
}
},
// 검색한 길드보다 랭킹이 1 낮은 유저
{
"guildName": {
"S": "guildName2"
},
"guildInDate": {
"S": "2021-03-11T03:23:24.900Z"
},
"score": {
"N": 9998
},
"index": {
"N": 2
},
"rank": {
"N": 3
}
}
],
"totalCount": 100
}

Sample Code

public class GuildRankItem
{
public string guildInDate;
public string guildName;
public string score;
public string index;
public string rank;
public string totalCount;

public override string ToString()
{
return $"길드인데이트:{guildInDate}\n길드이름:{guildName}\n점수:{score}\n정렬:{index}\n순위:{rank}\n총합:{totalCount}\n";
}
}
public void GetGuildRankTest()
{
string guildUUID = "";
string guildIndate = "";

List<GuildRankItem> rankItemList = new List<GuildRankItem>();
BackendReturnObject bro = Backend.URank.Guild.GetGuildRank(guildUUID , guildIndate , 3);

if(bro.IsSuccess())
{
LitJson.JsonData rankListJson = bro.GetFlattenJSON();
string extraName = string.Empty;

for(int i = 0; i < rankListJson["rows"].Count; i++)
{
GuildRankItem rankItem = new GuildRankItem();

rankItem.guildInDate = rankListJson["rows"][i]["guildInDate"].ToString();
rankItem.guildName = rankListJson["rows"][i]["guildName"].ToString();
rankItem.score = rankListJson["rows"][i]["score"].ToString();
rankItem.index = rankListJson["rows"][i]["index"].ToString();
rankItem.rank = rankListJson["rows"][i]["rank"].ToString();
rankItem.totalCount = rankListJson["totalCount"].ToString();

rankItemList.Add(rankItem);

Debug.Log(rankItem.ToString());
}
}
}