개요

공유 모듈은 게임에 맞춤형 정보의 모바일QQ/위챗 채팅(친구 및 그룹 포함), 스페이스, 모멘트에 공유할 수 있는 기능을 제공하며, 주로 초대, 나눠 갖기, 하트 보내기, 이벤트 공유 등에 활용도비니다. Tencent 관계 사슬의 MSDK 공유 기능을 통해 모바일QQ, 위챗 관계 사슬의 장점을 충분히 발휘할 수 있고 효과적으로 사용자와 접촉할 수 있어, 새로운 가입 및 재방문을 늘리고 게임 활약도를 높이며 게임 플레이 방법을 확장하기에 편리합니다.

공유 방식 및 공유 내용이 다르므로, 공유 환경은 구조화 공유, 음악 공유, 대형 이미지 공유, 백엔드 공유, 링크 공유(위챗 한정), 모바일QQ 공유(Android 한정), 모바일QQ 동영상 공유(Android 한정), 위챗 미니앱에서의 공유 등으로 분류됩니다.

(./res/share_struct_qq_c.png)

(./res/share_struct_wx_c.png)

이것은 전통적인 왼쪽에 이미지가 있고 오른쪽에 문자가 있는 공유 형식으로, 각 부분의 내용은 아래와 같습니다.

제목: 공유 파라미터 title을 지정하며, 게임은 공유 기능 또는 유형에 따라 자체 정의합니다.
개요: 공유 파라미터 desc를 지정하며, 주로 공유 목적의 간략한 설명에 사용됩니다.
썸네일: 공유 파라미터 imgUrl 또는 imgData를 지정하며, 일반적으로 게임의 icon입니다.
리틀테일(小尾巴): 일반적으로 게임 icon 및 게임 이름으로 구성되며, 클릭하면 게임을 풀하게 되며, 게임 운영 매니저가 모바일QQ, 위챗 게임 센터에 연락할 수 있습니다.

1 MSDK 공유 환경 및 공유 목표

1) 구조화 공유

구조화 공유는 모바일QQ/위챗을 풀업해야 채팅 및 QQ 스페이스에서 공유 가능하며 위챗 모멘트에서는 공유할 수 없습니다.

(./res/share_struct_qq.png)

(./res/share_struct_wx.png)

2) 대형 이미지 공유

구조화 공유는 모바일QQ/위챗을 풀업해야 채팅 및 QQ 스페이스에서 공유 가능하며 위챗 모멘트에서는 공유할 수 없습니다.

(./res/share_photo_qq.png)

(./res/share_photo_wx.png)

3) 음악 공유

구조화 공유는 모바일QQ/위챗을 풀업해야 채팅 및 QQ 스페이스에서 공유 가능하며 위챗 모멘트에서는 공유할 수 없습니다. 음악 정보를 클릭하면 직접 음악을 재생하거나 음악 웹페이지로 이동해 재생할 수 있습니다.

4) 백엔드 공유

백엔드 공유는 모바일QQ/위챗을 풀하지 않아도 되며, 직접 게임 내 호출 인터페이스에서 같이 플레이하는 친구들과 공유할 수 있습니다.

a) 위챗의 백엔드 공유 정보는 친구와의 채팅 시에 표시됩니다.
b) 모바일QQ의 백엔드 공유 정보는 모바일QQ의 공공 계정dls “QQ 모바일 게임”에서 타겟 플레이어에게 표시됩니다.

(./res/share_backend_qq.png)

(./res/share_backend_wx.png)

주의: 수신자 측에서 “QQ 모바일 게임” 공공 계정에 주의를 기울여야 수신할 수 있으며, 동일한 사용자가 같은 날에 동일한 게임에서 수신하는 것은 약 20건의 정보입니다.

5) 위챗 링크 공유

위챗 링크 공유는 위챗을 풀업해서 공유해야 하며, 정보를 클릭하면 웹페이지가 열립니다.

(./res/share_url_wx.png)

6) 모바일 QQ 사진(富图) 공유

모바일QQ 사진 공유는 모바일QQ를 풀업하여 다양한 사진을 QQ 스페이스에서 공유할 수 있습니다. 복수의 사진(9장 이하의 사진은 슈어슈어(说说)에 게시, 9장 초과할 경우에는 앨범에 업로드)을 업로드할 수 있으며, gif 이미지도 지원됩니다.

7) 모바일 QQ 동영상 공유

모바일QQ 동영상 공유는 모바일QQ을 풀업하여 로컬 동영상을 QQ 스페이스에서 공유할 수 있습니다.

(./res/share_video.png)

액세스 내비게이션

1 사전 요구 사항

a) 초기화 모듈 설명에 따라 초기화를 완료했습니다.
b) 귀하의 게임 공유 권한이 개통되었음을 확인합니다. 게임 등록 후 귀하의 게임 카테고리에 따라 상응하는 권한을 개통하고, 귀하께서 로그인 인터페이스를 호출해 "-303, no permission"을 회신하시려면, MSDK 통합 및 테스트 지원 담당자에게 연락해 주십시오.
c) 사용자 모바일QQ/위챗 인증 등록 확인

2 Demo 예시를 참고하십시오.

모바일 QQ 공유 예시는 Assets\Example\MsdkDemo.cs 스크립트의 ShowQQ() 메소드 내 공유 부분을 참조하십시오.

위챗 공유 예시는 Assets\Example\MsdkDemo.cs 스크립트의 ShowWC() 메소드 내 공유 부분을 참조하십시오.

3 인터페이스의 버튼 결합

인터페이스의 버튼 결합에 대해서는 로그인 모듈의 인터페이스 내비게이션 3단계를 참조하십시오. 공유 인터페이스 호출 예시는 다음과 같습니다.

public void ClickedShare()
{
    // 버튼을 클릭한 후 MSDK 공유 인터페이스 호출
    string title = "QQ 공유-title";
    string desc = "QQ 공유-desc";
    string imgNetUrl = "http://qzonestyle.gtimg.cn/open_proj/proj_open_v2/ac/home/qrcode.jpg";
    string targetUrl = "http://gamecenter.qq.com/gcjump?game_tag=MSG_INVITE&plat=qq&pf=invite" +
        "&appid=100703379&from=androidqq&" + "uin=182849215&originuin=61793295&platformId=qq_m" +
        "&sid=Ac0o-208NGD3k3FNCv3J4Q4f&gamedata=gamedata&platformdata=platformdata";
    WGPlatform.Instance.WGSendToQQ(eQQScene.QQScene_QZone, title, desc, targetUrl, imgNetUrl, imgNetUrl.Length);
}

다양한 공유 인터페이스의 예시는, 이어지는 각 인터페이스에 대한 설명의 코드 예시 부분을 참조하십시오.

4 검색 실행 결과

Unity 중간 상단의 삼각형 아이콘을 클릭해 PC 환경 하에서 프로그램을 실행한 후에 Game 화면의 버튼을 클릭합니다.

(./res/share_button2.png)

