우편 기본 기능

뒤끝은 관리자가 콘솔에서 보낼 수 있는 관리자 우편과, 유저 간의 우편이 존재합니다.

우편 수신 목록 받아오기

관리자와 다른 유저에게서 받은 우편 목록을 확인할 수 있습니다.

  • 관리자 우편은 발신일로부터 콘솔에서 설정한 시간이 지난 후(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"
            }
        },
        ...
    ]
}