모든 문서(일반 문서, 분류 문서, 파일(이미지, 사운드 등) 문서) 분류가 달려 있어야 합니다.

--Administrator (토론)

Offerwall 모듈 적용 가이드 (Android)

컴투스위키
이동: 둘러보기, 찾기
Com2uS 공통모듈 >> Offerwall >> Offerwall 모듈 적용 가이드 (iOS)

Offerwall 모듈 적용 가이드 (Android)

Offerwall 모듈 적용 가이드 (Unity3d)

>> Offerwall 모듈 레퍼런스 가이드 >> Offerwall FAQ


목차

역사

<작성법 참고>
Version Date SVN Revision 담당자 변경 사항
2.3.7 2020-06-16 - 김현석
  • HIVE UI에서 사용하는 버튼의 유저 인터랙션 개선
2.3.6 2020-01-23 - 김현석
  • 더이상 사용하지 않는 기능과 코드를 제거
2.3.5 2019-10-16 - 최지수
  • 모든 웹뷰에서 더이상 쿠키를 사용하지 않도록 로직 변경
  • 코드 상의 네트워크 통신을 위한 Url 문자열을 변조 처리
2.3.4 2019-06-25 - 최지수
  • 모듈 내부 네트워크 통신 시 mac 정보를 보내지 않도록 수정
  • Android cutout 영역까지 가능한 모든 화면을 사용하며, cutout 영역에 모듈 UI가 가려지지 않도록 대응
  • C 플러그인 로직의 Android 64비트 시스템 대응
    • .c, .h 파일이 업데이트 되었습니다.
    • .a 라이브러리 파일이 5가지(arm64-v8a, armeabi, areabi-v7a, x86, x86_64)로 빌드 업데이트 되었습니다.
    • 적용 시 별도의 인터페이스 수정은 없습니다. 다만 내부 로직이 변경되었으니 업데이트 후 동작 확인을 부탁드립니다.

[라이브러리 및 리소스 배포 변경사항]

  • Android Studio 라이브러리 적용 [studio 설정 가이드]
    • .aar 파일을 적용하여 사용이 가능합니다.
    • 이클립스 프로젝트 환경의 라이브러리를 더이상 지원하지 않습니다.
  • 통합 리소스
    • 배포된 패키지에 있는 '/res_통합' 경로의 모든 리소스 파일을 프로젝트가 추가 바랍니다. [가이드 확인하기]
    • 배포된 패키지에 있는 '/res_수정설정' 경로의 모든 리소스 파일을 적용하는 프로젝트 성격에 맞게 내용을 수정하여 추가 바랍니다. [가이드 확인하기]
2.3.2 2018-11-15 2850 최지수
2.3.1 2018-10-01 2846 최지수
  • 모듈 내부 통신에 사용되는 통합식별자 관련 수정
    • 통합식별자 데이터 처리 방식 개선
    • 네트워크 데이터 통신시 analytics_id를 추가하여 전송
2.3.0 2018-08-31 2844 최지수
  • 프로모션 로딩 방식 개선
    • 공지사항, 새소식, 오퍼월 페이지에서 로딩 진행상태를 알 수 있는 ProgressBar를 적용
    • 웹뷰에서 설정된 타임아웃 기능을 제거하여 시스템 타임아웃(60초)를 사용
2.2.9 2018-06-27 2841 최지수
  • 말레이시아어 대응 로직 제거
  • 중국 간체 및 번체 분기 시 사용되는 국가 코드를 단말 국가 코드가 아닌 HIVE Country를 사용하도록 변경
  • Android 8.0 이상 단말에서 웹뷰 재시도 페이지의 재시도 버튼 터치 시 정상 작동하지 않는 현상 수정
2.2.8 2017-12-08 2833 최지수
  • 프로모션과 관련된 서버 통신 시 광고 아이디 수집 여부 값을 전달하도록 추가 (ModuleManager v2.5.1+ 적용 필수)
2.2.7 2017-12-08 2828 최지수
  • 웹뷰 타임아웃 로직 개선
  • HTTPS 프로토콜을 모든 기능에서 사용하도록 변경
2.2.6 2017-09-20 2820 최지수
  • 멀티윈도우 화면에서 UI가 정상 노출되도록 대응 (Android OS 7.0 이상)
2.2.5 2017-08-28 2816 최지수
  • 모듈 내부 서버통신 데이터에 통합 식별자 추가
  • 언어 분기시 게임 언어를 우선시하며 게임 언어를 설정하지 않을 경우 단말 언어로 설정하도록 수정
    • ActiveUser SetGameLanguage API 를 통해 게임 언어 설정 가능 (ActiveUser v2.7.5 이상)
  • UI 관련 텍스트 국가별 추가 번역 및 오탈자 수정
  • Android O 버전 대응 (모듈 내부 서버통신시 IMEI, AdvertisingId 정보 전달)
  • 웹뷰 타임아웃 로직 개선 (호출한 웹뷰 페이지 제공률을 높이기 위해 재시도 페이지 노출 판정 개선)
  • 로딩 다이얼로그의 텍스트가 각국 언어에 따라 노출되도록 수정
2.2.4 2017-07-11 2808 최지수
  • 모듈 내부 아랍어 텍스트 추가
2.2.3 2017-02-27 2805 정다운
  • 웹뷰 지연처리 로직 예외 처리 대응
2.2.2 2017-01-26 2803 정다운
  • 데이터 요청에 대한 네트워크 타임아웃 로직 추가
  • 웹뷰 요청에 대한 네트워크 타임아웃 로직 추가(타임아웃 발생 시 자체 에러페이지 노출)
