MSDK WIKI

개요

MSDK와 잉용바오(应用宝) 팀이 함께 게임 데이터 절약을 위해 업데이트한 기능으로, 사용자는 업데이트 패키지의 부족한 부분을 다운로드해 업데이트를 실시함으로써 사용자의 데이터 사용량 절감 효과를 달성합니다.

액세스 내비게이션

1 액세스 설정

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

2) 데이터 절약 업데이트 설정 스위치SAVE_UPDATE가 선택되도록 하고, 액세스 설정 Step3 설정 정보

2 액세스 절차

잉용바오(应用宝) 데이터 절약 업데이트

(./res/myapp_newflow.png)

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

예시는 Assets\Example\MsdkDemo.cs 스크립트의 ShowOthers() 메소드를 참조하십시오.

잉용바오(应用宝) 설치 여부 확인

1 개요 설명

WGCheckYYBInstalled() 인터페이스를 호출해 잉용바오(应用宝) 설치 여부를 확인하고 상응하는 메시지를 표시할 수 있습니다. 이 확인은 필수는 아니며 사용자가 잉용바오(应用宝)를 설치하지 않은 경우, 업데이트 전에 자동으로 먼저 잉용바오(应用宝)를 설치할 수 있습니다.

2 콜백

없음

3 인터페이스 호출

1) 기능 설명

2) 인터페이스 선언

int WGCheckYYBInstalled();

3) 파라미터 설명

없음

4) 반환값

int 유형

0: 잉용바오(应用宝)가 설치되어 있음을 나타냄 
1: 잉용바오(应用宝)가 설치되어 있지 않음을 나타냄 
 그밖의 값은 낮은 버전의 잉용바오(应用宝)가 설치되어 있음을 나타냄

5) 예시 코드

int ret = WGPlatform.Instance.WGCheckYYBInstalled();
switch (ret)
{
    case 0: // 게임 TODO 잉용바오 설치됨
        break;
    case 1: // 게임 TODO 잉용바오 설치됨
        break;
    default: // 게임 TODO 낮은 버전 잉용바오 설치됨
        break;
}

6) 특수 설명

없음

7) 명칭 해석

없음

업데이트가 있는지 확인

1 개요 설명

현재 앱에 업데이트가 있는지 확인

2 콜백

1) 기능 설명

게임 업데이트 콜백의 검사는, 게임에서 등록하고 콜백 처리할 필요가 있으므로, 게임의 Awake 함수 내에서의 등록을 권장합니다.

2) 인터페이스 선언

public delegate void CheckUpdateDelegate(long newApkSize, string newFeature, 
        long patchSize, int status, string updateDownloadUrl, int updateMethod);

3) 파라미터 설명

파라미터 명칭	유형	설명
newApkSize	long	새로운 apk 패키지의 파일 크기
newFeature	string	새 버전 설명
patchSize	long	데이터 절약 업데이트 새 패키지 파일 크기
status	int	검사 결과 TMSelfUpdateUpdateInfo.STATUS_OK : 성공 TMSelfUpdateUpdateInfo.STATUS_CHECKUPDATE_FAILURE : 실패 TMSelfUpdateUpdateInfo.STATUS_CHECKUPDATE_RESPONSE_IS_NULL : 응답이 공백임
updateDownloadUrl	string	주소 다운로드
updateMethod	int	업데이트 방식 TMSelfUpdateUpdateInfo.UpdateMethod_NoUpdate : 업데이트 패키지 없음 TMSelfUpdateUpdateInfo.UpdateMethod_Normal : 전체 용량 업데이트 패키지 TMSelfUpdateUpdateInfo.UpdateMethod_ByPatch : 추가 용량 업데이트 패키지

4) 반환값

없음

5) 예시 코드

MsdkEvent.Instance.CheckUpdateEvent += (long newApkSize, string newFeature, 
        long patchSize, int status, string updateDownloadUrl, int updateMethod) => {
    if (status == TMSelfUpdateUpdateInfo.STATUS_OK) { //검색 성공
        if (updateMethod == TMSelfUpdateUpdateInfo.UpdateMethod_NoUpdate)  {
            // 게임 TODO 업데이트 패키지 없음
        } else if (updateMethod == TMSelfUpdateUpdateInfo.UpdateMethod_Normal) {
            // 게임 TODO 전체 업데이트 실행 가능
        } else if (updateMethod == TMSelfUpdateUpdateInfo.UpdateMethod_ByPatch) {
            // 게임 TODO 추가 부분 업데이트 실행 가능
        }
    } else {
        // 게임 TODO 검사 실패
    }
};

6) 특수 설명

없음

7) 명칭 해석

없음

3 인터페이스 호출

1) 기능 설명

WGCheckNeedUpdate() 인터페이스를 호출해 현재 앱의 업데이트가 있는지 확인할 수 있습니다.