먼저 로그인을 클릭해 승인 로그인한 후 공유를 클릭해 공유합니다. 이때 Console을 확인하면 다음과 같은 로그인 인터페이스 호출 성공 및 콜백한 로그를 보게 됩니다.

(./res/share_button3.png)

마지막으로, 설치 패키지를 열고 휴대전화기에 설치하면 로그인 버튼이 표시된 후에 모바일QQ를 풀업하고 로그인 승인을 마칩니다. 공유 버튼을 다시 클릭한 후에 모바일QQ를 풀업해 공유를 완료한 후에 모바일QQ 채팅 또는 스페이스에서 공유 결과를 확인합니다.

5 이 모듈의 다른 인터페이스 호출

앞의 1-4 단계를 완료하면 이 모듈에 완벽하게 액세스한 것이 되며, 이 모듈의 다른 인터페이스를 호출할 수 있으며 추가적인 설정은 필요없습니다. 이 모듈의 각 부분에 대한 설명은 다음과 같습니다.

구조화 공유: 구조화 공유는 모바일QQ/위챗을 풀업해야 하며, 공유 디스플레이는 왼쪽에 이미지 오른쪽에 문자가 오는 형식입니다.
대형 이미지 공유: 대형 이미지 공유는 모바일QQ/위챗을 풀업해야 하며, 공유 디스플레이는 1장의 이미지입니다.
음악 공유: 음악 공유는 모바일QQ/위챗을 풀업해야 하며, 공유 디스플레이는 왼쪽에 이미지 오른쪽에 문자가 오는 형식이고, 이미지를 클릭하면 음악을 직접 플레이하거나 링크로 이동해 음악을 재생합니다.
백엔드 공유: 백엔드 공유는 모바일QQ/위챗을 풀하지 않아도 되며, 직접 게임 내 호출 인터페이스에서 같이 플레이하는 친구들과 공유할 수 있습니다.
위챗 링크 공유: 위챗 링크 공유는 위챗을 풀업해서 공유해야 하며, 정보를 클릭하면 웹페이지가 열립니다.
모바일QQ 사진 공유: 모바일QQ 사진 공유는 모바일QQ를 풀업하여 다양한 사진을 QQ 스페이스에서 공유할 수 있습니다.
모바일QQ 동영상 공유: 모바일QQ 동영상 공유는 모바일QQ을 풀업하여 로컬 동영상을 QQ 스페이스에서 공유할 수 있습니다.
모바일QQ 게임 센터 상세 정보 페이지: 모바일QQ 게임 상세 정보 페이지는 모바일QQ에서 우수 게임에 대하여 게임 센터에서 상세 정보 페이지를 디스플레이할 수 있게 해 주는 기능으로, 해당 페이지를 이용해 다운로드, 디스플레이, 게임으로 이동 등의 기능을 제공할 수 있습니다.
위챗 게임 존에 공유: **게임이 제공하는 이미지 데이터를 내장 브라우저를 통해 위챗 게임 존에 공유하는 것으로, 현재 이미지 데이터 크기는 512KB를 초과할 수 없습니다.

구조화 공유

1 종합 설명

구조화 공유는 모바일QQ/위챗을 풀업해야 채팅 및 QQ 스페이스에서 공유 가능하며 위챗 모멘트에서는 공유할 수 없습니다.

2 콜백

1) 기능 설명

MSDK의 공유 콜백을 받기 위해서는 콜백 이벤트 ShareEvent를 등록하고 ShareRet에 따라 처리해야 합니다.

2) 인터페이스 선언

public delegate void ShareDelegate(ShareRet shareRet);

3) 파라미터 설명

4) 반환값

없음

5) 예시 코드

MsdkEvent.Instance.ShareEvent += (ShareRet shareRet) =>
{
    switch (ret.flag)
    {
        case eFlag.eFlag_Succ: 
        // TODO GAME 공유 성공
           break;
        case eFlag.eFlag_QQ_UserCancel: 
        case eFlag.eFlag_WX_UserCancel: 
        case eFlag.eFlag_WX_NotInstall: 
        default: 
        // TODO GAME 공유 실패
           break;
     }
};

6) 특수 설명

없음

7) 용어 해석

없음

3 위챗 구조화 공유

1) 기능 설명

WGSendToWeixin 인터페이스를 호출해서 구조화 정보를 위챗 채팅에서 공유할 수 있습니다.

2) 인터페이스 선언

void WGSendToWeixin(
    string title,
    string desc,
    string mediaTagName,
    byte[] imgData,
    int imgDataLen,
    string messageExt
	string userOpenId  //버전 3.3.0에서 추가됨
);

3) 파라미터 설명

4) 반환값

없으며, 공유 결과는 ShareEvent 콜백을 통해 게임에 반환합니다.

5) 예시 코드

string title = "위챗 공유-title";
string desc = "위챗 공유-desc";
string mediaTagName = "MSG_INVITE";
byte[] imgData = imgData;
int imgDataLen = imgData.Length;
string extinfo = "SendToWeixin_extInfo";
string userOpenId = "HDSAKDFCJS63HC7ZWZOS837HSE"
WGPlatform.Instance.WGSendToWeixin (title, desc, mediaTagName, imgData, imgDataLen, messageExt,userOpenId );

6) 특수 설명

파라미터 messageExt는 공유 후에 플레이어가 클릭했을 때 게임으로 돌아갈 수 있습니다. 구체적인 과정: 플레이어 A가 위챗 정보(messageExt 매개변수 보유)를 플레이어B와 공유하고, 플레이어B가 클릭해 수신하는 이 정보로 게임을 풀하면, 플레이어B의 게임 클라이언트는 콜백 이벤트WakeupEvent(WakeupRet wakeupRet), WakeupEvent의 wakeupRet.messageExt는 플레이어A가 공유할 때 전달한 messageExt 파라미터가 됩니다. WakeupEvent의 등록은 다른 계정 처리를 참조하십시오.

7) 용어 해석

없음

4 모바일QQ Android 구조화 공유

1) 기능 설명

WGSendToQQ 인터페이스를 호출해 구조화 정보를 모바일QQ 채팅, 스페이스에서 공유할 수 있습니다.

2) 인터페이스 선언

void WGSendToQQ(
    eQQScene scene,
    string title,
    string desc,
    string targetUrl,
    string imgUrl,
    int imgUrlLen
);

3) 파라미터 설명

4) 반환값

없으며, 공유 결과는 ShareEvent 콜백을 통해 게임에 반환합니다.

5) 예시 코드

string title = "QQ 공유-title";
string desc = "QQ 공유-desc";
string imgNetUrl = "http://qzonestyle.gtimg.cn/open_proj/proj_open_v2/ac/home/qrcode.jpg";
string targetUrl = "http://gamecenter.qq.com/gcjump?game_tag=MSG_INVITE&plat=qq&pf=invite" +
    "&appid=100703379&from=androidqq&"+"uin=182849215&originuin=61793295&platformId=qq_m" +
    "&sid=Ac0o-208NGD3k3FNCv3J4Q4f&gamedata=gamedata&platformdata=platformdata";
