개요

MSDK 그룹 기능 호출을 통해, 게임 내 방파의 리더 플레이어가 방파를 채팅 그룹과 결합할 수 있습니다. 결합이 해제된 채팅 그룹은 일반 플레이어가 방파의 채팅 그룹에 참가할 수 있으므로, 손쉽게 게임 플레이어 그룹의 상호 작용 환경을 개선할 수 있으며, 플레이어 활약도 및 밀착도 모두를 높일 수 있습니다. 현재 채팅 그룹은 QQ 그룹 및 위챗 그룹이 지원되며, 각 방파 당 최대 1개의 QQ 그룹과 1개의 위챗 그룹을 결합할 수 있습니다.

QQ그룹 결합:

QQ그룹 참가:

QQ그룹 결합 해제:

위챗 그룹 결합:

위챗 그룹 참가:

액세스 내비게이션

사전 요구 사항

1) 이미 MSDK 액세스 설정 모듈 설명에 따라 액세스 설정

2) 이미 MSDK 액세스 로그인 모듈 설명에 따라 액세스 로그인

모바일QQ 그룹 기능

1 개요

먼저 모바일QQ 그룹 기능 콜백을 등록한 후에 권장 절차에 따라 모바일QQ 그룹 기능 인터페이스를 호출하면 모바일QQ 그룹 기능에 액세스할 수 있습니다.

인터페이스 호출 절차는 아래 그림과 같습니다.

모바일QQ 그룹 기능 새 버전 V2(1.3.0u 이상 버전)

1 QQ 그룹 생성 인터페이스 호출(v2)

1) 기능 설명

길드장이 생성합니다. 직접 QQ그룹 인터페이스를 바인딩(binding)후, 결과는 BindGroupEvent를 통해 게임에 콜백합니다.

2) 인터페이스 선언

public void WGCreateQQGroupV2(GameGuild gameGuild);

3) 파라미터 설명

GameGuild: 설정 파라미터 설명

4) 반환값

없음. 그룹 생성 결과는 BindGroupEvent 를 통해 게임에 콜백합니다.

5) 예시 코드:

GameGuild gameGuild = new GameGuild();
gameGuild.guildId = "100703379";
gameGuild.guildName = "msdk";
gameGuild.zoneId = "100";
gameGuild.roleId = "조용한";
gameGuild.partition = "10";
gameGuild.areaId = "123";
WGPlatform.Instance.WGCreateQQGroupV2(gameGuild);

MsdkEvent.Instance.OnCreateGroupV2Event += (GroupRet ret) =>
        {
            Debug.Log(ret.ToString());
            message = ret.ToString();
            if (ret.flag == eFlag.eFlag_Succ)
            {
                // 그룹 바인딩 메시지 생성 
            }
            else
            {
                // 그룹 바인딩 메시지 생성 실패
            }
        };

6) 특수 설명

없음

7) 명칭 해석

없음

2 QQ그룹 관계 검색 인터페이스(v2) 호출

1) 기능 설명

길드에 그룹을 바인딩 후, 해당 인터페이스를 호출하여 유저와 그룹간 멤버십 정보를 조회합니다.유저와 그룹간 멤버십(그룹장, 관리원, 일반 멤버, 비멤버) 정보에 리턴 가능하며, 조회 결과는 QueryGroupEvent를 통해 게임에 콜백합니다.

2) 인터페이스 선언

public void WGQueryQQGroupInfoV2(String groupId);

3) 파라미터 설명

4) 반환값

없음. 조회 결과는 QueryGroupEvent를 통해 게임에 콜백합니다.

5) 예시 코드:

WGPlatform.Instance.WGQueryQQGroupInfoV2("11002222");

MsdkEvent.Instance.QueryGroupInfoV2Event += (GroupRet ret) =>
        {
            Debug.Log(ret.ToString());
            message = ret.ToString();
            if (ret.flag == eFlag.eFlag_Succ)
            {
                // 그룹 정보 쿼리 성공
            }
            else
            {
                // 그룹 정보 쿼리 실패
            }
        };

6) 특수 설명

없음

