설치 - AAR 파일을 통해 직접 설치

  1. 럭키버스 안드로이드 릴리즈 페이지에서 최신 버전의 .aar 파일을 다운로드 하세요.

  2. 프로젝트의 app 디렉토리 안에 libs 디렉토리를 만들고, 다운 받은 .aar 파일을 옮기세요.

  3. 프로젝트의 settings.gradle 파일에 아래 코드를 추가해주세요.

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
    repositories {
        google()
        mavenCentral()
        maven { url "<https://bidmad-sdk.s3.amazonaws.com/>" } //Bidmad
        maven { url "<https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea>" } //Mintegral
        maven { url '<https://jitpack.io>' } //adpie
        maven { url '<https://artifact.bytedance.com/repository/pangle/>' } //Pangle
        flatDir {
            dirs 'app/libs'
        }
    }
}
  1. app레벨의 build.gradle에 아래 코드를 추가하세요.
dependencies {
    implementation "org.jetbrains.kotlin:kotlin-stdlib:1.8.22"
    implementation(name: 'Luckieverse', ext: 'aar')
    implementation 'androidx.activity:activity-ktx:1.8.1'
    implementation 'ad.helper.openbidding:admob-obh:3.27.0'
    implementation 'com.adop.sdk:bidmad-androidx:3.27.0'
    
    //이 아래에 어댑터를 작성해주세요. 다음은 어댑터 예시입니다.
    //예시일 뿐이므로 아래 어댑터를 그대로 복사해서 사용하지 마세요.
    //반드시 테크랩스 개발자로부터 전달 받은 SDK 업데이트 내역 PDF문서에 기재된 어댑터를 사용하세요.
    implementation 'com.adop.sdk.adapter:admob:24.4.0.1'
    implementation 'com.adop.sdk.adapter:adpie:1.14.5.0'
    implementation 'com.adop.sdk.adapter:applovin:13.1.0.0'
    implementation 'com.adop.sdk.adapter:fyber:8.3.7.0'
    implementation 'com.adop.sdk.adapter:pangle:6.5.0.4.0'
    implementation 'com.adop.sdk.adapter:unityads:4.6.0.0'
    implementation 'com.adop.sdk.adapter:vungle:7.4.3.0'
    implementation 'com.adop.sdk.adapter:mobwith:1.1.3'
    implementation 'com.adop.sdk.partners:admobbidding:1.1.1'
}
  1. AndroidManifest.xml 파일에 아래 코드들을 추가하세요.

    ...
    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.WAKE_LOCK" />
    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
    
    ...
    
    ...
    <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="테크랩스로부터 전달받은 애드몹 앱 아이디"/>
    <meta-data android:name="com.adop.sdk.APP_DOMAIN" android:value="테크랩스로부터 발급받은 앱 도메인"/>
    ...
    

초기화

import com.techlabs.luckieverse.core.Luckieverse

...
//럭키버스 SDK를 초기화합니다.
//이 초기화 함수를 가장 먼저 호출해주셔야 합니다.
Luckieverse.instance().initialize(activity = this)

//럭키버스 SDK를 사용할 앱에서 사용하는 사용자 식별자를 입력해주시면 됩니다.
//예 - 사용자 아이디, 멤버 아이디 등.
Luckieverse.instance().updateUserId("사용자 식별자")

//매체사를 식별하기 위한 앱 키입니다.
//개발 서버용 앱 키를 입력하면, 개발 서버로 접근이 가능합니다.
Luckieverse.instance().updateAppKey("테크랩스로부터 전달받은 럭키버스 앱 키")

//매체사를 식별하기 위한 타로 서비스 앱 키입니다.
//개발 서버용 앱 키를 입력하면, 개발 서버로 접근이 가능합니다.
Luckieverse.instance().updateTarotAppKey("테크랩스로부터 전달받은 타로 서비스 앱 키")

//같은 앱 키를 사용하면서 컨텐츠를 분기할 필요가 있을 때 메인 키를 사용합니다.
//사용하기로 협의되지 않았다면 이 값은 입력하지 않으셔도 됩니다.
Luckieverse.instance().updateMainKey("테크랩스로부터 전달받은 럭키버스 메인 키")

//쿠팡에서 추적 광고에 사용할 ADID 값을 입력해주세요.
Luckieverse.instance().updateADID("쿠팡 추적 광고에 사용할 adid")
...

네이티브 UI 요소를 통한 럭키버스 진입

import com.techlabs.luckieverse.core.Luckieverse
...
//럭키버스 메인 화면으로 진입
Luckieverse.instance().openLuckieverseMain(activity)

//럭키버스 타로 서비스 화면으로 진입
Luckieverse.instance().openLuckieverseTarot(activity)

//럭키버스 신년운세 서비스 진입
Luckieverse.instance().openNewYearFortune(activity)

클릭/터치 이벤트에 Luckieverse 싱글톤 클래스의 위 함수를 연결하세요. 럭키버스의 원하는 페이지로 이동하게 됩니다.

푸시 키를 통한 럭키버스 진입

Luckieverse.instance().openLuckieverseByPush(this, 푸시 키)
//포춘 쿠키의 푸시 키는 "fortune_cookie"

특정 컨텐츠 화면으로 곧장 진입할 때 사용합니다. 푸시 알림 등을 통해 진입할 때 사용하면 됩니다.

웹뷰에서 럭키버스 진입하기