MSDK WIKI

개요

관계 사슬 모듈은 MSDK에서 제공하며, 모바일QQ, 위챗의 친구 관계를 기초로 하는 정보 검색 서비스입니다. 관계 사슬 모듈은 다음과 같은 기능 환경을 제공합니다.

1) 개인 정보 검색 (PersonInfo): 닉네임(nickname), OpenId(openId), 성별(gender), 소형 프로필 사진 40x40(pictureSmall), 중간 크기 프로필 사진 60x60(pictureMiddle), 대형 프로필 사진100x100(pictureLarge), 출신 성(지역)(province), 도시(city)

주: 모바일QQ에는 제한이 있기 때문에, 프로필 사진 반환에는 40x40 및 100x100 두 유형만 있으며, 모바일QQ의 설정은 중간 사이즈 사진도 40x40 사이즈로 반환합니다.

2) 친구 정보 찾기: 플레이한 적이 있는 현재 게임의 친구 정보만 검색할 수 있으며, 각 친구의 상세 정보는 해당 개인의 상세 정보(PersonInfo)와 동일합니다.

3) QQ 친구 추가: 게임 내에서 당사의 인터페이스인 QQ 친구 추가를 통해 친구 추가 기능을 수행할 수 있습니다.

다음 환경에서 개인 정보 검색, 친구 정보 검색 기능을 이용할 수 있습니다.

4) 게임 순위 (예: [검협정연] 친구 순위)

QQ 친구 순위 호출 인터페이스: WGQueryQQGameFriendsInfo

기능1: WGQueryQQGameFriendsInfo를 호출해 함께 플레이하는 QQ 친구의 데이터를 획득합니다.

기능2: 선물하기: 백엔드 공유 기능 중 하나로, 그 특징은 모바일QQ를 풀업하지 않고도 서비스 클라잉언트를 통해 직접 친구와 공유할 수 있으며, 공유 모듈 “모바일QQ 백엔드 공유”를 참조할 수 있습니다.

기능3: 모바일QQ 함께 플레이하는 친구 게임 입구

기능4: 친구 초대하기: QQ 채팅에서 공유할 수 있는 기능으로, 공유 모듈 “QQ 구조화 공유”를 참조하실 수 있습니다.

위챗 친구 순위 호출 인터페이스: WGQueryWXGameFriendsInfo

기능1: WGQueryWXGameFriendsInfo를 호출해 함께 플레이하는 위챗 친구의 데이터를 획득합니다.

기능2: 선물하기: 백엔드 공유 기능 중 하나로, 그 특징은 위챗을 풀업하지 않고도 서비스 클라잉언트를 통해 직접 친구와 공유할 수 있으며, 공유 모듈 “위챗 백엔드 공유”를 참조할 수 있습니다.

기능3: 위챗 함께 플레이하는 친구 게임 입구

기능4: 친구 초대하기: 위챗 채팅에서 공유할 수 있는 기능으로, 공유 모듈 “위챗 구조화 공유”를 참조하실 수 있습니다.

5) 친구 추가

액세스 내비게이션

1 사전 요구 사항

1) 초기화 모듈 설명에 따라 초기화를 완료했습니다.

2) 사용자 모바일QQ/위챗 인증 등록 확인

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

1) 모바일QQ 친구 예시는 Assets\Example\MsdkDemo.cs 스크립트의 ShowQQ() 메소드를 참조하십시오.

2) 위챗 친구 예시는 Assets\Example\MsdkDemo.cs 스크립트의 ShowWX() 메소드를 참조하십시오.

3 인터페이스의 버튼 결합

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

using UnityEngine;
using System.Collections;
// Step1 MSDK 라이브러리 리퍼런스
using Msdk; 

public class ClickTest : MonoBehaviour {

    void Start () {
        // Step2 PC 테스트 디버깅 환경 사용 여부 설정
        WGPlatform.SetPCDebug(true);
        // Step3 MSDK 관계 사슬 콜백 설정
        MsdkEvent.Instance.RelationEvent += RelationCallback;
        // Step4 MSDK 초기화
        WGPlatform.Instance.Init();
    }

    // Button 결합해야 하는 메소드, 이름은 임의로 정할 수 있음
    public void Clicked()
    {
        // 버튼 클릭 후에 MSDK를 호출해 QQ 같은 게임 플레이 친구 인터페이스 획득
       WGPlatform.Instance.WGQueryQQGameFriendsInfo();
    }

    // MSDK 관계 사슬 콜백
    public void RelationCallback(RelationRet ret)
    {
        // 관계 사슬 검색 성공
        switch (ret.type)
            {
                case (int)eRelationRetType.eRet_QueryMyInfo: 
                    // 개인 정보
                    break;
                case (int)eRelationRetType.eRet_QueryGameFriends: 
                    // 친구 정보
                    break;
            }
    }
}