7) 명칭 해석

없음

3 QQ그룹 참가 인터페이스(v2) 호출

1) 기능 설명

게임내 길드원이 QQ그룹에 가입하는 인터페이스입니다. 해당 인터페이스를 호출하기 전에 우선 WGQueryQQGroupInfoV2 인터페이스를 호출하여 유저가 해당 그룹의 멤버 여부인지를 확인하며, 해당 유저가 비멤버일 경우 그룹 가입 버튼이 출력됩니다.해당 결과는 JoinQQGroupEvent를 통해 게임에 콜백합니다.

2) 인터페이스 선언

함수를 호출 시, 파라미터의 전송 순서에 유의해주시기 바랍니다.

public void WGJoinQQGroupV2(GameGuild gameGuild,String groupId);

3) 파라미터 설명

GameGuild: 설정 파라미터 설명

4) 반환값

없음. 그룹 가입 결과는 JoinQQGroupEvent 를 통해 게임에 콜백합니다.

5) 예시 코드:

groupId = "12345678";
GameGuild gameGuild = new GameGuild();
gameGuild.guildId = "100703379";
gameGuild.zoneId = "100";
gameGuild.roleId = "조용한";
gameGuild.partition = "10";
gameGuild.areaId = "123";
WGPlatform.Instance.WGJoinQQGroupV2(gameGuild,groupId);

MsdkEvent.Instance.OnJoinGroupV2Event += (GroupRet ret) =>
        {
            Debug.Log(ret.ToString());
            message = ret.ToString();
            if (ret.flag == eFlag.eFlag_Succ)
            {
                // 그룹에 가입
            }
            else
            {
                // 그룹 가입 실패
            }
        };

6) 특수 설명

없음

7) 명칭 해석

없음

4 QQ그룹 결합 해제 인터페이스(v2) 호출

1) 기능 설명

인게임에서 QQ그룹을 언바인딩하는 인터페이스입니다. 혹 유저가 길드QQ그룹을 해체하면 길드와 길드QQ그룹은 오토 언바인딩하는것이 아니므로, 그룹 해체시 언바인딩 관련 작업은 FAQ 설명을 참고해주시기 바랍니다. 관련 결과는 UnbindGroupEvent를 통해 게임에 콜백합니다

2) 인터페이스 선언

public void WGUnbindQQGroupV2(GameGuild gameGuild);

3) 파라미터 설명

GameGuild: 설정 파라미터 설명

4) 반환값

없음, 언바인딩 결과는 UnbindGroupEvent 를 통해 게임에 콜백합니다.

5) 예시 코드:

GameGuild gameGuild = new GameGuild();
gameGuild.guildId = "110022";
gameGuild.guildName = "msdk";
gameGuild.zoneid = "1122";
gameGuild.areaId = "123";
WGPlatform.Instance.WGUnbindQQGroupV2(gameGuild);

MsdkEvent.Instance.UnbindGroupV2Event += (GroupRet ret) =>
        {
            Debug.Log(ret.ToString());
            message = ret.ToString();
            if (ret.flag == eFlag.eFlag_Succ)
            {
                // 그룹 언바인딩 성공
            }
            else
            {
                // 그룹 언바인딩 실패
            }
        };

6) 특수 설명

없음

7) 명칭 해석

없음

5 기존 모바일QQ그룹 결합 인터페이스(v2) 호출

1) 기능 설명

길드장은 자기가 생성한 QQ그룹 인터페이스에 길드를 바인딩 가능합니다. 해당 인터페이스를 호출하기 전에 우선 WGGetQQGroupListV2 인터페이스를 호출하여 기존에 생성한 그룹 리스트를 읽어오며, 관련 결과는 BindExistGroupV2Event 를 통해 게임에 콜백합니다.

2) 인터페이스 선언

public void WGBindExistQQGroupV2(GameGuild gameGuild,String groupId,String groupName);

3) 파라미터 설명

GameGuild: 설정 파라미터 설명

4) 반환값

없음. 바인딩 결과는 BindExistGroupV2Event 를 통해 게임에 콜백합니다

5) 예시 코드:

