04/28/2025 20:45:30

툴 모듈

1 개요

툴 모듈은 주로 App 설치 여부를 판단하는 등 자주 사용하는 툴 방법을 제공합니다. 그 중 IsAppInstalled 는 동기화되므로 콜백이 필요 없습니다.

2 연동 가이드

2.1 App 설치 여부 판단

1）기능 설명

소프트웨어의 설치 여부를 판단하는 기능을 가지고 있습니다. Android 플랫폼은 packageName 파라미터를 로드하고, iOS 플랫폼은 채널 파라미터 또는 "QQ", "WeChat" 과 같은 URLScheme 를 로드합니다

2）인터페이스 성명

public static bool IsAppInstalled(string channel,string extra="")

static bool IsAppInstall(String channel,String extra="");

3）예시 코드

#if UNITY_ANDROID
	bool isQQInstalled = MSDKTools.IsAppInstalled("com.tencent.mobileqq");
	bool isWeChatInstalled = MSDKTools.IsAppInstalled("com.tencent.mm");
#elif UNITY_IOS
	bool isQQInstalled = MSDKTools.IsAppInstalled("QQ");
    bool isWeChatInstalled = MSDKTools.IsAppInstalled("WeChat");
#endif

#if  PLATFORM_ANDROID
	bool isQQInstalled = MSDKTools::IsAppInstall("com.tencent.mobileqq");
	bool isWeChatInstalled = MSDKTools::IsAppInstall("com.tencent.mm");
#else PLATFORM_IOS
	bool isQQInstalled = MSDKTools::IsAppInstall("QQ");
	bool isWeChatInstalled = MSDKTools::IsAppInstall("WeChat");
#endif

2.2 설치 채널 획득

1）기능 설명

이 인터페이스는 APK 의 설치 채널（게임에 접속하기 전에 패키지는 채널에 따라 다른 APK 패키지가 생성되며, 설치 패키지에 있는 채널번호를 설치 채널이라고 합니다）을 획득하는데 사용됩니다. 또한, 설치 채널 명칭의 수정 방법은 GCloud 에서 제공하며, 자세한 사항은 GCloud 도우미에게 문의하실 수 있습니다.

2）인터페이스 성명

public static string GetConfigChannel();

static std::string GetConfigChannelID(const std::string &seqID);

3）예시 코드

string channel = MSDKTools.GetConfigChannel();

MSDKTools::GetConfigChannelID();

특별 설명：
1.iOS 설치 채널 번호와 등록 채널은 1001 로 고정되어 있습니다；
2.APK/IPA 의 등록 채널은 로그인 콜백 MSDKLoginRet 의 regChannelDis 파라미터 값을 통해 획득할 수 있습니다. 이 중 firstLogin 은 최초 로그인 여부를 의미하며, 값이 1 인 경우, 최초 로그인, 값이 0 인 경우 최초 로그인 아님을 의미합니다.

2.3 게임 과몰입 예방 정보 리포트

1）기능 설명

중독 방지 관련하여, Prajna serial Number 리포트되며, 현재 국내 채널만 지원되며, 해외 채널은 아직 지원되고 있지 않습니다. 게임에서 중독 방지 시스템과 연동 되었을때, 게임과 중독 방지 시스템간 장 연결 맺어져 serialNumber 는 중독 방지 시스템에서 보내는 것으로 MSDK 는 리포트만 합니다.

2）인터페이스 성명

public static void ReportPrajna(string serialNumber)

static void ReportPrajna(String serialNumber);

3）예시 코드

MSDKTools.ReportPrajna (serialNumber);

MSDKTools::ReportPrajna(serialNumber);

2.4 중독 방지 웹페이지 열기

1）기능 설명

중독 방지 시스템과 관련하여, 중독 방지 웹페이지를 여는데 사용되며, 현재 국내 채널만 지원되며, 해외 채널은 아직 지원되고 있지 않습니다. jsonStr 는 중독 방지 시스템에서 보내는 것으로 MSDK 는 이 파라미터를 사용하여 중독 방지의 webview 페이지를 엽니다.

2）인터페이스 성명

public static void OpenPrajnaWebView(string jsonStr)

static void OpenPrajnaWebView(String jsonStr);

3）예시 코드

MSDKTools.OpenPrajnaWebView (jsonStr);

MSDKTools::OpenPrajnaWebView(jsonStr);

2.5 Wechat deeplink

1）기능 설명

현재 로그인 상태에 따라 대응 애플리케이션 deeplink（ deeplink 기능의 개통 및 설정과 관련해서는 각 플랫폼에 연락하십시오）를 엽니다

2）인터페이스 성명

public static void OpenDeepLink(string link);

static void OpenDeepLink(String link);

3）예시 코드

MSDKTools.OpenDeepLink ("INDEX");
// MSDKTools.OpenDeepLink ("DETAIL");
// MSDKTools.OpenDeepLink ("LIBRARY");
// MSDKTools.OpenDeepLink ("https://pvp.qq.com/match/kcc.shtml");

MSDKTools::SetToolsObserver(new MyToolsObserver());
// MSDKTools::OpenDeepLink("INDEX");
// MSDKTools::OpenDeepLink("DETAIL");
// MSDKTools::OpenDeepLink("LIBRARY");
// MSDKTools::OpenDeepLink("https://pvp.qq.com/match/kcc.shtml");

• INDEX：Wechat 게임센터 첫 페이지로 이동
• DETAIL：Wechat 게임센터 상세 페이지로 이동
• LIBRARY：Wechat 게임센터 게임라이브러리로 이동
• 구체적인 이동 url（Wechat 에서 먼저 이 URL 을 설정한 뒤, URL origin address 로 이동）

특별 설명：
deepLink 기능은 Wechat 게임센터로 연락하여 개통 및 설정을 해야 합니다. Wechat 측에서 설정한 url 은 유효기간이 있으며, 유효기간은 6개월로 기본 설정되어 있습니다. 기간이 만료된 후에는 Wechat 플랫폼에서 url 갱신을 해야 지속적인 사용이 가능하며, url 기간 만료로 요청하는 경우 "msg":"error from wx:{\"errcode\":-10016,\"errmsg\":\"openlink expired\"}" 로 리턴됩니다.
deeplink 설정의 url 갱신과 관련하여 Wechat url 갱신 파일을 참조하십시오Wechat url 갱신 파일

2.6 iOS 게임 내 평점 기능

1）기능 설명

iOS 는 애플리케이션 내에서 평점/리뷰 팝업창이 뜹니다.

특별 설명：
1.디버깅 버전은 평점 제출이 불가하며, Release 버전은 평점 제출이 가능합니다.
2.정상적인 상황에서, 디버깅 버전에서 평점 팝업창이 뜨면 기능 정상입니다.

2）인터페이스 성명

public static void ShowRatingAlert();

static void ShowRatingAlert();

3）예시 코드

MSDKTools.ShowRatingAlert();

MSDKTools::ShowRatingAlert();