Skip to content
This repository has been archived by the owner on Mar 19, 2021. It is now read-only.

Latest commit

 

History

History
153 lines (119 loc) · 5.38 KB

dialog-message_ko.md

File metadata and controls

153 lines (119 loc) · 5.38 KB

#.dialog(info, callback) (메시지를 보내기 위한)

링크, 구조화된 Open Graph 스토리 또는 사진을 당신의 앱에서 유저 그들의 친구에게 메시지를 보냅니다.

iOS나 안드로이드에서 메시지 다이얼로그를 작동합니다. 메시지 다이얼로그는 디바이스에 페이스북 메신져 앱이 설치되어 있어야 합니다. Sharing in iOS과 Sharing in Android에서 상세한 정보를 보실 수 있습니다. 당신의 앱에서 메시지 다이얼로그를 통해 공유가 가능하도록 유저의 페이스북 로그인을 사용할 필요가 없습니다.

웹에서는 유저의 친구에게 링크를 메시지로 보낼 수 있습니다. Send Dialog에서 상세한 정보를 확인하세요.

##파라메터

plugin.FacebookAgent.prototype.dialog = function(info, callback){}
이름 종류 필수 설명
info Object Yes 보낼 컨텐츠.
callback Function No 이 콜백은 결과 코드와 응답 오브젝트 또는 에러 메시지가 적용됩니다.

####info 컨텐츠:

이름 종류 필수 설명
dialog String Yes 당신이 트리거로서 사용하길 원하는 페이스북 다이얼로그의 종류를 결정하는 속성.
Additional properties Various Yes 메시지 다이얼로그 종류에 따른 다양한 추가적 속성에 대한 리스트는 아래를 참고하세요.

####메시지 다이얼로그 종류는 다음 중 하나가 될 수 있습니다:

이름 다이얼로그 종류
message_link 메시지 다이얼로그를 사용해서 유저의 친구에게 링크를 메시지로 보냅니다.
message_photo 메시지 다이얼로그를 사용해서 유저의 친구에게 이미지를 메시지로 보냅니다.
message_open_graph 메시지 다이얼로그를 사용해서 유저의 친구에게 오픈 그래프 스토리를 공유합니다.

####info 오브젝트의 Additional properties를 위한 메시지 다이얼로그 종류:

  1. message_link

    이름 종류 필수 설명
    link String Yes 링크의 URL
    title String No 링크의 제목
    imageUrl String No 링크의 이미지
    description String No 링크의 설명

  2. message_photo

    이름 종류 필수 설명
    photo String Yes 사진의 경로

  3. message_open_graph

    이름 종류 필수 설명
    action_type String Yes 오픈 그래프 액션 종류
    preview_property String No 오픈 그래프 오브젝트 종류
    others Various No 오픈 그래프를 위한 다른 파라메터

##콜백 함수와 응답 오브젝트

콜백 함수를 정의하는 법은 다음과 같습니다. 메시지 전송이 성공했다면, code는 plugin.FacebookAgent.CODE_SUCCEED가 되며, 아닐 경우 에러 코드를 가리키며 response에 에러 메시지가 날아옵니다.

var callback = function (code, response) {}

한편, 응답 오브젝트는 오직 메시지 전송이 성공했을 때만 사용할 수 있으며 각 메시지 다이얼로그 종류에 따른 예제는 다음과 같습니다:

  1. message_link

    // 응답 오브젝트 
{
    // TODO
}

  2. message_photo

    // 응답 오브젝트 
{
    // TODO
}

  3. message_open_graph

    // 응답 오브젝트 
{
    // TODO
}

##Example

  1. message_link

    var info = {
    "dialog": "message_link",
    "description": "Cocos2d-x is a great game engine",
    "title": "Cocos2d-x",
    "link": "http://www.cocos2d-x.org",
    "imageUrl": "http://files.cocos2d-x.org/images/orgsite/logo.png"
};
facebook.dialog(info, function (code, response) {
    if(code == plugin.FacebookAgent.CODE_SUCCEED){
        // 성공
    } else {
        cc.log("Failed to send the message, error #" + code + ": " + response);
    }
});

  2. message_photo

    var info = {
    "dialog": "message_photo",
    "photo": "/User/XXX/Documents/a.png"
};
facebook.dialog(info, function (code, response) {
    if(code == plugin.FacebookAgent.CODE_SUCCEED){
        // 성공
    } else {
        cc.log("Failed to send the message, error #" + code + ": " + response);
    }
});

  3. message_open_graph

    var info = {
    "dialog": "message_open_graph",
    "action_type": "cocostestmyfc:share",
    "preview_property": "cocos_document",
    "title": "Cocos2d-JS Game Engine",
    "image": "http://files.cocos2d-x.org/images/orgsite/logo.png",
    "url": "http://cocos2d-x.org/docs/manual/framework/html5/en",
    "description": "cocos document"
};
facebook.dialog(info, function (code, response) {
    if(code == plugin.FacebookAgent.CODE_SUCCEED){
        // 성공
    } else {
        cc.log("Failed to send the message, error #" + code + ": " + response);
    }
});