WGPlatform.Instance.WGSendToQQ (eQQScene.QQScene_QZone, title, desc, targetUrl, imgNetUrl, imgNetUrl.Length);

6) 특수 설명

a) Url은 모바일QQ 게임 센터 상세 정보 페이지 링크를 입력할 경우, 정보를 클릭하면 게임을 풀업하여 자체 정의 파라미터로 돌아갈 수 있습니다. 상세 정보는 모바일QQ 게임 센터 상세 정보 페이지QGameCenter를 참조하십시오.#

b) imgUrl이 로컬 이미지 경로일 경우, 이 로컬 이미지는, sdcard 저장 영역(/storage/sdcard0)과 같은 모바일QQ/위챗에서 방문 가능한 위치에 둘 수 있습니다.

7) 용어 해석

없음

5 모바일QQ iOS 구조화 공유

1) 기능 설명

WGSendToQQ 인터페이스를 호출해 구조화 정보를 모바일 채팅에서 공유할 수 있습니다.

2) 인터페이스 선언

void WGSendToQQ(
    eQQScene scene,
    string title,
    string desc,
    string targetUrl,
    byte[] imgData,
    int imgDataLen
);

3) 파라미터 설명

4) 반환값

없으며, 공유 결과는 ShareEvent 콜백을 통해 게임에 반환합니다.

5) 예시 코드

string title = "QQ 공유-title";
string desc = "QQ 공유-desc";
string imgNetUrl = "http://qzonestyle.gtimg.cn/open_proj/proj_open_v2/ac/home/qrcode.jpg";
string targetUrl = "http://gamecenter.qq.com/gcjump?game_tag=MSG_INVITE&plat=qq&pf=invite&" +
    "appid=100703379&from=androidqq&"+"uin=182849215&originuin=61793295&platformId=qq_m&" +
    "sid=Ac0o-208NGD3k3FNCv3J4Q4f&gamedata=gamedata&platformdata=platformdata";
WGPlatform.Instance.WGSendToQQ (eQQScene.QQScene_Session, title, desc, targetUrl, imgData, imgData.Length);

6) 특수 설명

a) Url은 모바일QQ 게임 센터 상세 정보 페이지 링크를 입력할 경우, 정보를 클릭하면 게임을 풀업하여 자체 정의 파라미터로 돌아갈 수 있습니다. 상세 정보는 모바일QQ 게임 센터 상세 정보 페이지QGameCenter를 참조하십시오.#

7) 용어 해석

없음

6 고급 용법

1) 기능 설명

게임은 구조화 정보 공유 시에 일련의 자체 정의 정보(문자열)를 추가할 수 있으며, 다른 플레이어가 이 정보를 클릭하면 게임을 자동으로 풀업하여 추가한 자체 정의 정보를 OnWakeupNotify를 통해 게임에 투명 전송할 수 있습니다. 이 기능은 오프라인 친구 배틀에 사용할 수 있으며, 전투 룸에 신속히 진입해 게임을 플레이할 수 있습니다. 예:

a) 플레이어A가 1개의 배틀 룸11을 개설하고 이때 플레이어B는 오프라인임

b) A는 1개의 QQ/Wechat 구조화 정보(룸 번호 11 및 A의 openid emd와 같은 자체 정의 정보 추가)를 B와 공유합니다.

c) B가 QQ/WeChat 내에서 이 정보를 클릭하면, 이때 게임을 풀업하여 추가한 정보(룸 번호 11 및 A의 openid 등)를 게임 클라이언트와 공유할 수 있습니다.

d) 게임은 추가한 룸 번호 11 및 A의 openid 등의 정보에 근거해, B로 하여금 A의 배틀 룸 11에 신속히 진입하게 하고, 두 플레이어는 배틀을 시작할 수 있습니다.

2) 파라미터 설명

WeChat은 인터페이스 WGSendToWeixin 내의 messageExt 파라미터를 통해 자체 정의 정보를 투명 전송할 수 있습니다.

QQ는 인터페이스 WGSendToQQ 내 targetUrl을 통해 게임 센터 상세 정보 페이지의 Url로 설정하고 gamedata 파라미터를 추가해 자체 정의 정보를 투명 전송할 수 있습니다. 예:

게임 센터 상세 정보 페이지 Url:

http://gamecenter.qq.com/gcjump?appid=100703379&pf=invite&from=androidqq&
plat=qq&originuin=111&ADTAG=gameobj.msg_invite

Url 내에 자체 정의 정보 ”CustomData”를 추가합니다.

http://gamecenter.qq.com/gcjump?appid=100703379&pf=invite&from=androidqq&
plat=qq&originuin=111&ADTAG=gameobj.msg_invite&gamedata=CustomData

3) 예시 코드

구조화 정보 공유 및 자체 정의 정보 추가:

#if UNITY_ANDROID
WGPlatform.Instance.WGSendToQQ (eQQScene.QQScene_Session, title, desc, targetUrl, imgLocalUrl, imgLocalUrl.Length);
#else
WGPlatform.Instance.WGSendToQQ (eQQScene.QQScene_Session, title, desc, targetUrl, imgData, imgData.Length);
#endif

정보 공유 시작을 클릭해 추가한 자체 정의 정보를 수신 및 처리합니다.

MsdkEvent.Instance.WakeupEvent += (WakeupRet ret) =>
{
    Debug.Log(ret.ToString());
    string gameCustomData = "";
    if ((int)ePlatform.ePlatform_QQ == ret.platform) {
        List<KVPair> extInfo = ret.extInfo;
        foreach(KVPair pair in extInfo) {
            if ("gamedata".Equals(pair.key)) {
                gameCustomData = pair.value;
                break;
            }
        }
    } else if ((int)ePlatform.ePlatform_Weixin == ret.platform) {
        gameCustomData = ret.messageExt;
    }
    ......
}

대형 이미지 공유

1 종합 설명

구조화 공유는 모바일QQ/위챗을 풀업해야 채팅 및 QQ 스페이스에서 공유 가능하며 위챗 모멘트에서는 공유할 수 없습니다.

2 콜백

구조화 공유 콜백

3 위챗 대형 이미지 공유 - 이미지 데이터

1) 기능 설명

WGSendToWeixinWithPhoto 인터페이스를 호출해 대형 이미지 정보를 위챗 채팅, 모멘트에서 공유할 수 있습니다.

2) 인터페이스 선언

void WGSendToWeixinWithPhoto(
    eWechatScene scene,
    string mediaTagName,
    byte[] imgData,
    int imgDataLen,
    string messageExt,
    string messageAction
);

3) 파라미터 설명

4) 반환값

없으며, 공유 결과는 ShareEvent 콜백을 통해 게임에 반환합니다.

5) 예시 코드

