GetFriendList

public BackendReturnObject GetFriendList();
public BackendReturnObject GetFriendList(int limit);
public BackendReturnObject GetFriendList(int limit, int offset);

파라미터

Value	Type	Description	default
limit	int	(Optional) 불러올 친구 리스트의 수	100
offset	int	(Optional) 불러올 친구 리스트의 시작점	0

설명

친구 목록을 조회합니다.

친구는 뒤끝 콘솔 > 소셜 관리 > 설정에서 설정한 최대 보유 수 만큼만 맺을 수 있습니다. 친구 최대 보유 수의 default는 0으로, 콘솔에서 설정하신 이후에 사용 가능합니다.

Example

동기

// 전체 친구 리스트 조회
Backend.Friend.GetFriendList();
// limit, offset 사용하여 친구 리스트 조회
Backend.Friend.GetFriendList(5); // 5명 친구 조회(1-5)
Backend.Friend.GetFriendList(5, 5); // 처음 5명 이후의 5명 친구 조회(6-10)

비동기

Backend.Friend.GetFriendList((callback) => {
  // 이후 처리
});
Backend.Friend.GetFriendList(5, (callback) => {
  // 5명 친구 조회(1-5)
  // 이후 처리
});
Backend.Friend.GetFriendList(5, 5, (callback) => {
  // 처음 5명 이후의 5명 친구 조회(6-10)
  // 이후 처리
});

SendQueue

SendQueue.Enqueue(Backend.Friend.GetFriendList, (callback) => {
  // 이후 처리
});
SendQueue.Enqueue(Backend.Friend.GetFriendList, 5, (callback) => {
  // 5명 친구 조회(1-5)
  // 이후 처리
});
SendQueue.Enqueue(Backend.Friend.GetFriendList, 5, 5, (callback) => {
  // 처음 5명 이후의 5명 친구 조회(6-10)
  // 이후 처리
});

ReturnCase

Success cases

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

친구가 존재하지 않을 경우
statusCode : 200
message : Success
returnValue : {"rows":[]}

GetReturnValuetoJSON

{
    rows:
    [
        // 닉네임이 없는 유저의 경우
        {
            "inDate": // 게임 유저 inDate
                { "S" : "2018-12-27T04:49:00.493Z"},
            "createdAt": // 친구가 된 시간
                { "S" : "2018-12-27T04:49:58.140Z"}
            "lastLogin": // 마지막으로 접속한 날짜
                {"S":"2021-07-23T09:13:14.186Z"}
        },
        // 닉네임이 있는 유저의 경우
        {
            "nickname": // 게임 유저 닉네임
                { "S" : "customid2"},
            "inDate": // 게임 유저 inDate
                { "S" : "2018-12-18T01:58:18.722Z"},
            "createdAt": // 친구가 된 시간
                { "S" : "2018-12-27T04:50:03.955Z"}
            "lastLogin": // 마지막으로 접속한 날짜
                {"S":"2021-07-23T09:13:14.186Z"}
        },
        {
            nickname: [Object],
            inDate: [Object]
        }
    ]
}

Sample Code

public class FriendItem
{
    public string nickname;
    public string inDate;
    public string lastLogin;
    public string createdAt;
    public override string ToString()
    {
        return $"nickname : {nickname}\ninDate : {inDate}\nlastLogin : {lastLogin}\ncreatedAt : {createdAt}\n";
    }
};

public void GetFriendListTest()
{
    var bro = Backend.Friend.GetFriendList();

    if(!bro.IsSuccess())
        return;

    LitJson.JsonData json = bro.FlattenRows();
    List<FriendItem> freindList = new List<FriendItem>();

    for(int i = 0; i < json.Count; i++)
    {
        FriendItem friendItem = new FriendItem();

        if(json[i].ContainsKey("nickname"))
        {
            friendItem.nickname = json[i]["nickname"].ToString();
        }
        friendItem.inDate = json[i]["inDate"].ToString();
        friendItem.lastLogin = json[i]["lastLogin"].ToString();
        friendItem.createdAt = json[i]["createdAt"].ToString();

        freindList.Add(friendItem);
        Debug.Log(friendItem.ToString());
    }
}