GameGuild gameGuild = new GameGuild();
gameGuild.guildId = "100703379";
gameGuild.roleId = "10"
gameGuild.zoneId = "100";
WGPlatform.Instance.WGBindExistQQGroupV2(gameguild, groupId, groupName);
MsdkEvent.Instance.BindExistGroupV2Event += (GroupRet ret) =>
        {
            Debug.Log(ret.ToString());
            message = ret.ToString();
            if (ret.flag == eFlag.eFlag_Succ)
            {
                // 기존에 생성한 QQ그룹 인터페이스 바인딩 성공
            }
            else
            {
                // 기존에 생성한 QQ그룹 인터페이스 바인딩 실패
            }
        };

6) 특수 설명

파라미터 설명에 따라 적절한 비율로 파라미터를 입력하고 선택 입력 파라미터는 필요에 따라 입력합니다.

7) 명칭 해석

없음

6 결합된 모바일QQ 그룹의 그룹 번호 획득 인터페이스(v2) 호출

1) 기능 설명

모바일QQ그룹에 바인딩한 QQ그룹 메시지를 획득합니다. 길드ID를 통해 QQ그룹의 그룹계정을 읽어오면 그룹이 바인딩됩니다. 그룹을 생성시 길드 명칭을 입력하지 않으면 이때 획득한 QQ그룹명은 비어있습니다. 결과는 GetGroupCodeV2Event 를 통해 게임에 콜백합니다.

2) 인터페이스 선언

public void WGGetQQGroupCodeV2(GameGuild gameGuild);

3) 파라미터 설명

GameGuild: 설정 파라미터 설명

4) 반환값

없음. 결과는 GetGroupCodeV2Event 를 통해 게임에 콜백합니다.

5) 예시 코드:

GameGuild gameGuild = new GameGuild();
gameGuild.guildId = "100703379";
gameGuild.roleId = "10"
gameGuild.zoneId = "100";
WGPlatform.Instance.WGGetQQGroupCodeV2(gameGuild);

MsdkEvent.Instance.GetGroupCodeV2Event += (GroupRet ret) =>
        {
            Debug.Log(ret.ToString());
            message = ret.ToString();
            if (ret.flag == eFlag.eFlag_Succ)
            {
                //길드에 바인딩한 그룹메시지 조회 성공
            }
            else
            {
                //길드에 바인딩한 그룹메시지 조회 실패
            }
        };

6) 특수 설명

파라미터 설명에 따라 적절한 비율로 파라미터를 입력하고 선택 입력 파라미터는 필요에 따라 입력합니다.

7) 명칭 해석

없음

7 그룹 결합된 길드 검색 인터페이스(v2) 호출

1) 기능 설명

그룹ID(그룹계정)를 기반으로 바인딩한 길드 메시지를 조회합니다. 결과는 QueryBindGuildV2Event 를 통해 게임에 콜백합니다.

2) 인터페이스 선언

public void WGQueryBindGuildV2(String groupId, int type);

3) 파라미터 설명

4) 반환값

없음, 결과는 OnQueryBindGuildV2Notify 를 통해 게임에 콜백합니다.

5) 예시 코드:

WGPlatform.Instance.WGQueryBindGuildV2("111002",0)

MsdkEvent.Instance.QueryBindGuildV2Event += (GroupRet ret) =>
        {
            Debug.Log(ret.ToString());
            message = ret.ToString();
            if (ret.flag == eFlag.eFlag_Succ)
            {
                //그룹에 바인딩한 길드 정보 조회 성공
            }
            else
            {
                //그룹에 바인딩한 길드 정보 조회 실패
            }
        };

6) 특수 설명

파라미터 설명에 따라 적절한 비율로 파라미터를 입력하고 선택 입력 파라미터는 필요에 따라 입력합니다.

7) 명칭 해석

없음

8 생성된 QQ그룹 목록 검색 인터페이스(v2) 호출

1) 기능 설명

길드장이 자기가 기존에 생성한 QQ그룹에 길드를 바인딩할 경우, 이미 생성된 QQ그룹 리스트를 조회 시에 사용합니다. 결과는 GetGroupListV2Event 를 통해 게임에 콜백합니다.

