Hub/docs/serverAPI/message write

message/write

Description

• 특정 사용자에게 hub 쪽지를 전송한다.

Parameters

• uid: required 쪽지를 전송할 상대의 uid
  • 수신 여러명일때는 uid를 "486,1004,8282" 형식을 사용( ','을 구분자로 함)
• text: required 쪽지 메시지
• picture : 첨부 이미지 URL
  • thumbnail : 첨부 이미지의 썸네일 URL
• 첨부 이미지 전송시에는 picture/thumbnail 모두 전송해야 한다.
• push : 쪽지 받는 사람이 접속한 디바이스에 쪽지 내용을 Push 로 보내는지 여부 (true 로 설정하면 전송, false 로 설정하거나 push 파라미터 자체가 아에 없으면 보내지 않음)
• invite: 게임초대쪽지 사용시, 쪽지에 다운로드 링크가 자동으로 추가되는 여부 (true로 설정하면 text와 다운로드 링크가 함께 전송됨, false로 설정하면 해당사항없음)

타 게임 푸시 전송

• push 옵션과 invite 옵션을 동시에 true로 주면 받는 사람이 플레이하는 타 게임 중 하나에 초대 푸시가 가게 된다.
  • 안드로이드 GCM 에 푸시 확인시 특정 URL 로 이동하는 기능이 있으며, 이를 통해 게임 다운로드 페이지로 유도하게 된다.

• 푸시를 보내게 되는 타 게임을 고르는 옵션은 다음과 같다.
  • 1번 우선순위 : 사업부에서 백오피스로 설정한 우선순위

ex) 타이니팜을 플레이하는 유저가 타이니팜을 플레이하지 않는 유저에게 초대 쪽지를 푸시 옵션과 함께 보냈고, 받는 유저는 골프스타, 히어로즈워, 쿵푸펫이 설치되어 있을 때. 사업부에서 백오피스로 정한 우선순위가 쿵푸펫, 골프스타, 히어로즈워 순이라면 쿵푸펫에 푸시를 보내게 된다.

• • 2번 우선순위 : 가장 마지막에 로그인한 게임에게 보냄

ex) 위와 같은 케이스인데 사업부에서 모든 게임의 우선순위를 동등하게 설정한 경우, 사용자가 마지막으로 허브에 로그인한 게임이 히어로즈워라면 히어로즈워에게 푸시를 보내게 된다.

쪽지를 받는 사용자가 플레이하는 디바이스 중 안드로이드 디바이스에만 푸시를 보내게 된다!! iOS 는 애플 앱스토어 정책 위반 가능성이 있으며, 푸시 클릭시 해당 게임을 다운로드 유도하는 기능 자체가 없기 때문에 푸시를 보내게 된다.

출력 JSON

• uid : 쪽지를 전송한 상대방 UID (string)
  • 수신자가 여러명일때는 받은 uid리스트만 나옴 ( 쪽지수신거부 옵션에 따라서 받지않은 유저는 리스트에 안나옴)
• fbid : 쪽지를 전송한 상대방 UID 사용자가 페이스북이 연동되었을 경우 페이스북 ID (string)
• push_result : 푸시 보냈을 때 전송 여부
• invite_result: 게임초대쪽지 보냈을 때 전송 여부

{
    "type":"message/write",
    "error_code":0,
    "uid":"27881283",
    "fbid": "12716129611",
    "push_result": true,
    "invite_result": true
}

에러 메시지

• 잘못된 요청 형식일 때
  • 자기 자신에게 메시지를 보냈을 경우
  • 첨부 이미지 URL 이 형식에 맞지 않을 경우
  • 첨부 썸네일 이미지 URL 이 형식에 맞지 않을 경우
  • 첨부 이미지 URL 및 썸네일 URL 둘 중 하나가 빠졌을 때

{
    "type":"message/write",
    "error_code":1201,
    "error_msg":"Request has invalid format."
}

• 쪽지 쓰기 실패시

{
    "type":"message/write",
    "error_code":1101,
    "error_msg":"Database error occured."
}

Related Method

• CS_hubAsyncRequest0
• asyncRequest