4 검색 실행 결과

걸색 결과 운용에 대해서는, 로그인 모듈의 인터페이스 내비게이션 4단계를 참조하십시오.

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

1) 개인 정보 검색: 모바일QQ 위챗 사용자 개인 정보 검색.

2) QQ 친구 검색: 사용자가 게임 내에서 msdk 인터페이스를 호출해 QQ 친구를 추가하게 할 수 있습니다.

개인 정보 검색

1. 종합 설명

1) 모바일QQ 사용자(WGQueryQQMyInfo) 사용자가 모바일QQ 승인 후에, 게임에서 사용자의 닉네임, 프로필 사진 등의 기타 정보를 필요로 하며, WGQueryQQMyInfo를 호출할 수 있습니다. 다음과 같은 개인 정보가 포함됩니다. 닉네임(nickname), OpenId(openId), 성별(gender), 소형 프로필 사진(pictureSmall), 중간 크기 프로필 사진(pictureMiddle), 대형 프로필 사진(pictureLarge).

2) 위챗 사용자(WGQueryWXMyInfo) 사용자가 위챗 승인 후에, 게임에서 사용자의 닉네임, 프로필 사진 등의 기타 정보를 필요로 하며, WGQueryWXMyInfo를 호출할 수 있습니다. 다음과 같은 개인 정보가 포함됩니다. OpenId(openId), 닉네임(nickname), OpenId(openId), 성별(gender), 소형 프로필 사진(pictureSmall), 중간 크기 프로필 사진(pictureMiddle), 대형 프로필 사진(pictureLarge), 출신 성(지역)(province 위챗 한정), 도시(city 위챗 한정)

2. 콜백

1) 기능 설명

msdk의 관계 사슬 콜백을 수신하기 위해, 게임에서 등록하고 콜백 처리할 필요가 있으므로, 게임의 Awake 함수 내에서의 등록을 권장합니다.

2) 인터페이스 선언

public delegate void RelationDelegate(RelationRet ret);

3) 파라미터 설명

없음

4) 반환값

반환값 명칭	유형	설명
ret	RelationRet	관계 사슬 구조체

5) 예시 코드

MsdkEvent.Instance.RelationEvent += (RelationRet ret) => {
    Debug.Log(ret.ToString());
    if (ret.flag == eFlag.eFlag_Succ) {
        // 관계 사슬 검색 성공
    } else {
        // 관계 사슬 검색 실패
    }
};

6) 특수 설명

개인 정보 내에 OpenId 정보가 없을 경우, 필요한 OpenId 정보는 로그인 모듈이 획득한 토큰 인터페이스 WGGetLoginRecord를 통해 획득할 수 있습니다. 개인 정보 검색 및 같이 플레이하는 친구 검색 콜백은 RelationRet.type를 통해 구분할 수 있습니다.

7) 용어 해석

없음

3. 호출 인터페이스

1) 기능 설명

게임에서 WGQueryQQMyInfo/WGQueryWXMyInfo 인터페이스 호출을 통해 개인 정보를 검색해 다음 정보를 얻을 수 있습니다.: 닉네임(nickname), OpenId(openId), 성별(gender), 소형 프로필 사진 40x40(pictureSmall), 중간 크기 프로필 사진 60x60(pictureMiddle), 대형 프로필 사진100x100(pictureLarge), 출신 성(지역)(province 위챗 한정), 도시(city 위챗 한정)

2) 인터페이스 선언

Viod WGQueryQQMyInfo();
Viod WGQueryWXMyInfo();

3) 파라미터 설명

없음

4) 반환값

없으며, 결과는 RelationEvent를 통해 콜백하며, 콜백 설정은 등록 콜백을 참조하십시오.

5) 예시 코드

WGPlatform.Instance.WGQueryQQMyInfo(); // 모바일QQ 사용자 개인 정보 검색
WGPlatform.Instance.WGQueryWXMyInfo(); // 위챗 사용자 개인 정보 검색

6) 특수 설명

개인 정보 내에 OpenId 정보가 없을 경우, 필요한 OpenId 정보는 로그인 모듈이 획득한 토큰 인터페이스 WGGetLoginRecord를 통해 획득할 수 있습니다.

7) 용어 해석

없음

함께 플레이하는 친구 정보 검색

1. 종합 설명

1) 모바일QQ 사용자(WGQueryQQGameFriendsInfo) 사용자는 모바일QQ 승인 후에 WGQueryQQGameFriendsInfo를 통해 게임 내 친구 정보(친구 점수 순위 등)를 풀업할 수 있습니다. 친구 정보는 개인 정보를 참조합니다.

