랭킹 보상 받기
콘솔에서 지정한 랭킹 보상을 확인하고 받고 삭제하는 기능입니다.
랭킹에 등록된 유저들에게 랭킹 보상을 보내는 시점
- 랭킹 보상은 해당 랭킹의 집계가 완료되는 시점에 유저들에게 지급합니다.
- 랭킹 집계는 랭킹이 초기화 된 후 시작합니다.
- 뒤끝 베이스 일반 랭킹이 초기화 되는 시점은 오전 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
Value | Type | Description |
---|---|---|
rewardPostIndate | String | 수령할 랭킹보상의 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
Value | Type | Description |
---|---|---|
rewardPostIndate | string | 삭제할 랭킹보상의 indate |
Error case
- indate가 유효하지 않은 경우
statusCode : 404
errorCode : NotFoundException
message : post not found, post을(를) 찾을 수 없습니다