string title = "위챗 공유-title";
string desc = "위챗 공유-desc";
string mediaTagName = "MSG_INVITE";
byte[] imgData = imgData;
int imgDataLen = imgData.Length;
string messageExt = "SendToWeixin_extInfo";
string messageAction = "WECHAT_SNS_JUMP_APP";
WGPlatform.Instance.WGSendToWeixinWithPhoto(eWechatScene.WechatScene_Session, mediaTagName, imgData, imgDataLen, messageExt, messageAction);

6) 특수 설명

없음

7) 용어 해석

없음

4 위챗 Android 대형 이미지 공유 - 이미지 경로

1) 기능 설명

Android 플랫폼에서 이미지 데이터의 대형 이미지 공유할 경우, 대형 이미지 데이터가 11MB를 초과할 경우, 일부 모델에서는 공유에 실패할 수 있으며, WGSendToWeixinWithPhotoPath 인터페이스를 사용해 고해상도 대형 이미지를 공유할 수 있습니다.

2) 인터페이스 선언

void WGSendToWeixinWithPhotoPath(
    eWechatScene scene,
    string mediaTagName,
    string imgPath,
    string messageExt,
    string messageAction
);

3) 파라미터 설명

4) 반환값

없으며, 공유 결과는 ShareEvent 콜백을 통해 게임에 반환합니다.

5) 예시 코드

string mediaTagName = "MSG_INVITE";
string imgLocalUrl = "/storage/sdcard0/test.png";
string messageExt = "SendToWeixin_extInfo";
string messageAction = "WECHAT_SNS_JUMP_APP";
WGPlatform.Instance.WGSendToWeixinWithPhotoPath(eWechatScene.WechatScene_Session, mediaTagName, imgLocalUrl, messageExt, messageAction);

6) 특수 설명

없음

7) 용어 해석

없음

5 모바일QQ Android 대형 이미지 공유

1) 기능 설명

WGSendToQQWithPhoto 인터페이스를 호출해 대형 이미지 정보를 모바일QQ 채팅, 스페이스에서 공유할 수 있습니다.

2) 인터페이스 선언

void WGSendToQQWithPhoto(eQQScene scene, string imgFilePath);

3) 파라미터 설명

4) 반환값

없으며, 공유 결과는 ShareEvent 콜백을 통해 게임에 반환합니다.

5) 예시 코드

string imgLocalUrl = "/storage/sdcard0/test.png";
WGPlatform.Instance.WGSendToQQWithPhoto (eQQScene.QQScene_Session, imgLocalUrl);

6) 특수 설명

imgFilePath는 로컬 이미지 경로일 경우, 이 로컬 이미지는, sdcard 저장 영역(/storage/sdcard0)과 같은 모바일QQ에서 방문 가능한 위치에 둘 수 있습니다.

7) 용어 해석

없음

6 모바일QQ iOS 대형 이미지 공유

1) 기능 설명

WGSendToQQWithPhoto 인터페이스를 호출해 대형 이미지 정보를 모바일QQ 채팅, 스페이스에서 공유할 수 있습니다.

2) 인터페이스 선언

void WGSendToQQWithPhoto(
    eQQScene scene,
    byte[] imgData,
    int imgDataLen
);

3) 파라미터 설명

4) 반환값

없으며, 공유 결과는 ShareEvent 콜백을 통해 게임에 반환합니다.

5) 예시 코드

byte[] imgData = imgData;
int imgDataLen = imgData.Length;
WGPlatform.Instance.WGSendToQQWithPhoto(eQQScene.QQScene_Session,imgData, imgDataLen);

6) 특수 설명

없음

7) 용어 해석

없음

백엔드 공유

1 종합 설명

백엔드 공유는 모바일QQ/위챗을 풀하지 않아도 되며, 직접 게임 내 호출 인터페이스에서 같이 플레이하는 친구들과 공유할 수 있습니다.

2 콜백

구조화 공유 콜백

3 위챗 백엔드 공유

1) 기능 설명

WGSendToWXGameFriend 인터페이스를 호출해서 정보를 위챗 채팅에서 공유할 수 있습니다.

2) 인터페이스 선언

bool WGSendToWXGameFriend(
    string fOpenId,
    string title,
    string desc,
    string mediaId,
    string messageExt,
    string mediaTagName,
    string msdkExtInfo
);

3) 파라미터 설명

4) 반환값

false: 파라미터가 옳지 않아 공유 요청을 보낼 수 없음, true: 공유 요청 발송 성공.

공유 결과는 ShareEvent 콜백을 통해 게임에 반환합니다.

5) 예시 코드

string openid= "oGRTijtmfQK5iU9-QQ4Jx-7cvrwA";
string title = "WX 공유-title";
string desc = "WX 공유-desc";
string mediaId = "";
string mediaTagName = "MSG_INVITE";
string messageExt = "messageExt";
string msdkExtInfo = "msdkExtInfo";
WGPlatform.Instance.WGSendToWXGameFriend(openid, title, desc, mediaId, messageExt, mediaTagName, msdkExtInfo);

6) 특수 설명

없음

7) 용어 해석

없음

4 모바일QQ 백엔드 공유

1) 기능 설명

WGSendToQQGameFriend 인터페이스를 호출해 정보를 모바일QQ 공공 계정인 “QQ모바일 게임”을 통해 대상 사용자와 공유할 수 있습니다.
비주: 공유하는 콘텐츠는 모바일QQ 상에 있어야 볼 수 있으며, PC QQ 상에서는 볼 수 없습니다. 수신자 측에서 “QQ 모바일 게임” 공공 계정에 주의를 기울여야 수신할 수 있으며, 동일한 사용자가 매일 최대 5건을 받을 수 있고, 동일한 사용자에게서 수신하는 것은 매일 최대 3건입니다.
모바일QQ 백엔드 공유는 새로운 액세스 절차를 제공하며, 새 게임 액세스 시에 다음 절차에 따라 액세스(이미 온라인된 게임에 영향 없음)하며, 다음 절차는 모두 Tencent의 대응하는 인터페이스 인원에게 연락해 도킹해야 합니다.
(1) 백엔드 공유 권한 개통 신청
(2) 이미지 및 문안을 v_diqicai(蔡迪琪: 차이디치)에 제공
(3) appid 및 gametag를 AMS 절차에 새롭게 추가하고, v_diqicai(蔡迪琪: 차이디치)에 연락해 등록
(4) v_diqicai(蔡迪琪: 차이디치)에 연락해 1개의 테스트용 게임 센터 상세 정보 페이지(이후에 정식 상세 정보 페이지로 수정 가능)
(5) 인터페이스 액세스 완료 후 공유 성공 여부 검증

2) 인터페이스 선언

bool WGSendToQQGameFriend(
    int act,
    string fOpenid,
    string title,
    string desc,
    string targetUrl,
    string imgUrl,
    string previewText,
    string gameTag,
    string msdkExtInfo
);

3) 파라미터 설명

4) 반환값

