개요

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

액세스 내비게이션

1 액세스 설정

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

2) 데이터 절약 업데이트 설정 스위치SAVE_UPDATE=true는, 액세스 설정 Step3 설정 정보

2 콜백

1) 인터페이스 선언

public static void WGSetSaveUpdateObserver(WGSaveUpdateObserver observer);

2) 파라미터 설명

3) 반환값

없음

4) 예시 코드

WGPlatform.WGSetSaveUpdateObserver(new WGSaveUpdateObserver(){

    @Override
    public void OnCheckNeedUpdateInfo(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 검사 실패
        }

    }

    @Override
    public void OnDownloadAppProgressChanged(long receiveDataLen, long totalDataLen) {
        long progress = receiveDataLen * 100 / totalDataLen;
        // 게임 TODO 다운로드 중, " + progress + "%” 완료;

    }

    @Override
    public void OnDownloadAppStateChanged(int state, int errorCode, String errorMsg) {
        if (state == TMAssistantDownloadTaskState.DownloadSDKTaskState_SUCCEED) {
            // 게임 TODO 다운로드 완료
        } else {
            // 게임 TODO 다운로드 실패
        }
    }

    @Override
    public void OnDownloadYYBProgressChanged(String url, long receiveDataLen, long totalDataLen) {
         long progress = receiveDataLen * 100 / totalDataLen;
         // 게임 TODO 다운로드 중. " + progress + "%” 완료;
    }

    @Override
    public void OnDownloadYYBStateChanged(String url, int state, int errorCode, String errorMsg) {
        if (state == TMSelfUpdateTaskState.SelfUpdateSDKTaskState_SUCCESS) {
            // 게임 TODO 다운로드 완료
        } else {
            // 게임 TODO 다운로드 실패
        }

    }

});

5) 특수 설명

public void OnCheckNeedUpdateInfo(long newApkSize, String newFeature, long patchSize, int status,String updateDownloadUrl, int updateMethod)

1) OnCheckNeedUpdateInfo 파라미터 설명

public void OnDownloadAppProgressChanged(long receiveDataLen, long totalDataLen)

2) OnDownloadAppProgressChanged 파라미터 설명

public void OnDownloadAppStateChanged(int state, int errorCode, String errorMsg)

3) OnDownloadAppStateChanged 파라미터 설명

public void OnDownloadYYBProgressChanged(String url, long receiveDataLen, long totalDataLen)

4) OnDownloadYYBProgressChanged 파라미터 설명

public void OnDownloadYYBStateChanged(String url, int state, int errorCode, String errorMsg)

5) OnDownloadYYBStateChanged 파라미터 설명

3 액세스 절차

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

(./res/myapp_newflow.png)

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

예시는, com/example/module/submodule/MyappModule.java 파일의 callWGCheckNeedUpdate(), callWGCheckYYBInstalled(), callWGStartSaveUpdate(), callWGStartCommonUpdate() 메소드를 참조하십시오.

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

1 개요 설명

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

2 콜백

없음

3 인터페이스 호출

1) 기능 설명

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

2) 인터페이스 선언

public static int WGCheckYYBInstalled();

3) 파라미터 설명

없음

4) 반환값

int 유형

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

5) 예시 코드

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

6) 특수 설명

없음

7) 명칭 해석

없음

업데이트가 있는지 확인

1 개요 설명

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

2 콜백

액세스 내비게이션Step2 참조

3 인터페이스 호출

1) 기능 설명

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

2) 인터페이스 선언

public static void WGCheckNeedUpdate();

3) 파라미터 설명

없음

4) 반환값

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

5) 예시 코드

WGPlatform.WGCheckNeedUpdate();

6) 특수 설명

없음

7) 명칭 해석

없음

데이터 절약 업데이트 시작

1 개요 설명

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

2 콜백

액세스 내비게이션Step2 참조

3 인터페이스 호출

1) 기능 설명

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

2) 인터페이스 선언

public static void WGStartSaveUpdate(bool isUseYYB);

3) 파라미터 설명

4) 반환값

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

5) 예시 코드

WGPlatform.WGStartSaveUpdate(true);

6) 특수 설명

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

7) 명칭 해석

없음

자주 묻는 질문