우편 기본 기능
뒤끝은 관리자가 콘솔에서 보낼 수 있는 관리자 우편과, 유저 간의 우편이 존재합니다.
우편 수신 목록 받아오기
관리자와 다른 유저에게서 받은 우편 목록을 확인할 수 있습니다.
- 관리자 우편은 발신일로부터 콘솔에서 설정한 시간이 지난 후(1일, 7일, 15일, 30일), 유저 우편은 발신일로부터 15일 후 자동으로 만료되어 리스트에서 삭제됩니다.
- 만료된 유저 우편은 다시 발신인에게 돌아가지 않습니다.
- 각각 최대 50개씩 수신가능하며, 총 100개의 우편을 수신할 수 있습니다.
- 최대 우편보유수가 초과된 우편은 받은 우편함에 표시되지 않습니다.
아이템을 수령해서 삭제되거나(관리자 우편), 아이템을 수동으로 삭제하거나(유저 우편), 유효기간이 만료되어 삭제되면 그 개수만큼 우편함에 출력됩니다. - 유저우편의 수령 여부는 receivedDate 키의 존재 여부로 확인 할 수 있습니다.
- 다국어 지원
- 유저의 국가코드가 존재하고, 콘솔에 해당 국가 이벤트가 등록되어 있는 경우 → 해당 국가의 이벤트 제목과 내용을 리턴합니다.
- 유저의 국가코드가 존재하지 않거나, 콘솔에 해당 국가 이벤트가 등록되어 있지 않은 경우 → 기본 설정의 제목과 내용을 리턴합니다.
SDK 3.9.2 이전 버전에서는 다국어 지원이 적용되지 않으며, country가 key로 리턴됩니다.
동기
GetPostListV2() -> BackendReturnObejct
// example
Backend.Social.Post.GetPostListV2();
비동기
GetPostListV2(Function callback) -> void
// example
Backend.Social.Post.GetPostListV2( ( callback ) =>
{
// 이후 처리
});
결과값 예시
{
// 관리자에게 받은 우편 리스트
fromAdmin:
[
{
content:{ // 우편 내용
S:"1주년 이벤트에 당첨되었습니다.\n재미있는 게임을 사랑해주셔서 감사합니다."
},
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"
}
}
},
reservationDate:{ // 실제 발송 일시
S: "2019-04-11T02:49:37.756Z"
},
sentDate:{ // 보낸 일시
S: "2018-10-29T00:42:00.402Z"
},
receiverNickname:{ // 수신인 닉네임 (optional, 개별우편발송)
S: "customid2"
},
title:{ // 우편 제목
S: "이벤트 당첨!"
}
},
...
],
// 다른 유저에게 받은 우편 리스트
fromUser:
[
{
content:{ // 우편 내용
NULL:true
},
expirationDate:{ // 만료 일시
S:"2018-11-13T00:40:40.579Z"
},
receiverInDate:{ // 수신인 indate
S:"2018-08-10T02:19:59.724Z"
},
receivedDate:{ // 받은 일시 (receiveUserPostItem 호출 이후에 생성)
S:"2018-10-29T07:41:06.718Z"
},
item:{ // 선물받은 아이템
M:{
type:{
S:"cash"
},
diamond:{
N:"2000"
}
}
},
itemLocation:{ // 아이템 위치
M:{
column:{
S:"postingItem"
},
table:{
S:"private_table"
}
}
},
receiverNickname:{ // 수신인 닉네임
S:"customid2"
},
inDate:{ // 우편의 indate
S:"2018-10-29T00:40:40.579Z"
},
senderNickname:{ // 발신인 닉네임
S:"customid"
},
senderInDate:{ // 발신인 indate
S:"2018-09-18T05:21:20.447Z"
},
sentDate:{ // 보낸 일시
S:"2018-10-29T00:40:40.579Z"
},
title:{ // 우편 제목
S:"12345678901234567890"
}
},
...
]
}