false: 파라미터가 옳지 않아 공유 요청을 보낼 수 없음, true: 공유 요청 발송 성공. 공유 결과는 ShareEvent 콜백을 통해 게임에 반환합니다.

5) 예시 코드

string openid = "D51F963BA3E2571ABD8244D95F9B9AD0";
string title = "QQ 공유-title";
string desc = "QQ 공유-desc";
string previewText = "";
string gameTag = "MSG_FRIEND_EXCEED";
string msdkExtInfo = "msdkExtInfo";
string imgNetUrl = "http://qzonestyle.gtimg.cn/open_proj/proj_open_v2/ac/home/qrcode.jpg";
string targetUrl = "http://gamecenter.qq.com/gcjump?game_tag=MSG_INVITE&plat=qq&pf=invite&" +
    "appid=100703379&from=androidqq&"+"uin=182849215&originuin=61793295&platformId=qq_m&" +
    "sid=Ac0o-208NGD3k3FNCv3J4Q4f&gamedata=gamedata&platformdata=platformdata";
WGPlatform.Instance.WGSendToQQGameFriend (1, openid, title, desc, targetUrl, imgNetUrl, previewText, gameTag, msdkExtInfo);

6) 특수 설명

수신자 측에서 “QQ 모바일 게임” 공공 계정에 주의를 기울여야 수신할 수 있으며, 동일한 사용자가 같은 날에 동일한 게임에서 수신하는 것은 약 20건의 정보입니다.

7) 용어 해석

없음

백엔드 그룹 공유

1 종합 설명

게임 길드/연맹 내에서 사용자는 구조화 정보를 위챗 길드 그룹과 직접 공유할 수 있습니다. 게임에서 해당 인터페이스에 기초해 일련의 라화(拉活) 앱의 솔루션을 만듭니다. 호출 인터페이스는 WGSendToWXGroup이며, 결과는 일반적인 ShareEvent 공유를 통해 게임에 콜백합니다.

2 콜백

구조화 공유 콜백

3 백엔드를 위챗 그룹에서 공유

1) 기능 설명

이 인터페이스는 위챗 풀업을 필요로 하지 않으며, 플레이어가 이미 가입한 길드 위챗 그룹에서 직접 공유할 수 있습니다.

2) 인터페이스 선언

void WGSendToWXGroup(
    int msgType,
    int subType,
    string unionid,
    string title,
    string description,
    string messageExt,
    string mediaTagName,
    string imgUrl,
    string msdkExtInfo
);

3) 파라미터 설명

4) 반환값

없으며, 공유 결과는 ShareEvent 콜백을 통해 게임에 반환합니다.

5) 예시 코드

string unionId = "110";
string title = "WX 공유-title";
string desc = "WX 공유-desc";
string messageExt = "messageExt";
string mediaTagName = "MSG_INVITE";
string imgNetUrl = "http://qzonestyle.gtimg.cn/open_proj/proj_open_v2/ac/home/qrcode.jpg";
string msdkExtInfo = "msdkExtInfo";

WGPlatform.Instance.WGSendToWXGroup(1, 1, unionId, title, desc, messageExt, mediaTagName, imgNetUrl, msdkExtInfo);

6) 특수 설명

a) 인터페이스는 길드 id를 참조해야 하므로 이 길드는 위챗 그룹에 바인딩되어야 정보를 공유할 수 있습니다. b) 이 플레이어는 먼저 길드 그룹에 가입해야 정보를 공유할 수 있습니다. 상세 정보는 그룹 모듈

7) 용어 해석

없음

음악 공유

1 종합 설명

구조화 공유는 모바일QQ/위챗을 풀업해야 채팅 및 QQ 스페이스에서 공유 가능하며 위챗 모멘트에서는 공유할 수 없습니다. 음악 정보를 클릭하면 직접 음악을 재생하거나 음악 웹페이지로 이동해 재생할 수 있습니다.

2 콜백

구조화 공유 콜백

3 위챗 음악 공유

1) 기능 설명

WGSendToWeixinWithMusic 인터페이스를 호출해 음악 정보를 위챗 채팅과 모멘트에서 공유할 수 있습니다.

2) 인터페이스 선언

void WGSendToWeixinWithMusic(
    eWechatScene scene,
    string title,
    string desc,
    string musicUrl,
    string musicDataUrl,
    string mediaTagName,
    byte[] imgData,
    int imgDataLen,
    string messageExt,
    string messageAction
);

3) 파라미터 설명

4) 반환값

없으며, 공유 결과는 ShareEvent 콜백을 통해 게임에 반환합니다.

5) 예시 코드

string title = "WX 공유-title";
string desc = "WX 공유-desc";
string mediaTagName = "MSG_INVITE";
string messageExt = "messageExt";
string messageAction = "WECHAT_SNS_JUMP_URL";
string musicUrl = "http://y.qq.com/i/song.html?songid=1135734&source=qq";
string musicDataUrl = "http://wiki.dev.4g.qq.com/v2/cry.mp3";
WGPlatform.Instance.WGSendToWeixinWithMusic(eWechatScene.WechatScene_Session, title, desc, musicUrl, musicDataUrl, mediaTagName, imgData, imgData.Length, messageExt, messageAction);

6) 특수 설명

없음

7) 용어 해석

없음

4 모바일QQ 음악 공유

1) 기능 설명

WGSendToQQWithMusic 인터페이스를 호출해 음악 정보를 모바일QQ 채팅과 스페이스에서 공유할 수 있습니다.

2) 인터페이스 선언

void WGSendToQQWithMusic(
    eQQScene scene,
    string title,
    string desc,
    string musicUrl,
    string musicDataUrl,
    string imgUrl
);

3) 파라미터 설명

4) 반환값

없으며, 공유 결과는 ShareEvent 콜백을 통해 게임에 반환합니다.

5) 예시 코드

string title = "QQ 공유-title";
string desc = "QQ 공유-desc";
string imgNetUrl = "http://qzonestyle.gtimg.cn/open_proj/proj_open_v2/ac/home/qrcode.jpg";
string musicUrl = "http://y.qq.com/i/song.html?songid=1135734&source=qq";
string musicDataUrl = "http://wiki.dev.4g.qq.com/v2/cry.mp3";
WGPlatform.Instance.WGSendToQQWithMusic(eQQScene.QQScene_QZone,title, desc, musicUrl, musicDataUrl, imgNetUrl);

6) 특수 설명

imgUrl이 로컬 이미지 경로일 경우, 이 로컬 이미지는, sdcard 저장 영역(/storage/sdcard0)과 같은 모바일QQ에서 방문 가능한 위치에 둘 수 있습니다.

7) 용어 해석

없음

위챗 링크 공유

1 종합 설명

위챗 링크 공유는 위챗을 풀업해서 공유해야 하며, 정보를 클릭하면 웹페이지가 열립니다.

2 콜백

구조화 공유 콜백

3 위챗 링크 공유

1) 기능 설명

WGSendToWeixinWithUrl 인터페이스를 호출해 음악 정보를 위챗 채팅과 모멘트에서 공유할 수 있습니다.