2) 인터페이스 선언

void WGCheckNeedUpdate();

3) 파라미터 설명

없음

4) 반환값

없으며, CheckUpdateEvent 콜백을 통해, 콜백 설정은 게임 업데이트 확인 콜백을 참조하십시오.

5) 예시 코드

WGPlatform.Instance.WGCheckNeedUpdate();

6) 특수 설명

없음

7) 용어 해석

없음

데이터 절약 업데이트 시작

1 개요 설명

WGStartSaveUpdate() 인터페이스를 호출해 데이터 절약 업데이트를 시작할 수 있습니다.

2 콜백

1 게임 업데이트 패키지 다운로드 진행 상황 콜백 등록

1) 기능 설명

게임 업데이트 패키지 다운로드 진행 상황 콜백은, 게임에서 등록하고 콜백 처리할 필요가 있으므로, 게임의 Awake 함수 내에서의 등록을 권장합니다.

2) 인터페이스 선언

public delegate void DownloadAppProgressDelegate(long receiveDataLen, long totalDataLen);

3) 파라미터 설명

테스트 명칭	유형	설명
receiveDataLen	long	다운로드된 데이터의 크기
totalDataLen	long	전체 데이터의 크기

4) 반환값

없음

5) 예시 코드

MsdkEvent.Instance.DownloadAppProgressEvent += (long receiveDataLen, long totalDataLen) => {
        long progress = receiveDataLen * 100 / totalDataLen;
        // 게임 TODO 다운로드 중. " + progress + "%” 완료;
};

6) 특수 설명

없음

7) 명칭 해석

없음

2 게임 업데이트 패키지 다운로드 진행 상태 변경 콜백 등록

1) 기능 설명

게임 업데이트 패키지 다운로드 진행 상태 변경 콜백은, 게임에서 등록하고 콜백 처리할 필요가 있으므로, 게임의 Awake 함수 내에서의 등록을 권장합니다.

2) 인터페이스 선언

public delegate void DownloadAppStateDelegate(int state, int errorCode, string errorMsg);

3) 파라미터 설명

테스트 명칭	유형	설명
state	int	상태: TMAssistantDownloadTaskState.DownloadSDKTaskState_WAITING = 1; TMAssistantDownloadTaskState.DownloadSDKTaskState_DOWNLOADING = 2; TMAssistantDownloadTaskState.DownloadSDKTaskState_PAUSED = 3; TMAssistantDownloadTaskState.DownloadSDKTaskState_SUCCEED = 4; TMAssistantDownloadTaskState.DownloadSDKTaskState_FAILED = 5; TMAssistantDownloadTaskState.DownloadSDKTaskState_DELETE = 6;
errorCode	int	에러 번호
errorMsg	string	에러 정보

4) 반환값

없음

5) 예시 코드

MsdkEvent.Instance.DownloadAppStateEvent += (int state, int errorCode, string errorMsg) => {
    if (state == TMAssistantDownloadTaskState.DownloadSDKTaskState_SUCCEED) {
        // 게임 TODO 다운로드 완료
    } else {
        // 게임 TODO 다운로드 실패
    }
};

6) 특수 설명

없음

7) 명칭 해석

없음

3 Google Play 다운로드 진행 상황 콜백 등록

1) 기능 설명

Google Play 다운로드 진행 상황 콜백은, 게임에서 등록하고 콜백 처리할 필요가 있으므로, 게임의 Awake 함수 내에서의 등록을 권장합니다.

2) 인터페이스 선언

public delegate void DownloadYYBProgressDelegate(string url, long receiveDataLen, long totalDataLen);

3) 파라미터 설명

테스트 명칭	유형	설명
url	string	주소 다운로드
receiveDataLen	long	다운로드된 데이터의 크기
totalDataLen	long	다운로드할 데이터의 크기

4) 반환값

없음

5) 예시 코드

MsdkEvent.Instance.DownloadYYBProgressEvent += (string url, long receiveDataLen, long totalDataLen) => {
    Debug.Log("Download YYB url is " + url);
    long progress = receiveDataLen * 100 / totalDataLen;
    // 게임 TODO 다운로드 중. " + progress + "%” 완료;
};

6) 특수 설명

없음

7) 명칭 해석

없음

4 Google Play 다운로드 진행 상황 콜백 등록

1) 기능 설명

Google Play 다운로드 상태 콜백은, 게임에서 등록하고 콜백 처리할 필요가 있으므로, 게임의 Awake 함수 내에서의 등록을 권장합니다.

2) 인터페이스 선언

public delegate void DownloadYYBStateDelegate(string url, int state, int errorCode, string errorMsg);

3) 파라미터 설명