2) 위챗 사용자(WGQueryWXGameFriendsInfo) 사용자는 위챗 승인 후에 WGQueryWXGameFriendsInfo를 통해 게임 내 친구 정보(친구 점수 순위 등)를 풀업할 수 있습니다. 친구 정보는 개인 정보를 참조합니다.

2. 콜백

해당 인터페이스가 개인 정보 검색 인터페이스와 동일한 콜백을 사용할 경우, 이미 설정되어 있다면 중복 설정할 필요가 없습니다. 설정되어 있지 않은 경우에는 콜백 설정 RelationRet 대상의 persons 속성이 하나의 List인지 확인하고, 그중에서 각 PersonInfo 대상이 친구 정보입니다. 친구 정보에는 다음 사항들이 포함됩니다. OpenId(openId), 닉네임(nickname), OpenId(openId), 성별(gender), 소형 프로필 사진 40x40(pictureSmall), 중간 크기 프로필 사진 60x60(pictureMiddle), 대형 프로필 사진100x100(pictureLarge), 출신 성(지역)(province), 도시(city)

3. 호출 인터페이스

1) 기능 설명

게임에서 WGQueryQQGameFriendsInfo/WGQueryWXGameFriendsInfo 인터페이스 호출을 통해 해당 게임을 플레이하는 친구의 개인 정보를 검색해 다음 정보를 얻을 수 있습니다.: 닉네임(nickname), OpenId(openId), 성별(gender), 소형 프로필 사진 40x40(pictureSmall), 중간 크기 프로필 사진 60x60(pictureMiddle), 대형 프로필 사진100x100(pictureLarge), 출신 성(지역)(province 위챗 한정), 도시(city 위챗 한정)

2) 인터페이스 선언

Void WGQueryQQGameFriendsInfo();
Void WGQueryWXGameFriendsInfo();

3) 파라미터 설명

없음

4) 반환값

없으며, 결과는 RelationEvent를 통해 콜백하며, 콜백 설정은 등록 콜백을 참조하십시오.

5) 예시 코드

WGPlatform.Instance.WGQueryQQGameFriendsInfo(); // 모바일QQ 사용자 친구 정보 검색
WGPlatform.Instance.WGQueryWXGameFriendsInfo(); // 위챗 사용자 친구 정보 검색

6) 특수 설명

1) 개인 정보(예: 프로필 사진, 이름), 친구 정보(예: 프로필 사진, 이름) 획득 실패 시에 게임 로그인 실패를 피하기 위해, 개인 정보를 확인하고 친구 정보 설정이 핵심 경로에 있는지 확인하십시오.

2) 게임 측에서 개인 정보 및 친구 정보 획득 시에 캐시 처리해 매번 로그인 시에 새로운 개인 정보 및 친구 정보를 불러오는 절차를 피하고 위챗 방문 트래픽이 지나치게 많아지지 않도록 할 것을 권장합니다.

3) 모바일QQ에서 검색한 같은 게임을 플레이하는 친구의 결과에는 자신의 정보가 포함되지 않지만, 위챗에서 검색한 같은 게임을 플레이하는 친구의 결과에는 자신의 정보가 포함됩니다.

7) 용어 해석

같은 게임 친구: 현재 게임을 플레이하는 친구 플레이어

비 핵심 경로: 게임 로그인 과정에 영향을 미치지 않는 것을 가리키는 말, MSDK는 모바일QQ/위챗의 로그인 과정을 핵심 경로로 정의하며, 로그인 과정에서 단절되면 해당 게임의 성상적인 진행에 심각한 영향을 미칩니다.

QQ 친구 추가

1) 종합 설명

플레이어는 게임 중에 게임 플레이어를 직접 QQ 친구(여러 차례 클릭해도 여러 건의 QQ 신청을 발송할 수 없음)로 추가할 수 있습니다.

2) 콜백

없음

3. 호출 인터페이스

1) 기능 설명

플레이어는 게임 중에 다른 게임 플레이어를 직접 QQ 친구로 추가할 수 있습니다.

2) 인터페이스 선언

void WGAddGameFriendToQQ(string fopenid, string desc, string message);

3) 파라미터 설명

파라미터 명칭	유형	설명
fopenid	string	친구의 openid를 추가해야 합니다.
desc	string	친구의 비주 정보를 추가해야 합니다.
message	string	친구 추가 시 발송하는 인증 정보

4) 반환값

없음

5) 예시 코드

string openID = "44386ABB2C583E72CF436D3FAD31B323";
WGPlatform.Instance.WGAddGameFriendToQQ (openID, "줄이 끊어진 연", "안녕하세요 저는 <제왕의 영광> 플레이어, 샤오리우라고 해요");

6) 특수 설명

없음

7) 명칭 해석

없음

자주 묻는 질문

|자주 묻는 질문|관계 사슬|Unity3D|