2) 인터페이스 선언

void WGSendToWeixinWithUrl(
    eWechatScene scene,
    string title,
    string desc,
    string url,
    string mediaTagName,
    byte[] imgData,
    int imgDataLen,
    string messageExt
	string userOpenId  //이 매개 변수는 버전 3.3.0부터 추가되었습니다.
);

3) 파라미터 설명

4) 반환값

없으며, 공유 결과는 ShareEvent 콜백을 통해 게임에 반환합니다.

5) 예시 코드

string title = "WX 공유-title";
string desc = "WX 공유-desc";
string mediaTagName = "MSG_INVITE";
string messageExt = "messageExt";
string targetUrl = "http://www.qq.com";
string userOpenId "";
WGPlatform.Instance.WGSendToWeixinWithUrl(eWechatScene.WechatScene_Timeline, title, desc,
        targetUrl, mediaTagName, imgData, imgData.Length, messageExt, userOpenId);

6) 특수 설명

없음

7) 용어 해석

없음

모바일 QQ 사진(富图) 공유

1 종합 설명

모바일QQ 사진 공유는 모바일QQ를 풀업하여 다양한 사진을 QQ 스페이스에서 공유할 수 있습니다. 복수의 사진(9장 이하의 사진은 슈어슈어(说说)에 게시, 9장 초과할 경우에는 앨범에 업로드)을 업로드할 수 있으며, gif 이미지도 지원됩니다.

2 콜백

구조화 공유 콜백

3 모바일 QQ 사진(富图) 공유

1) 기능 설명

WGSendToQQWithRichPhoto 인터페이스 호출을 통해 모바일QQ를 풀업한 후 여러 장의 이미지(gif 애니메이션 포함)를 QQ스페이스에 업로드할 수 있습니다.

2) 인터페이스 선언

void WGSendToQQWithRichPhoto(string summary, ArrayList imgs);

3) 파라미터 설명

4) 반환값

없으며, 공유 결과는 ShareEvent 콜백을 통해 게임에 반환합니다.

5) 예시 코드

string img1 = "/storage/sdcard0/test.png";
string img2 = "/storage/sdcard0/test2.png";
string img3 = "/storage/sdcard0/test3.png";
ArrayList imgs = new ArrayList();
imgs.Add(img1);
imgs.Add(img2);
imgs.Add(img3);
string summary = "내 게임 최고의 순간";
WGPlatform.Instance.WGSendToQQWithRichPhoto(summary, imgs);

6) 특수 설명

이미지 그룹 내 로컬 이미지는 sdcard 저장 영역(/storage/sdcard0)과 같은 모바일QQ에서 방문 가능한 위치에 둡니다.

7) 용어 해석

없음

모바일 QQ 동영상 공유

1 종합 설명

모바일QQ 동영상 공유는 모바일QQ을 풀업하여 로컬 동영상을 QQ 스페이스에서 공유할 수 있습니다.

2 콜백

구조화 공유 콜백

3 모바일 QQ 동영상 공유

1) 기능 설명

WGSendToQQWithVideo 인터페이스를 호출해 모바일QQ를 통해 동영상 정보를 QQ스페이스에서 공유할 수 있습니다.

2) 인터페이스 선언

void WGSendToQQWithVideo(string summary, string videoPath);

3) 파라미터 설명

4) 반환값

없으며, 공유 결과는 ShareEvent 콜백을 통해 게임에 반환합니다.

5) 예시 코드

string summary = "내 게임 최고의 순간";
string myVideo = "/storage/sdcard0/cry.mp4";
WGPlatform.Instance.WGSendToQQWithVideo(summary, myVideo);

6) 특수 설명

videoPath가 나타내는 로컬 동영상은 sdcard 저장 영역(/storage/sdcard0)과 같은 모바일QQ/에서 방문 가능한 위치에 둡니다.

7) 용어 해석

없음

모바일 QQ 게임 센터 상세 정보 페이지

1 종합 설명

모바일QQ 게임 상세 정보 페이지는 모바일QQ에서 우수 게임에 대하여 게임 센터에서 상세 정보 페이지를 디스플레이할 수 있게 해 주는 기능으로, 해당 페이지를 이용해 다운로드, 디스플레이, 게임으로 이동 등의 기능을 제공할 수 있으며, 사용 전에 게임 운영 매니저가 모바일QQ 게임 센터에서 설정해야 합니다. 모바일QQ에서 공유하는 targetUrl 파라미터는, 모바일QQ 게임 센터 상세 정보 페이지 링크를 입력할 경우, 해당 공유 정보를 클릭했을 때 이 게임의 게임 센터 상세 정보 페이지로 이동할 수 있으며, 그런 다음 자동으로 게임이 풀업됩니다.

게임 센터 상세 정보 페이지 링크 예시:

http://gamecenter.qq.com/gcjump?appid=100703379&pf=invite&plat=qq&from=androidqq&
ADTAG=gameobj.msg_invite&originuin=61793295&gamedata=gamedata&platformdata=platformdata;

필드 규칙:

로그 상태 보유:

정보 공유를 클릭해 게임을 풀업해야 할 경우(또는 게임 센터에서 게임 기동), 등록 상태를 보유하며, 게임 운영 매니저가 모바일QQ 게임 센터에서 설정해야 합니다.

자체 정의 파라미터 회신:

게임이 모바일QQ 공유 시, 자체 정의 파라미터는 다른 한 사람의 플레이어가 정보 공유를 클릭해 게임을 풀업할 때 게임 클라이언트에 회신될 수 있습니다. 이 기능을 활용해, 게임에서 온라인 상태가 아닌 플레이어를 오프라인 채팅 등의 플레이 방법으로 초대할 수 있습니다. 모바일QQ 공유 시 targetUrl 파라미터에 모바일QQ 게임 센터 상세 정보 페이지를 입력할 경우, 선택 가능한 platformdata 또는 gamedata 필드에서 게임 자체 정의 파라미터를 입력할 수 있습니다. 플레이어가 이 정보 공유창을 클릭하면, 게임 풀업 시에 게임 클라이언트가 리마인더 콜백 WakeupEven을 수신할 수 있고, wakeupRet는 모바일QQ 게임 센터 상세 정보 페이지 링크 내 platformdata 및 gamedata 필드를 투명 전송합니다.

자체 정의 파라미터 추출 예시:

MsdkEvent.Instance.WakeupEvent += (WakeupRet ret) =>
{
    // TODO GAME
    string platformdata, gamedata;
    List<KVPair> pairs = ret.extInfo;
    foreach(KVPair pair in pairs)  
    {
        if (pair.key.Equals("platformdata"))
        {
            platformdata = pair.value;
        }
        if (pair.key.Equals("gamedata"))
        {
            gamedata = pair.value;
        }
    }
}

그중에서 WakeupEvent의 등록은 다른 계정 처리를 참조하십시오.

위챗 게임 존에서 공유(2.17.0 이상 ㅂ전)