2) 인터페이스 선언

public void WGGetQQGroupListV2();

3) 파라미터 설명

없음

4) 반환값

없음，결과는 GetGroupListV2Event 를 통해 게임에 콜백합니다.

5) 예시 코드:

WGPlatform.Instance.WGGetQQGroupListV2();

MsdkEvent.Instance.GetGroupListV2Event += (GroupRet ret) =>
        {
            Debug.Log(ret.ToString());
            message = ret.ToString();
            if (ret.flag == eFlag.eFlag_Succ)
            {
                // 내가 생성한 QQ그룹 리스트 읽어오기
            }
            else
            {
                // 내가 생성한 QQ그룹 리스트 읽어오기 실패
            }
        };

6) 특수 설명

없음

7) 명칭 해석

없음

9 길드 회장 그룹 결합 메시지 인터페이스(v2) 호출

1) 기능 설명

길드에 QQ그룹을 바인딩하지 않았을 경우, 길드원이 길드장에게 바인딩을 리마인딩하는 인터페이스입니다. 내가 생성한 QQ그룹에 길드를 바인딩하면, (위챗) 공식계정 “QQ모바일게임”을 통해 공지를 받으며, 공지는 하루에 1개 만 받아봅니다. 검증 시에 알림자와 피알림자는 반드시 길드원이어야 하며, 게임측에서 ‘피알림자는 길드장’으로 설정해주시기를 요청드립니다. 결과는 RemindGuildLeaderV2Event 를 통해 게임에 콜백합니다.

2) 인터페이스 선언

함수 호출 시에 파라미터 전송 순서에 주의해 주십시오.

public void WGRemindGuildLeaderV2(GameGuild gameGuild);

3) 파라미터 설명

GameGuild: 설정 파라미터 설명

4) 반환값

없음，결과는 RemindGuildLeaderV2Event를 통해 게임에 콜백합니다.

5) 예시 코드:

GameGuild gameGuild = new GameGuild();
gameGuild.guildId = "100703379";
gameGuild.roleId = "12";
gameGuild.roleName = "징징"
gameGuild.zoneId = "100";
gameGuild.leaderOpenid = "78AADD8DC9CF80E655EE68039B1D02C9";
gameGuild.leaderZoneId= "1234";
WGPlatform.Instance.WGRemindGuildLeaderV2 (gameguild);

MsdkEvent.Instance.RemindGuildLeaderV2Event += (GroupRet ret) =>
        {
            Debug.Log(ret.ToString());
            message = ret.ToString();
            if (ret.flag == eFlag.eFlag_Succ)
            {
                // 길드장에게 QQ그룹을 바인딩함을 알림
            }
            else
            {
                // 길드장에게 QQ그룹 바인딩 실패를 알림
            }
        };

6) 특수 설명

파라미터 설명에 따라 적절한 비율로 파라미터를 입력하고 선택 입력 파라미터는 필요에 따라 입력합니다.

7) 명칭 해석

없음

위챗 그룹 기능

1 개요 설명

먼저 위챗 그룹 기능 콜백을 등록한 후에 권장 절차에 따라 위챗 그룹 기능 인터페이스를 호출하면 위챗 그룹 기능에 액세스할 수 있습니다.

인터페이스 호출 절차는 아래 그림과 같습니다.

2) 그룹 정보 검색 콜백 등록

[그룹 정보 검색 결과 콜백)#registGroupQuery) 을 참조하십시오. 모바일QQ와 위챗 그룹 기능은 함께 이 콜백을 이용합니다.

3 위챗 그룹 생성 콜백 등록

1) 기능 설명

위챗 그룹 생성 결과를 게임에 콜백합니다.

2) 인터페이스 선언

public delegate void CreateWXGroupDelegate(GroupRet groupRet);

3) 파라미터 설명

4) 반환값

없음

5) 예시 코드