2.2.1 2016-01-26 2748 김규진
  • 내부 로직 중 개별 서버 세팅값이 반영 되도록 수정
2.2.0 2016-01-04 2738 김규진
  • 샌드박스 설정 기능이 추가 되었습니다.
이 부분은 ActiveUser 의 서버세팅을 따라가게 됩니다.
2.0.8 2015-06-17 2681 김규진
  • 서버 도메인 변경
    • 변경 전 : m.wall.com2us.com
    • 변경 후 : m-wall.qpyou.cn
2.0.7 2015-06-05 2676 김규진
2.0.6 2015-05-13 2667 박가진
2.0.5 2015-03-19 2650 박가진
2.0.4 2015-03-19 2649 박가진
  • 단말 정보 취득 예외 처리
2.0.3 2015-02-26 2643 박가진
  • ShowEx(AddInfo) API 추가
2.0.1 2014/10/30 2602 박가진
  • Activation 확인 Server URL 변경
  • Activation 상태 값에 상관없이 Show 호출하면 무조건 화면 Open.
2.0.0 2014/10/27 2593 임성훈
1.1.3 2014/07/30 2566 임성훈
  • SingleGame 보상기능 추가
  • Kitkat 에서 죽는 문제 수정
1.1.0 2014/06/20 2566 임성훈
  • Offferwall 배포


모든 버전의 역사 보기


Android 유의 사항

<작성법 참고>

v2.0.5 이상 버전 사용 시


Android 적용 방법

<작성법 참고>
Jar 파일 추가 (Java Libraries)
Add JARS...
offerwall.jar (svn://devbackup.com2us.com/Wrapper_redist/program/templates/AndroidTemplate/Com2uSAndroid/module/Offerwall/libs/))
modulemanager.jar (svn://devbackup.com2us.com/Wrapper_redist/program/templates/AndroidTemplate/Com2uSAndroid/module/ModuleManager/libs/)

MainActivity.java

Com2uS Wrapper Project 는 이부분은 따로 설정할 필요가 없습니다.

import com.com2us.module.offerwall.Offerwall;
import com.com2us.module.offerwall.Offerwall.OfferwallCB;

public class MainActivity extends Activity implements OfferwallCB {

        Offerwall offerwall;
        @Override
        public void onCreate(Bundle savedInstanceState) {
                super.onCreate(savedInstanceState);
                ...

                offerwall = new Offerwall(this);
                ...
        }
}

AndroidManifest.xml
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
  • targetSdkVersion의 값이 28 이상인 경우
    • application 태그에 usesCleartextTraffic 설정을 추가해야 합니다. (http:// 관련 통신이 가능하도록)
      <application
         .. (기타 설정) ..
         android:usesCleartextTraffic="true" />

Resource 추가
  • 리소스는 다음 SVN 경로에서 찾을 수 있습니다.
svn://devbackup.com2us.com/Wrapper_redist/program/templates/AndroidTemplate/Com2uSAndroid/module/Offerwall/res/
  • v2.3.2 리소스 변경사항
    • 추가된 리소스
      • /res/drawable-hdpi 경로(2개) : hive_promotion_btn_native_x.png, hive_promotion_offerwall_btn_x.png
      • /res/drawable-mdpi 경로(2개) : hive_promotion_btn_native_x.png, hive_promotion_offerwall_btn_x.png
      • /res/drawable-xdpi 경로(2개) : hive_promotion_btn_native_x.png, hive_promotion_offerwall_btn_x.png
      • /res/drawable-xxdpi 경로(2개) : hive_promotion_btn_native_x.png, hive_promotion_offerwall_btn_x.png
      • /res/drawable-xxxdpi 경로(2개) : hive_promotion_btn_native_x.png, hive_promotion_offerwall_btn_x.png
    • v2.3.2에서 UI 개선으로 더이상 사용하지 않는 리소스
      • /assets/common/offerwall 경로(2개) : btn_native_X.png, btn_native_X_tablet.png


  • Android Offerwall v2.3.4 부터 별도의 리소스 추가가 필요 없습니다.
    • .aar 형태의 라이브러리로 배포되어 리소스가 라이브러리레 포함되어있습니다. 따라서 별도의 리소스 파일을 추가할 필요가 없습니다.


Android Studio 적용하기 (190625 배포 이후)

1) .aar 라이브러리 추가하기

  • 배포된 패키지에 있는 Offerwall-x.x.x.aar 라이브러리를 프로젝트가 추가합니다.
    • build.gradle 설정에서 해당 .aar 파일을 implementation하여 빌드되도록 설정합니다.

2) 통합 리소스 및 수정설정 리소스 추가하기

  • 리소스 가이드에 있는 통합 리소스와 수정설정 리소스를 프로젝트에 추가합니다. [리소스 추가하기]


Single Mode 게임 적용 방법

  • 보상 진행 과정

Offerwall SingleMode - New Page.png



  1. Init을 하여 offerwall Server에 보상에 필요한 정보를 보내고 (보상정보)를 요청합니다.
  2. Reward Callback을 통해, AssetCode, AssetAmount, Error Message 등을 Server로 부터 받습니다.
  3. Server로 부터 받아온 보상정보를 Client가 Player 에게 지급하고 모든 보상이 완료되었으면 Finish를 호출하여 Server에 보상이 끝났다는 것을 알립니다.



Com2uS 공통모듈 >> Offerwall >> Offerwall 모듈 적용 가이드 (iOS)

Offerwall 모듈 적용 가이드 (Android)

Offerwall 모듈 적용 가이드 (Unity3d)

>> Offerwall 모듈 레퍼런스 가이드 >> Offerwall FAQ
개인 도구
이름공간

변수
행위
둘러보기
도구모음
인쇄/내보내기