MSDK WIKI

개요

푸시 기능을 통해 게임을 실행하지 않은 상황에서 플레이어의 휴대전화기로 각종 휴일 이벤트, 기념 이벤트와 같은 게임 관련 정보를 푸시 할 수 있습니다. 푸시 효과는 다음 그림과 같습니다.

액세스 내비게이션

사전 요구 사항

1) 이미 MSDK Android 액세스 설정 모듈 설명에 따라 액세스 설정을 완료하고 푸시 스위치PUSH=true를 확보합니다.

푸시 정보 발송

페이잉(飞鹰) 시스템에 진입하여, 좌측 내비게이션창을 클릭해 MSDK 관리 -> 정보 관리(권한이 없는 경우 RTX에서 marsrabelma 마텅(马腾)에 연락해 권한을 획득할 수 있음)의 열린 화면 내에서 메시지(정식 환경) 버튼을 클릭해 정식 환경 하에서 +푸시 통지 버튼을 클릭해 푸시 정보를 클릭합니다. 아래 예시를 참조하십시오.

주의사항:

정보 푸시를 테스트할 때, 절대로 전체 푸시는 실행하지 마십시오. 하나의 계정 또는 여러 개의 계정을 이용해 테스트할 수 있으므로 전테 네트워크 사용자가 테스트 푸시 정보를 수신하도록 하지는 마십시오.

로컬 푸시 추가

원격 푸시 이외에도, 게임에서는 체력 회복 메시지 환경과 같은 로컬 정보 푸시도 가능합니다.

Android 로컬 푸시

로컬 푸시 제거

1 Android 로컬 푸시

1) 기능 설명

로컬 푸시는 원격 푸시와 비교할 때, 원격 서버와의 인터랙션 없이 로컬에서 바로 수행할 수 있는 정보 알림 기능이며, 주로 체력 회복 메시지 등의 환경에서 사용됩니다.

2) 인터페이스 선언

public static long WGAddLocalNotification(LocalMessage msg);

3) 파라미터 설명

파라미터 명칭	유형	설명
msg	LocalMessage 카테고리	이동 확인

4) 반환값

1 추가 성공, 0 추가 실패

5) 예시 코드

string[] times = "20150907 07 01".split (" ");
LocalMessage msg = new LocalMessage();
msg.type = 1;
msg.action_type = 1;
msg.content = "전서구 로컬 푸시 테스트";
msg.title = "새 메시지가 있습니다.";
msg.date = times[0];
msg.hour = times[1];
msg.min = times[2];
WGPlatform.WGAddLocalNotification(msg);

6) 특수 설명

msg.hour 및 msg.min은 01, 02와 같이 반드시 두 자리여야 합니다. 전서구(信鸽) 3.0 버전보다 낮은 경우, 게임 컴파일링 시에 targetsdkversion>=23, android6.0 시스템 상에서는 푸시를 수신할 수 없습니다.

7) 명칭 해석

없음

2 로컬 푸시 제거

1) 기능 설명

로컬에서 추가했으나 아직 실행하지 않은 푸시 알림을 모두 게임에서 삭제할 수 있습니다.

2) 인터페이스 선언

public static void WGClearLocalNotifications();

3) 파라미터 설명

없음

4) 반환값

없음

5) 예시 코드

WGPlatform.WGClearLocalNotifications();

6) 특수 설명

없음

7) 명칭 해석

없음

태그 푸시

게임은 사용자에 대해 성별, 연령, 학력, 취미 등과 같은 태그를 설정할 수 있으며, 별도로 SDK 내에는 사전 설정된 기본 태그가 있어, 푸시 시에 다양한 태그 내용에 따라 푸시를 실시합니다.

1 태그 프리셋

현재 전서구(信鸽)는 다음 3개 유형의 프리셋 태그를 제공하며, 게임에서는 다른 설정을 필요로 하지 않습니다.

지리적 위치(성 1급)
애플리케이션 버전 번호
유실된 사용자(3일 또는 7일)

2 태그 설정

1) 기능 설명

게임에서는 사용자에 대해서 다양한 태그를 설정할 수 있으며, 하나의 게임에 최대 10,000개의 태그 설정이 가능합니다. 각 사용자는 임의의 게임에서 최대 100개까지 태그를 설정할 수 있고, 태그 설정 시에는 태그 내에 공백이 있어서는 안 된다는 점에 주의해 주십시오.

2) 인터페이스 선언

public static void WGSetPushTag(string tag);

3) 파라미터 설명

파라미터 명칭	유형	설명
tag	string	null이 되거나 공백을 포함할 수 없음

4) 반환값

없음

5) 예시 코드:

public static WGPlatform.WGSetPushTag("Student");

6) 특수 설명

없음

7) 명칭 해석

없음

3 태그 삭제

1) 기능 설명

설정된 사용자 태그를 삭제하면, 푸시 시에 해당 사용자는 이 태그 아래의 푸시 정보를 수신할 수 없습니다.

2) 인터페이스 선언

public static void WGDeletePushTag(string tag);

3) 파라미터 설명

파라미터 명칭	유형	설명
tag	string	null이 되거나 공백을 포함할 수 없음

4) 반환값

없음

5) 예시 코드

WGPlatform.WGDeletePushTag("Student");

6) 특수 설명

없음

7) 명칭 해석

없음

