랭킹 보상 받기

콘솔에서 지정한 랭킹 보상을 확인하고 받고 삭제하는 기능입니다.

랭킹에 등록된 유저들에게 랭킹 보상을 보내는 시점
  • 랭킹 보상은 해당 랭킹의 집계가 완료되는 시점에 유저들에게 지급합니다.
  • 랭킹 집계는 랭킹이 초기화 된 후 시작합니다.
  • 뒤끝 베이스 일반 랭킹이 초기화 되는 시점은 오전 6시(UTC 21시) 입니다.
  • 실시간 랭킹이 초기화 되는 시점은 오전 4시(UTC 19시) 입니다.
  • 랭킹 집계에는 시간이 소요되므로 랭킹 보상 지급이 지연될 수 있습니다.

랭킹보상 받은 리스트 받아오기

랭킹보상을 받은 리스트를 가져옵니다.

동기

GetRankRewardList ( ) -> BackendReturnObject;

// example
Backend.Rank.GetRankRewardList();

비동기

GetRankRewardList ( Function callback ) -> void

// example
Backend.Rank.GetRankRewardList( ( callback ) => 
{
    // 이후 처리
});

결과값 예시

{
    rows:
    [
        {
            content:{ // 내용 "{랭킹명} + 보상"
                S: "최고점수 보상"
            },
            expirationDate:{ // 만료 일시
                S: "2018-11-05T00:42:00.427Z"
            },
            inDate:{ // 우편의 indate
                S: "2018-10-29T00:42:00.427Z"
            },
            itemCount: { // 아이템 수량
                N: 1
            },
            item:{ // 보상받은 아이템
                M:{
                    type:{
                        S:"weapon"
                    },
                    item:{
                        S:"sword"
                    },
                    attack:{
                        S:"100"
                    },
                    defense:{
                        S:"20"
                    },
                    num:{
                        N:"1"
                    }
                }
            },
            sentDate:{ // 보낸 일시
                S: "2018-10-29T00:42:00.402Z"
            },
            receiverNickname:{ // 수신인 닉네임 
                S: "customid2"
            },
            title:{ // 제목 "{랭킹명} + 보상"
                S:"최고점수 보상"
            }
        },
        ...
    ]
}

랭킹 보상 수령하기

랭킹 보상 리스트에 있는 보상을 수령습니다.

  • 발송일로부터 7일 후, 만료되어 랭킹 보상 목록에서 더이상 확인할 수 없습니다.
  • 수령 후, 랭킹 보상 목록에서 자동으로 삭제되며, returnValue를 통해 어떤 아이템을 수령하는지 확인 할 수 있습니다.
  • 클라이언트에서 이 아이템을 수령인의 게임정보에 업데이트 하는 과정이 필요합니다.

동기

ReceiveRankReward ( string rewardPostIndate ) -> BackendReturnObject

// example
Backend.Rank.ReceiveRankReward ( "rewardPostIndate" ); 

비동기

ReceiveRankReward ( string rewardPostIndate, Function callback ) -> void

// example
Backend.Rank.ReceiveRankReward( "rewardPostIndate", ( callback ) => 
{
    // 이후 처리
});

Parameters

ValueTypeDescription
rewardPostIndateString수령할 랭킹보상의 indate

결과값 예시

{
    // 받은 아이템 
    item:
    {
        M:
        {
            type:{ S:"weapon" },
            item:{ S:"sword" },
            attack:{ S:"100" },
            defense:{ S:"20" },
            num:{ N:"1" }
        }
    },
    // 아이템 수량
    itemCount:{
        N: 1
    }
}

Return Cases

  • indate가 유효하지 않은 경우
    statusCode : 404
    errorCode : NotFoundException
    message : post not found, post을(를) 찾을 수 없습니다

랭킹 보상 삭제

랭킹 보상 리스트에 있는 특정 항목을 삭제합니다.

동기

DeleteRankReward ( string rewardPostIndate ) -> BackendReturnObject

// example
Backend.Rank.DeleteRankReward ( "rewardPostIndate" );

비동기

DeleteRankReward ( string rewardPostIndate, Function callback ) -> void

// example
Backend.Rank.DeleteRankReward( "rewardPostIndate", ( callback ) => 
{
    // 이후 처리
});

Parameters

ValueTypeDescription
rewardPostIndatestring삭제할 랭킹보상의 indate

Error case

  • indate가 유효하지 않은 경우
    statusCode : 404
    errorCode : NotFoundException
    message : post not found, post을(를) 찾을 수 없습니다