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

GetGuildMemberListV3

public BackendReturnObject GetGuildMemberListV3(string guildIndate);
public BackendReturnObject GetGuildMemberListV3(string guildIndate, int limit);
public BackendReturnObject GetGuildMemberListV3(string guildIndate, string firstKey);
public BackendReturnObject GetGuildMemberListV3(string guildIndate, int limit, string firstKey);

파라미터

ValueTypeDescriptiondefault
guildIndatestring길드 멤버 리스트를 불러올 길드의 inDate-
limitint(Optional) 불러올 길드 멤버 리스트의 수100
firstKeystring(Optional) 불러올 길드 멤버 리스트의 시작점(offset)-

설명

해당 guildIndate를 가진 길드의 멤버 리스트를 조회합니다.

Example

동기

Backend.Guild.GetGuildMemberListV3("guildIndate");
Backend.Guild.GetGuildMemberListV3("guildIndate", 5);

// 처음 리스트를 읽을 때, firstkey 값을 저장해 놓은 뒤,
BackendReturnObject bro = Backend.Guild.GetGuildMemberListV3();
String firstKey = bro.FirstKeyString();
// 다음 페이지 넘어갈 때 firstKey를 offset으로 하여 다시 읽어옴
Backend.Guild.GetGuildMemberListV3("guildIndate", firstKey);
Backend.Guild.GetGuildMemberListV3("guildIndate", 5, firstKey);

비동기

Backend.Guild.GetGuildMemberListV3("guildIndate", (callback) => {
// 이후 처리
});

Backend.Guild.GetGuildMemberListV3("guildIndate", 5, (callback) => {
// 이후 처리
});

// 동기 함수와 같은 방식으로 firstKey를 저장한 후, 다음 리스트를 불러옴
Backend.Guild.GetGuildMemberListV3("guildIndate", firstKey, (callback) => {
// 이후 처리
});

Backend.Guild.GetGuildMemberListV3("guildIndate", 20, firstKey, (callback) => {
// 이후 처리
});

SendQueue

SendQueue.Enqueue(Backend.Guild.GetGuildMemberListV3, "guildIndate", (callback) => {
// 이후 처리
});

SendQueue.Enqueue(Backend.Guild.GetGuildMemberListV3, "guildIndate", 5, (callback) => {
// 이후 처리
});

// 동기 함수와 같은 방식으로 firstKey를 저장한 후, 다음 리스트를 불러옴
SendQueue.Enqueue(Backend.Guild.GetGuildMemberListV3, "guildIndate", firstKey, (callback) => {
// 이후 처리
});

SendQueue.Enqueue(Backend.Guild.GetGuildMemberListV3, "guildIndate", 20, firstKey, (callback) => {
// 이후 처리
});

ReturnCase

Success cases

조회에 성공한 경우
statusCode : 200
message : Success
returnValue : GetReturnValuetoJSON 참조

Error cases

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

GetReturnValuetoJSON

{
rows:
[
// 길드원 1
{
// 길드원 1의 굿즈 2 기부(+사용) 총량
totalGoods2Amount:{ N:"21" },
// 길드원 1의 굿즈 3 기부(+사용) 총량
totalGoods3Amount:{ N:"8" },
// 길드원 1 닉네임
nickname:{ S:"id2" },
// 길드원 1의 길드 indate(길드 가입 시점)
inDate:{ S:"2018-11-21T05:42:24.511Z" },
// 길드원 1 indate
gamerInDate:{ S:"2018-11-08T03:32:18.210Z" },
// 길드원 1 길드 권한(master/viceMaster/member)
position:{ S:"master" },
//마지막으로 접속한 날짜
lastLogin:{S:"2021-07-23T07:42:01.019Z"}
},
// 길드원 2
{
totalGoods2Amount:{ N:"0" },
totalGoods3Amount:{ N:"0" },
inDate:{ S:"2018-11-22T05:45:11.638Z" },
gamerInDate:{ S:"2018-11-13T01:46:25.323Z" },
totalGoods1Amount:{ N:"0" },
position:{ S:"member" },
lastLogin:{S:"2021-07-22T01:49:01.019Z"}
},
],
//firstKey가 존재할 경우
firstKey:{"inDate":{"S":"2021-07-15T01:18:02.841Z"}}
//firstKey가 존재하지 않을 경우
firstKey:null
}

Sample Code

public class GuildMemberItem
{
public string nickname;
public string inDate;
public string gamerInDate;
public string position;
public string lastLogin;
public Dictionary<string, int> totalGoodsAmount = new Dictionary<string, int>();
public override string ToString()
{
string goodsString = string.Empty;
foreach(var dic in totalGoodsAmount)
{
goodsString += $"{dic.Key} : {dic.Value}\n";
}
return $"nickname : {nickname}\n" +
$"inDate : {inDate}\n" +
$"gamerInDate : {gamerInDate}\n" +
$"position : {position}\n" +
$"lastLogin : {lastLogin}\n" +
goodsString;
}
};
public void GetGuildMemberListV3()
{
var bro = Backend.Guild.GetGuildMemberListV3("2021-10-29T06:32:10.147Z");

if(!bro.IsSuccess())
return;

LitJson.JsonData guildMemberJson = bro.FlattenRows();

List<GuildMemberItem> guildMemberList = new List<GuildMemberItem>();

for(int i = 0; i < guildMemberJson.Count; i++)
{
GuildMemberItem member = new GuildMemberItem();

member.nickname = guildMemberJson[i]["nickname"].ToString();
member.inDate = guildMemberJson[i]["inDate"].ToString();
member.gamerInDate = guildMemberJson[i]["gamerInDate"].ToString();
member.lastLogin = guildMemberJson[i]["lastLogin"].ToString();
member.position = guildMemberJson[i]["position"].ToString();
foreach(var goods in guildMemberJson[i].Keys)
{
if(goods.Contains("totalGoods"))
{
member.totalGoodsAmount.Add(goods, int.Parse(guildMemberJson[i][goods].ToString()));
}
}

guildMemberList.Add(member);
Debug.Log(member.ToString());
}
}