4 태그 푸시 정보 발송

태그 푸시 정보 발송은 푸시 정보 발송과 마찬가지로, 푸시 정보 추가 시에 다음과 같이 맞춤형 푸시 발송 그룹 범위를 선택해야 합니다.

자주 묻는 질문

|자주 묻는 질문|전서구 푸시|Android|

게임 푸시 정보는 정상적인 검사 절차를 수행할 수 없습니다.

게임 assets/msdkconfig.ini 내 PUSH 항목의 값이 true인지 확인하십시오. 아닐 경우, true로 수정한 후 다시 시도합니다. 계속 아래로 검색하는 경우.
게임 패키지 이름에 등록 시 입력한 패키지 이름과 일치하는지 확인하십시오. http://open.qq.com 상에 등록된 패키지 이름이 사용 중인 패키지 이름과 일치하는지 확인하고, 패키지 이름이 일치하도록 해 주십시오.(주의: 패키지 이름의 시작 및 끝 부분에 공백이 있지 않은지 확인해 주십시오.) 계속 아래로 검사해야 하는 경우.
AndroidManifest.xml 내에서 전서구(信鸽) 푸시에 관한 설정이 정확한지 확인해 주십시오. 설정에 오류가 있으면 계속 아랫쪽을 검사해 주십시오.
게임이 사용하는 정보 수신 기기가 Android의 어떤 버전인지 확인하고, Android6.0 시스템의 기기인 경우, 전서구(信鸽) 3.0 이전 버전에 설정해야 하는 targetSdkversion은 22 이하여야 합니다. 22보다 높은 버전은 수신이 불가능할 수 있으며, 현재 이것은 전서구(信鸽) 3.0의 버전 bug입니다. 22 버전 이하일 경우 계속해서 아랫쪽으로 검사하십시오.
MSDKLibrary/lib 아래 so 파일이 모두 게임의 상응하는 디렉토리에 복제되었는지 확인하십시오. 복제에 오류가 있으면 계속 아랫쪽을 검사해 주십시오.
전서구(信鸽) 등록 성공 여부를 학인합니다.

상기 절차에 따라 설정을 끝낸 후에는 게임 필터 log를 기동하고, 아래 log가 나타나고 기기 등록 성공 메시지가 있으면, 페이잉(飞鹰) 시스템에서 Android 플랫폼으로 푸시가 가능합니다.

msdkpush_1

로그인 성공 후 아래의 log가 보이고 사용자 결합 성공 메시지가 있으면, 페이잉(飞鹰) 시스템에서 코드 패키지 푸시가 가능합니다.

msdkpush_1

xg_service_v2 프로세스가 존재하는지 확인하십시오. 존재하지 않을 경우 정보를 수신할 수 없습니다.(adb shell 내에서 ps |grep xg_service_v2를 확인하심시오.) 전서구(信鸽) 프로세스가 존재할 경우, MSDK에 연락해 해결하십시오.

이미 전서구가 액세스한 게임의 솔루션

게임 원본에 이미 전서구 푸시가 액세스한 경우, 자신의 이전 액세스 전서구 로직 보류를 선택할 수 있습니다. 이때 MSDKLibrary에 입력하면 패키지 충돌이 발생할 수 있습니다.

게임을 MSDK의 방식에 따라 전서구를 액세스할 것을 권장하며, 이미 액세스한 자신의 전서구 sdk는 삭제하고, MSDK 방식에 따라 액세스하십시오.
자신이 전서구(信鸽) 공식 웹사이트에서 다운로드한 sdk이지만 MSDK에서 사용하는 전서구(信鸽) sdk를 삭제하지 않은 경우, 이전 액세서의 전서구 기능이 정상인지 점검하면 되며, 이전에 액세스한 전서구 기능을 사용하는 경우, MSDK 푸시 스위치를 끌 것을 권장합니다. 아래 조작 순서에 따라, assets/msdkconfig.ini 내에서 정보 푸시 스위치를 PUSH=false로 설정하면 됩니다.
또한 MSDK에서 사용하는 전서구(信鸽) sdk를 삭제하고 전적으로 전서구 공식 웹사이트의 액세스 방식을 사용하는 것을 선택할 수도 있으며, 그중에서 전서구(信鸽) sdk의 MSDK 저장 위치는 다음과 같습니다.

MSDKLibrary\libs\arm64-v8a\libtpnsSecurity.so

MSDKLibrary\libs\armeabi\libtpnsSecurity.so

MSDKLibrary\libs\armeabi-v7a\libtpnsSecurity.so

MSDKLibrary\libs\mips\libtpnsSecurity.so

MSDKLibrary\libs\mips64\libtpnsSecurity.so

MSDKLibrary\libs\x86\libtpnsSecurity.so

MSDKLibrary\libs\x86_64\libtpnsSecurity.so

MSDKLibrary\libs\arm64-v8a\libxguardian.so

MSDKLibrary\libs\armeabi\libxguardian.so

MSDKLibrary\libs\armeabi-v7a\libxguardian.so

MSDKLibrary\libs\mips\libxguardian.so

MSDKLibrary\libs\mips64\libxguardian.so

MSDKLibrary\libs\x86\libxguardian.so

MSDKLibrary\libs\x86_64\libxguardian.so

MSDKLibrary\libs\armeabi\Xg_sdk_v***.jar