MsdkEvent.Instance.CreateWXGroupEvent += (GroupRet groupRet) => {
    if (groupRet.flag == eFlag.eFlag_Succ) {
        // 위챗 그룹 생성 성공
    } else {
        // 위챗 그룹 생성 실패
        string msg = handlerWXErrorCode(groupRet);
    }
}
string handlerWXErrorCode(GroupRet groupRet){
    string msg = "";
    if (groupRet.platform == 1)
    {
        int code = groupRet.errorCode;
        if (code == eFlag.eFlag_WX_UserCancel)
        {
            msg = "사용자 취소";
        }
        else if (code == eFlag.eFlag_WX_Group_IDHadCreatedToday)
        {
            msg = "오늘은 이미 그룹을 만들었음. 매일 각 ID 당 1회에 한해 그룹 채팅 생성 가능";
        }
        else if (code == eFlag.eFlag_WX_Group_JoinAmountBeyond)
        {
            msg = "가입 그룹 수 제한 초과. 매일 각 ID 당 2개까지 그룹 가입 가능";
        }
        else if (code == eFlag.eFlag_WX_Group_HasNoAuthority)
        {
            msg = "해당 게임은 그룹 생성 권한이 없음";
        }
        else if (code == eFlag.eFlag_WX_Group_AmountBeyond)
        {
            msg = "그룹 생성 또는 결합 해제 그룹 수 제한 초과. 사용자의 그룹 생성, 또는 그룹 결합 해제는 5개를 초과할 수 없습니다.";
        }
        else if (code == eFlag.eFlag_WX_Group_HadExist)
        {
            msg = "위챗 그룹 이미 있음";
        }
        else if (code == eFlag.eFlag_WX_Group_IDNotExist)
        {
            msg = "그룹 ID 없음";
        }
        else if (code == eFlag.eFlag_WX_Group_ParameterError)
        {
            msg = "파라미터 검색 오류";
        }
        else if (code == eFlag.eFlag_Error)
        {
            msg = "알 수 없는 오류. 위챗 오류 코드를 참조";
        }
    }
    return msg;
}

6) 특수 설명

없음

7) 용어 해석

GroupRet 정의 설명

4 위챗 그룹 가입 콜백 등록

1) 기능 설명

위챗 그룹 가입 결과를 게임에 콜백합니다.

2) 인터페이스 선언

public delegate void JoinWXGroupDelegate(GroupRet ret);

3) 파라미터 설명

4) 반환값

없음

5) 예시 코드

MsdkEvent.Instance.JoinWXGroupEvent += (GroupRet groupRet) => {
    if (groupRet.flag == eFlag.eFlag_Succ) {
        // 위챗 그룹 가입 성공
    } else {
        // 위챗 그룹 가입 실패
        string msg = handlerWXErrorCode(groupRet);
        }
    }
}

6) 특수 설명

없음

7) 용어 해석

없음

5 위챗 그룹 상태 검색 콜백을 등록합니다.

1) 기능 설명

위챗 그룹 상태를 게임에 콜백합니다.

2) 인터페이스 선언

public delegate void QueryWXGroupStatusDelegate(GroupRet ret);

3) 파라미터 설명

4) 반환값

없음

5) 예시 코드

MsdkEvent.Instance.QueryWXGroupStatusEvent += (GroupRet ret) =>
{
    Debug.Log(ret.ToString());
    message = ret.ToString();
    if (ret.flag == eFlag.eFlag_Succ)
    {
        // 그룹 정보 검색 성공

    }
    else
    {
        // 그룹 정보 검색 실패
        string msg = handlerWXErrorCode(ret);
    }

};

6) 특수 설명

없음

7) 용어 해석

없음

5 위챗 그룹 정보 검색 인터페이스 호출

1) 기능 설명

게임 내에서 길드위챗 그룹 정보를 검색하며, 위챗 길드 그룹이 생성되었는지 그리고 대응하는 사용자가 그룹에 가입했는지 확인하는 데 사용됩니다.

2) 인터페이스 선언

void WGQueryWXGroupInfo(string unionid, string openIdList);

3) 파라미터 설명

4) 반환값

없으며, 결과는 QueryGroupInfoEvent를 통해 게임에 콜백합니다.