파라미터 명칭	유형	설명
url	string	주소 다운로드
state	int	상태: TMSelfUpdateTaskState.SelfUpdateSDKTaskState_SUCCESS = 0; TMSelfUpdateTaskState.SelfUpdateSDKTaskState_DOWNLOADING = 1; TMSelfUpdateTaskState.SelfUpdateSDKTaskState_FAILURE = 2
errorCode	int	에러 번호
errorMsg	string	에러 정보

4) 반환값

없음

5) 예시 코드

MsdkEvent.Instance.DownloadYYBStateEvent += (string url, int state, int errorCode, string errorMsg) => {
    Debug.Log("Download YYB url is " + url);
    if (state == TMSelfUpdateTaskState.SelfUpdateSDKTaskState_SUCCESS) {
        // 게임 TODO 다운로드 완료
    } else {
        // 게임 TODO 다운로드 실패
    }
};

6) 특수 설명

없음

7) 명칭 해석

없음

3 인터페이스 호출

1) 기능 설명

WGStartSaveUpdate() 인터페이스를 호출해 데이터 절약 업데이트를 시작할 수 있습니다. 휴대전화기 상에 잉용바오(应用宝)가 설치되어 있지 않으면, 이 인터페이스에서 자동으로 잉용바오(应用宝)를 다운로드하게 될 수 있으며, DownloadYYBProgressEvent 및 DownloadYYBStateEvent의 두 언터페이스를 통해 각각 콜백할 수 있습니다. 휴대전화기 상에 잉용바오(应用宝)가 설치되어 있을 경우, 이 인터페이스는 파라미터에 근거해 잉용바오(应用宝)를 풀업해 다운로드 여부를 선택합니다. 다운로드 진도 및 상태 변화는 DownloadAppProgressEvent 및 DownloadAppStateEvent를 통해 게임에 콜백합니다.

2) 인터페이스 선언

void WGStartSaveUpdate(bool isUseYYB);

3) 파라미터 설명

파라미터 명칭	유형	설명
isUseYYB	bool	잉용바오(应用宝) 업데이트를 풀업해 게임을 업데이트할지를 선택하며, ‘아니오’를 선택할 경우 게임 내에서 업데이트가 이루어질 수 있습니다.

4) 반환값

없으며, 다운로드 진도 및 상태 변화는 DownloadAppProgressEvent 및 DownloadAppStateEvent를 통해 게임에 콜백합니다.

5) 예시 코드

WGPlatform.Instance.WGStartSaveUpdate(true);

6) 특수 설명

휴대전화기 상에 잉용바오(应用宝)가 설치되어 있지 않으면, 이 인터페이스에서 자동으로 잉용바오(应用宝)를 다운로드하게 될 수 있으며, DownloadYYBProgressEvent 및 DownloadYYBStateEvent의 두 언터페이스를 통해 각각 콜백할 수 있습니다.

7) 용어 해석

없음

개요

액세스 내비게이션

잉용바오(应用宝) 설치 여부 확인

1 개요 설명

2 콜백

3 인터페이스 호출

1) 기능 설명

2) 인터페이스 선언

3) 파라미터 설명

4) 반환값

5) 예시 코드

6) 특수 설명

7) 명칭 해석

업데이트가 있는지 확인

1 개요 설명

2 콜백

1) 기능 설명

2) 인터페이스 선언

3) 파라미터 설명

4) 반환값

5) 예시 코드

6) 특수 설명

7) 명칭 해석

3 인터페이스 호출

1) 기능 설명

2) 인터페이스 선언

3) 파라미터 설명

4) 반환값

5) 예시 코드

6) 특수 설명

7) 용어 해석

데이터 절약 업데이트 시작

1 개요 설명

2 콜백

1 게임 업데이트 패키지 다운로드 진행 상황 콜백 등록

1) 기능 설명

2) 인터페이스 선언

3) 파라미터 설명

4) 반환값

5) 예시 코드

6) 특수 설명

7) 명칭 해석

2 게임 업데이트 패키지 다운로드 진행 상태 변경 콜백 등록

1) 기능 설명

2) 인터페이스 선언

3) 파라미터 설명

4) 반환값

5) 예시 코드

6) 특수 설명

7) 명칭 해석

3 Google Play 다운로드 진행 상황 콜백 등록

1) 기능 설명

2) 인터페이스 선언

3) 파라미터 설명

4) 반환값

5) 예시 코드

6) 특수 설명

7) 명칭 해석

4 Google Play 다운로드 진행 상황 콜백 등록

1) 기능 설명

2) 인터페이스 선언

3) 파라미터 설명

4) 반환값

5) 예시 코드

6) 특수 설명

7) 명칭 해석

3 인터페이스 호출

1) 기능 설명

2) 인터페이스 선언

3) 파라미터 설명

4) 반환값

5) 예시 코드

6) 특수 설명

7) 용어 해석

자주 묻는 질문