SDK 集成

SDK 集成

此章节将演示如何集成ZJSDK到您的cocos creator项目中。

接入完成后,在正式上线前需要提供测试包,测试广告正常展现

测试信息

提示

SDK 不支持模拟器运行,需要使用真机调试

请联系运营人员获取正式的应用ID和广告位ID,测试广告位信息如下:

媒体IDapplicationId
Z2845395984com.zj.daylottery.addemo
类型ID类型ID
开屏广告J2190459774激励广告J9378481911
半屏插屏J7208384505全屏插屏J1556676069

注意

广告ID与包名是绑定关系,使用测试广告位信息时需要修改包名。

集成 SDK

SDK 需要在 cocos 项目中导入插件包,并在导出的原生工程中配置 build.gradle

提示

SDK 接入错误事项见常见问题

SDK 可运行于 Android5.0 (API Level 21) 及以上版本

导入插件包

将SDK压缩包内的 zjsdk_cocos_plug.zip 文件全部导入

导入脚本

配置 AndroidGradle

仓库和依赖

在导出的原生工程 module 中配置仓库与依赖

// module/build.gradle
import org.apache.tools.ant.taskdefs.condition.Os

apply plugin: 'com.android.application'

RES_PATH = RES_PATH.replace("\\", "/")
COCOS_ENGINE_PATH = COCOS_ENGINE_PATH.replace("\\", "/")

buildDir = "${RES_PATH}/proj/build/${project.name ==~ /^[_a-zA-Z0-9-]+$/ ? project.name : 'CocosGame'}"

/* 在此处添加仓库配置 */
rootProject.allprojects {
    repositories {
        maven {
            credentials {
                username '6409a2015d66d6f07e3b4611'
                password '(F(8W_UPpBj6'
            }
            url 'https://packages.aliyun.com/maven/repository/2029504-snapshot-5MgYio'
        }
        maven {
            url 'https://artifact.bytedance.com/repository/pangle'
        }
    }
}

android {
  // ...
}

dependencies {
    // ...
    /* 在此处添加 SDK 依赖项 */

    // x5内核,如已引入,可忽略
    implementation 'com.tencent.tbs:tbssdk:44286'
    // 微信 OpenSdk ,建议引入,提高收益
    implementation 'com.tencent.mm.opensdk:wechat-sdk-android:6.8.30'
    // 设备OAID,如已引入,可忽略
    implementation 'com.zj.zjsdk:oaid_sdk:1.0.25'

    // SDK包
    implementation 'com.zj.zjsdk:zjsdk-cocos-bridge:2.5.0.61'
    implementation 'com.zj.zjsdk:kssdk-ct:3.3.74'
    implementation 'com.pangle.cn:mediation-sdk:6.7.0.9'  // 融合SDK
    implementation 'com.zj.zjsdk:beizi_ad_sdk:3.5.0.43'
    implementation 'com.zj.zjsdk:beizi_fusion_sdk:4.90.4.43'
    implementation 'com.zj.zjsdk:octopus_ad_sdk:1.6.2.5'
    implementation 'com.zj.zjsdk:qy:2.0.47'
}


配置 gradle.properties

由于 Cocos 项目默认使用了 AndroidX,需要额外在build/android/proj/gradle.properties文件中增加一行配置

# ...

# 项目导出自带的配置
android.useAndroidX=true

# 新增这一行配置
android.enableJetifier=true
# 新增这一行配置

# ...