5) 예시 코드

WGPlatform.Instance.WGQueryWXGroupInfo ("union1", "openid"););

6) 특수 설명

없음

7) 용어 해석

없음

6 길드 위챗 그룹 생성 인터페이스 호출

1) 기능 설명

게임 내에서 길드 위챗 그룹을 생성합니다.

2) 인터페이스 선언

void WGCreateWXGroup(string unionid, string chatRoomName, string chatRoomNickName);

3) 파라미터 설명

4) 반환값

없으며, 호출 결과는 CreateWXGroupEvent를 통해 게임에 콜백합니다.

5) 예시 코드

WGPlatform.Instance.WGCreateWXGroup("union1", "MSDK-Unity 길드", "사용자의 그룹 닉네임");

6) 특수 설명

없음

7) 용어 해석

없음

7 길드 위챗 그룹 가입 인터페이스 호출

1) 기능 설명

게임 내 길드 위챗 그룹 가입

2) 인터페이스 선언

void WGJoinWXGroup(string unionid, string chatRoomNickName);

3) 파라미터 설명

4) 반환값

없으며, 호출 결과는 JoinWXGroupEvent를 통해 게임에 콜백합니다.

5) 예시 코드

WGPlatform.Instance.WGJoinWXGroup ("union1", "사용자의 그룹 닉네임");

6) 특수 설명

없음

7) 용어 해석

없음

7 길드 위챗 그룹 상태 검색 인터페이스

1) 기능 설명

게임 내에서 지정된 길드 id가 이미 그룹을 생성했는지, 또는 그룹에 이미 가입했는지 확인합니다.

2) 인터페이스 선언

void WGQueryWXGroupStatus(string unionid, eStatusType opType);

3) 파라미터 설명

4) 반환값

없으며, 결과는 QueryGroupInfoStatusEvent를 통해 게임에 콜백합니다.

5) 예시 코드

WGPlatform.Instance.WGQueryWXGroupStatus("union1", eStatusType.ISCREATED);

6) 특수 설명

없음

7) 용어 해석

없음

자주 묻는 질문

• 1개의 위챗 계정은 1건의 게임 하에서 매일 최대 1개의 위챗 길드 그룹만을 생성할 수 있으며, 반드시 24시간을 기다린 후에 다시 새로운 위챗 그룹을 생성할 수 있습니다. 1개의 위챗 계정은 1건의 게임 하에서 20개의 위챗 길드 그룹만을 만들 수 있으며, 생성한 위챗 길드 그룹은 삭제될 수 없습니다. 따라서, 테스트 시에 해당 게임의 그룹을 20개를 초과해 생성하는 경우, 1개의 계정을 변환해 길드 그룹을 만들어야 합니다.
• 1개의 위챗 계정은 ㅂ건의 게임 하에서 매일 최대 2개의 위챗 길드 그룹에만 가입할 수 있습니다. 1개의 위챗 계정은 1건의 게임 하에서 최대 50개의 위챗 길드 그룹에만 가입할 수 있습니다.
• 1개의 qq 계정은 매일 최대 8회까지 qq 길드 그룹(게임을 구분하지 않으며, 해당 그룹이 해산되어도 그룹 생성 1회로 계산됨)을 생성할 수 있습니다. 1개의 QQ 계정은 최대 100개까지 qq 길드 그룹을 생성할 수 있습니다.
• 1개의 qq 계정은 최대 500명까지 qq 길드 그룹에 가입할 수 있습니다.(게임을 구분하지 않음)
• QQ 그룹이 해산될 경우 두 가지 방식으로 결합 관계를 취소할 수 있습니다.
  1.회장이 그룹 결합 해제 인터페이스를 호출해 그룹 관계를 해제함；
  2.길드 구성원이 그룹 가입 인터페이스를 호출할 경우, 이 때는 그룹 ID를 찾을 수 없으므로 기본값으로 결합 해제를 실시할 수 있습니다
  QQ 그룹이 해산되되고 상기 처리 중 어느 것도 수행하지 않은 경우, 결합 관계는 자동으로 취소될 수 없습니다.