1) 기능 설명

사용자가 내장 브라우저를 통해 위챗 게임 존을 열고 이미지와 문자를 위챗 게임 존에서 공유할 수 있게 해 줍니다.

2) 인터페이스 선언

void WGShareToWXGameline(byte[] data, string gameExtra);

3) 파라미터 설명

4) 반환값

콜백 없음.

5) 예시 코드

byte[] data = new byte[]{0} //이미지 데이터
WGPlatform.Instance.WGShareToWXGameline(data,"파라미터");

6) 특수 설명

이미지 데이터의 크기는 512KB를 초과할 수 없으며, 이를 초과하는 이미지는 게임 자체에서 압축 처리합니다.

7) 명칭 해석

없음

위챗 DeepLink

1) 기능 설명

위챗 DeepLink는 게임 내에서 WGOpenWeiXinDeeplink 인터페이스를 호출해 직접 위챗을 풀업하고 위챗 게임 센터 페이지, 상세 정보 페이지, 게임 데이터베이스 및 자체 정의 URL로 이동할 수 있는 기능을 가리키며, DeepLink 기능의 개통 및 설정을 위해서는 위챗 게임 센터로 연락하셔야 합니다. MSDK2.12.0 버전부터 이 기능을 제공합니다.

2) 인터페이스 선언

void WGOpenWeiXinDeeplink(string link);

3) 파라미터 설명

4) 반환값

없음.

5) 예시 코드

WGPlatform.Instance.WGOpenWeiXinDeeplink("INDEX");

6) 특수 설명

1. DeepLink 기능은 위챗 게임 센터로 연락해 개통 및 설정해야 합니다.

2. 자체 정의 URL은 위챗 게임 센터에서 먼저 설정을 마쳐야 하며 호출 인터페이스에서 전달하는 파라미터 문자와 완전히 일치해야 합니다. 위챗 게임 센터에서 “http://www.qq.com/”을 설치한 경우, 인터페이스 link 파라미터는 “http://www.qq.com/”를 전송해야 하며, “http://www.qq.com”을 전송하면 실패할 수 있습니다.

7) 용어 해석

없음

위챗 - 미니 앱 공유

1) 기능 설명

위챗은 미니앱에 기초해 새로운 특성의 공유 기능을 제공합니다.

2) 인터페이스 선언

void WGSendToWXWithMiniApp(const eWechatScene &scene,
                            const unsigned char *title,
                            const unsigned char *desc,
                            const unsigned char *thumbImgData,
                            const int  &thumbImgDataLen,
                            const unsigned char *webpageUrl,
                            const unsigned char *userName,
                            const unsigned char *path,
                            bool  withShareTicket,
                            const unsigned char *messageExt,
                            const unsigned char *messageAction,
							const unsigned char *mediaTagName ,//이 매개 변수는 버전 3.3.0부터 추가되었습니다.
                            const eMiniProgramType  type,//이 매개 변수는 버전 3.3.0부터 추가되었습니다.
                            const unsigned char *userOpenId  //이 매개 변수는 버전 3.3.0부터 추가되었습니다.);

3) 파라미터 설명

4) 반환값

설정된 글로벌 콜백의 OnShareNotify(ShareRet& shareRet) 콜백을 통해 데이터를 게임으로 반환하면, shareRet.flag 값이 반환 상태를 표시합니다. 가능한 값과 설명은 다음과 같습니다. 
eFlag_Succ: 공유 성공
eFlag_Error: 공유 실패

5) 예시 코드

WGPlatform::GetInstance()->WGSendToWXWithMiniApp(WechatScene_Session,
                                                     (unsigned char*)"미니앱 공유 테스트",
                                                     (unsigned char*)"테스트하세요",
                                                     (unsigned char*)data,
                                                     (int)dataLens,
                                                     (unsigned char*)"https://www.baidu.com",
                                                     (unsigned char*)"gh_e9f675597c15",
                                                     (unsigned  char*)"page/indexSelAddr/index",
                                                     true,
                                                     (unsigned char*)"",
                                                     (unsigned char*)""
													 (unsigned char *)"MSG_INVITE",
                                                     ProgramType_Release，
                                                     (unsigned char*)"");

6) 특수 설명

공유를 시작하는 App과 미니앱이 같은 위챗 오픈 플랫폼 계정에 속해 있는 것을 요구합니다. 
위챗 클라이언트 버전이 6.5.8보다 낮을 경우, 미니앱 유형 공유는 자동으로 웹사이트 유형 공유로 변환됩니다. 개발자는 웹페이지 링크 필드를 입력하여 낮은 버전의 클라이언트가 정상적으로 웹페이지 링크를 열 수 있도록 해야 합니다. 
미니앱의 초기 ID 획득 방법: 미니앱 백그라운드-설정-기본 설정- 계정 정보로 이동하십시오.

7) 용어 해석

없음

동영상 위챗 모멘트 공유

1) 기능 설명

위챗 측에서 제공하는 게임 동영상을 위챗 모멘트 기능에서 공유합니다.

2) 인터페이스 선언

void WGSendToWeixinWithVideo(const eWechatScene &scene,
                              const unsigned char *title,
                              const unsigned char *desc,
                              const unsigned char *thumbUrl,
                              const unsigned char *videoUrl,
                              VideoParams  &videoParams,
                              const unsigned char *mediaTagName,
                              const unsigned char *messageAction,
                              const unsigned char *messageExt);

3) 파라미터 설명

4) 반환값

설정된 글로벌 콜백 OnShareNotify(ShareRet& shareRet) 콜백을 통해 데이터를 게임으로 반환하면, shareRet.flag 값이 반환 상태를 표시합니다. 가능한 값과 설명은 다음과 같습니다. eFlag_Succ: 공유 성공 eFlag_Error: 공유 실패

5) 예시 코드

FILE* mp4File = fopen((const char*)"test_video.mp4","rb");
    if(mp4File == NULL)
        return;
    fseek(mp4File, 0L, SEEK_END);
    long size = ftell(mp4File);
    byte* mp4Buf = new byte[size+ 1];
    fseek(mp4File,0x0L,SEEK_SET);
    fread(mp4Buf, sizeof(mp4Buf[0]), size, mp4File);
    fclose(mp4File);

    unsigned char* sVideoData = mp4Buf;
    int iVideoLen = (int)size;

    VideoParams videoParam;
    videoParam.android_videoPath = sVideoPath;

    WGPlatform::GetInstance()->WGSendToWeixinWithVideo(WechatScene_Timeline,
                                                       (unsigned char*)"게임 동영상",
                                                       (unsigned char*)"제왕의 영광의 시간",
                                                       (unsigned char*)"http://vweixinthumb.tc.qq.com/150/20250/snsvideodownload?filekey=30270201010420301e02020096040253480410d97d9ca5a4001348336662c5b432e50b020261820400&hy=SH&storeid=32303137303431373039343430323030306130393635613562303238613436663561333230613030303030303936&bizid=1023",
                                                       (unsigned char*)"http://shzjwxsns.video.qq.com/102/20202/snsvideodownload?filekey=30270201010420301e02016604025348041086277b0fa88402549570698994b49289020310eefe0400&hy=SH&storeid=32303137303530383038353035323030303832333037626533333166346336613965333230613030303030303636&bizid=1023",
                                                       videoParam,
                                                       (unsigned char*)"MSG_SHARE_MOMENT_VIDEO",
                                                       (unsigned char*)"MESSAGE_ACTION_SNS_VIDEO#gameseq=1491995805&GameSvrEntity=87929&RelaySvrEntity=2668626528&playersnum=10",
                                                       (unsigned char*)"msgExt");

