GetGuildRank
public BackendReturnObject GetGuildRank(string rankUuid, string guildIndate);
public BackendReturnObject GetGuildRank(string rankUuid, string guildIndate, int gap);
구버전 랭킹은 해당 함수를 이용할 수 없습니다.
파라미터
Value | Type | Description | Default |
---|---|---|---|
rankUuid | string | 조회할 랭킹의 uuid | - |
guildIndate | string | 조회할 길드의 inDate | - |
gap | int | 함께 조회할 위아래 길드의 수(0 ~ 25) | 0 |
rankUuid 값은 아래 방법을 통해 확인할 수 있습니다.
- uuid 값은 뒤끝 콘솔에서 랭킹을 생성 후 해당 랭킹 정보에서 uuid 값 확인
- 모든 길드 랭킹 정보 조회 함수를 이용하여 uuid 값 확인
설명
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());
}
}
}