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

GetUserRank

public BackendReturnObject GetUserRank(string rankUuid, string userInDate);
public BackendReturnObject GetUserRank(string rankUuid, string userInDate, int gap);

안내

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

파라미터

ValueTypeDescriptionDefault
rankUuidstring조회할 랭킹의 uuid-
userIndatestring조회할 유저의 inDate-
gapint함께 조회할 위아래 랭커의 수(0 ~ 25)0

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

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

  • 친구의 inDate 확인
  • 길드원의 inDate 확인
  • public 테이블의 owner_inDate 컬럼을 통해 확인
  • 기타 유저의 inDate를 공유하는 방법 등을 통해 확인

설명

uuid 값과 userIndate를 이용하여 해당 랭킹에서 해당 유저의 랭킹을 조회합니다.

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

Example

동기

// 해당 유저의 랭킹만 조회
Backend.URank.User.GetUserRank("rankUuid", "userIndate");

// 위아래 3명의 유저를 포함하여 랭킹 조회
// 해당 유저가 4등인 경우 1 ~ 7등 유저가 조회됨
Backend.URank.User.GetUserRank("rankUuid", "userIndate", 3);

비동기

// 해당 유저의 랭킹만 조회
Backend.URank.User.GetUserRank("rankUuid", "userIndate", callback => {
// 이후 처리
});

// 위아래 3명의 유저를 포함하여 랭킹 조회
// 해당 유저가 4등인 경우 1 ~ 9등 유저가 조회됨
Backend.URank.User.GetUserRank("rankUuid", "userIndate", 5, callback => {
// 이후 처리
});

SendQueue

// 해당 유저의 랭킹만 조회
SendQueue.Enqueue(Backend.URank.User.GetUserRank, "rankUuid", "userIndate", callback => {
// 이후 처리
});

// 위아래 3명의 유저를 포함하여 랭킹 조회
// 랭킹에 총 10명의 유저가 있고, 해당 유저가 9등인 경우
// 6 ~ 10등 유저가 조회됨
SendQueue.Enqueue(Backend.URank.User.GetUserRank, "rankUuid", "userIndate", 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

존재하지 않는 유저의 userIndate로 조회를 시도할 경우
statusCode : 404
errorCode : NotFoundException
message : gamer not found, gamer을(를) 찾을 수 없습니다

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

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

GetReturnValuetoJSON

gap이 0인 경우

{
"rows": [
{
// 유저의 게이머 inDate
"gamerInDate": {
"S": "2021-03-11T06:37:30.934Z"
},
// 유저의 닉네임
"nickname": {
"S": "닉네임0호"
},
// 추가 항목
// 컬럼명과 값이 그대로 노출됩니다.
// 추가 항목 컬럼명이 extraScore인 경우 extraScore
"extraScore": {
"N": "0"
},
// 점수
// 컬럼명이 score로 통일됩니다.
// 랭킹 항목 컬럼명이 power인 경우에도 score
"score": {
"N": "101"
},
// offset
"index": {
"N": 98
},
// 유저의 랭킹
"rank": {
"N": 99
}
}
],
// 랭킹에 등록된 총 랭커의 수
"totalCount": 100
}

gap이 1 인 경우

{
"rows": [
// 자기 자신보다 랭킹이 1 높은 유저
{
"gamerInDate": {
"S": "2021-03-11T06:37:32.616Z"
},
"nickname": {
"S": "닉네임22호"
},
"extraScore": {
"N": "2346"
},
"score": {
"N": "102"
},
"index": {
"N": 97
},
"rank": {
"N": 98
}
},
// 자기 자신
{
"gamerInDate": {
"S": "2021-03-11T06:37:30.934Z"
},
"nickname": {
"S": "닉네임0호"
},
"extraScore": {
"N": "0"
},
"score": {
"N": 101
},
"index": {
"N": 98
},
"rank": {
"N": 99
}
},
// 자기 자신보다 랭킹이 1 낮은 유저
{
"gamerInDate": {
"S": "2021-03-11T06:37:31.838Z"
},
"nickname": {
"S": "닉네임44호"
},
"extraScore": {
"N": "2323"
},
"score": {
"N": "100"
},
"index": {
"N": 99
},
"rank": {
"N": 100
}
}
],
"totalCount": 100
}

Sample Code

public class RankItem
{
public string gamerInDate;
public string nickname;
public string score;
public string index;
public string rank;
public string extraData = string.Empty;
public string extraName = string.Empty;
public string totalCount;

public override string ToString()
{
string str = $"유저인데이트:{gamerInDate}\n닉네임:{nickname}\n점수:{score}\n정렬:{index}\n순위:{rank}\n총합:{totalCount}\n";
if(extraName != string.Empty)
{
str += $"{extraName}:{extraData}\n";
}
return str;
}
}
public void GetUserRankTest()
{
string userUuid = "81272320-8c40-112b-b174-d9233f6bd0e8";
string userIndate = "2022-03-02T01:51:32.967Z";

List<RankItem> rankItemList = new List<RankItem>();

BackendReturnObject bro = Backend.URank.User.GetUserRank(userUuid, userIndate, 3);

if(bro.IsSuccess())
{
LitJson.JsonData rankListJson = bro.GetFlattenJSON();
string extraName = string.Empty;
for(int i = 0; i < rankListJson["rows"].Count; i++)
{
RankItem rankItem = new RankItem();

rankItem.gamerInDate = rankListJson["rows"][i]["gamerInDate"].ToString();
rankItem.nickname = rankListJson["rows"][i]["nickname"].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();

if(rankListJson["rows"][i].ContainsKey(rankItem.extraName))
{
rankItem.extraData = rankListJson["rows"][i][rankItem.extraName].ToString();
}

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