6) 특수 설명

• 위챗 모멘트 동영상 공유 기능
• 동영상 형식은 현재 mp4만을 지원하며, 크기는 10M 초과 불가, 시간은 최대 10초로 Android는 현재 크기 3M 초과 불가.
• 너비와 높이는 1:2에서 3:1 사이이며 FPS는 30 초과 불가
• 동영상은 모멘트에서만 공유 가능(scene 값은 WXSceneTimeLine)

7) 용어 해석

없음

텍스트를 QQ존에 공유하기

1) 기능 설명

WGSendToQQWithText 인터페이스를 호출하여 텍스트를 QQ존에 공유 가능합니다. 3.3.0버전부터 해당 인터페이스를 새롭게 추가하였습니다.

2) 인터페이스 선언

void WGSendToQQWithText(unsigned char* text, unsigned char* extraScene, unsigned char* messageExt);

3) 파라미터 설명

4) 반환값

없음. 공유 결과는 OnShareNotify 콜백을 통해 게임에로 리턴합니다.

5) 예시 코드

WGPlatform::GetInstance()->WGSendToQQWithText((unsigned char*)"text",
																																													(unsigned char *)"1",
																																													(unsigned char *)"msdk");

6) 특수 설명

없음

7) 명칭 해석

없음

미니앱 작동

1) 기능 설명

WGLaunchMiniApp 인터페이스를 호출하여 미니앱을 작동 가능합니다. 3.3.0 버전부터 해당 인터페이스가 추가됩니다.

2) 인터페이스 선언

void WGLaunchMiniApp(const unsigned char *userName,
																															         const unsigned char *path,
																															         const eMiniProgramType &type);

3) 파라미터 설명

4) 반환값

없음

5) 예시 코드

WGPlatform::GetInstance()->WGLaunchMiniApp((unsigned char*)"gh_eaef65657c15",
																																											 (unsigned char*)"page/indexSelAddr/index",
																																								             ProgramType_Release);

6) 특수 설명

없음

7) 명칭 해석

없음

모바일 QQ ARK공유

1 종합 설명

ARK공유는 모바일 QQ를 통해 채팅에 공유하는 것으로, ARK공유는 APP ID를 제공하여 모바일 QQ 화이트 리스트에 추가한 후, 모바일 QQ팀과 구체적인 프로토콜에 대해 논의를 해야 합니다.

2 콜백

구조화 공유의 콜백 내용을 참고 바랍니다.

3 모바일 QQ ARK 공유

1) 기능 설명

WGSendToQQWithArk인터페이스를 콜백하여, ARK메세지를 모바일 QQ 채팅창에 공유 가능

2) 인터페이스 선언

void WGSendToQQWithArk(
						   const eQQScene& scene,
                           unsigned char* title,
                           unsigned char* desc,
                           unsigned char* url,
                           unsigned char* imgUrl,
                           unsigned char* jsonString
                           );

3) 파라미터 설명

4) 반환값

없음, 공유 결과는WGPlatformObserver를 통해 OnShareNotify함수 콜백하여, 게임 되돌아오기.

5) 예시 코드

WGPlatform::GetInstance()->WGSendToQQWithArk((eQQScene)cScene, 
                    (unsigned char *)"it's title",
                    (unsigned char *)"it's desc", 
                    (unsigned char *)"https://speed.gamecenter.qq.com/pushgame/v1/detail?appid=100703379&_wv=2164260896&_wwv=448&autodownload=1&autolaunch=1&autosubscribe=1&ADTAG=gameobj.msg_invite&gamedata=gamedata", 
                    (unsigned char *)"http://q.qlogo.cn/qqapp/100703379/C1BF66286792F24E166C9A5D27CFB519/100",
                    (unsigned char*)""{"app":"com.tencent.gamecenter.gameshare","view":"noDataView","desc":"템플릿설명","prompt":"메시지 프롬프트","ver":"0.0.0.1","config":{"type":"normal"},"meta":{"shareData":{"appid":"1104466820","type":"image","url":"http%3a%2f%2fimgcache.qq.com%2fclub%2fmars%2fimg_upload%2fgc843_wzgame.png","width":601,"height":330,"buttons":[{"text":"TA의 기록","url":"http%3a%2f%2fcdn.vip.qq.com"}]}}}"";

6) 특수 설명

비고:정상적으로 해당 기능을 사용하기 위해, 개발자에서 아셔야 할 내용:

(1)QQ클라이언트 8.0.0 이전 버전에서, ARK 공유 실패 시, 자동으로 구조화 메세지를 통해 공유를 진행하도록 전환. 파라미터 입력: title,desc,url,imgUrl은 구조화 메세지의 파라미터이기도 합니다. ARK공유 성공 시, title,desc,url,imgUrl 작용이 없습니다.

(2)QQ클라이언트 8.0.0 버전부터, ARK파라미터는 반드시 정확하게 입력해야 하며, 미입력 시, 성공적으로 ARK형태의 정보를 공유할 수 없습니다. 만약 오류 시, 공유 실패

(3)ARK 공식 관리 측에서 게임을 가입해야 하며 ARK카드 리소스를 제공해야 합니다. 리소스 심사 후 게임에 대해 해당 권한이 부여됩니다. 관리측 사이트: http://arkapp.oa.com:8080/app_light/dst/index.html#/ (해당 사이트는 내부 네트워크에서 방문해야 하며, 텐센트 담당자님께서 협조하여 처리할 수 있으며, 카드 심사와 관련된 구체적인 내용은 ARK_Helper에 문의 바랍니다)

(4)IOS의 비 ARK가 TIM에서 공유할 시, scheme중 tim을 추가해야 합니다: 경로는 아래와 같습니다: IOS의 Info.plist 중, Information Property List -> LSApplicationQueriesSchemes에 tim 추가

ARK클라이언트 공유는 모바일 QQ 게임 센터와 논의하여 연결해야 하며, 상세 절차는 하기 내용을 참고 바랍니다.

http://km.oa.com/group/39817/articles/show/375226 (해당 절차 파일은 내부 네트워크를 통해 열람이 가능하며, 관련 담당자님이 게임 센터와 논의를 진행해야 합니다. 게임 센터 담당자: zealzhuang、v_shxizhong）

7) 명칭 해석

없음