← 返回首页

AdUnity SDK 接入文档 v2.7.1

更新时间:2026.03.14

一、导入 SDK

将 SDK 包中的 aar 放入工程的 libs 目录下,并添加以下依赖:

repositories {
    flatDir { dirs 'libs' }
}
dependencies {
    // 广告平台 SDK
    implementation(name: 'Beizi_v5.2.3.2', ext: "aar")
    implementation(name: 'CSJ_v7.4.2.0', ext: "aar")
    implementation(name: 'GDT_v4.671.1541', ext: "aar")
    implementation(name: 'Baidu_v9.432', ext: "aar")
    implementation(name: 'Kuaishou_v5.1.20.1', ext: "aar")
    implementation(name: 'JD_v2.6.32', ext: 'aar')
    implementation(name: 'Octopus_v1.6.4.7', ext: "aar")
    implementation(name: 'Meishu_v2.5.8.11', ext: 'aar')
    implementation(name: 'Domob_v3.6.1', ext: 'aar')
    implementation(name: 'Maimeng_v7.4.10.0', ext: 'aar')
    implementation(name: 'wind-common-1.8.6', ext: 'aar')
    implementation(name: 'wind-sdk-4.24.7', ext: 'aar')
    implementation(name: 'anythink_china_core', ext: 'aar')
    implementation(name: 'anythink_core', ext: 'aar')
    implementation(name: 'anythink_banner', ext: 'aar')
    implementation(name: 'anythink_interstitial', ext: 'aar')
    implementation(name: 'anythink_native', ext: 'aar')
    implementation(name: 'anythink_rewardvideo', ext: 'aar')
    implementation(name: 'anythink_splash', ext: 'aar')
    implementation(name: 'adgain-sdk-4.2.3.2', ext: 'aar')
    implementation(name: 'fissionSdk-release-1.0.87.81-amp', ext: 'aar')
    implementation(name: 'LYAdSDK-android-v3.1.33', ext: 'aar')
    implementation(name: 'adview-android-5.0.3', ext: 'aar')
    implementation(name: 'OAID_v1.0.25', ext: 'aar')
    // 基础依赖
    implementation 'androidx.appcompat:appcompat:1.0.0'
    implementation 'androidx.legacy:legacy-support-v4:1.0.0'
    implementation 'androidx.recyclerview:recyclerview:1.0.0'
    implementation 'androidx.swiperefreshlayout:swiperefreshlayout:1.1.0'
    implementation 'com.github.gzu-liyujiang:Android_CN_OAID:4.2.4'
    // 第三方库
    implementation 'com.squareup.okhttp3:okhttp:4.12.0'
    implementation 'com.squareup.okio:okio:3.6.0'
    implementation "com.android.support.constraint:constraint-layout:2.0.4"
    implementation 'com.google.code.gson:gson:2.8.6'
    implementation 'androidx.cardview:cardview:1.0.0'
    implementation 'com.github.bumptech.glide:glide:4.12.0'
    implementation 'com.google.protobuf:protobuf-java:4.27.5'
    implementation 'com.tencent.mm.opensdk:wechat-sdk-android:6.8.0'
    implementation "com.huawei.hms:ads-lite:13.4.78.301"
    implementation "com.google.guava:guava:31.0.1-android"
}

二、AndroidX 配置

如工程使用 AndroidX,在 gradle.properties 中添加:

android.useAndroidX=true
android.enableJetifier=true

三、初始化

在 Application 的 onCreate 中初始化:

// AppID 请联系商务申请
ZXAD.init(this, APP_ID);

四、广告类型

4.1 开屏广告

// POSID 请联系商务获取
SplashAd ad = new SplashAd(POSID);
ad.enableDebug();

ad.setAdLoadListener(new AdLoadListener() {
    @Override
    public void onLoad() { ad.show(content); }
    @Override
    public void onNoAd(int code, String message) {
        handler.postDelayed(() -> gotoMain(), 3000);
    }
});

ad.setAdViewListener(new AdViewListener() {
    @Override public void onClose() { gotoMain(); }
    @Override public void onResourceError() { gotoMain(); }
});

ad.load(this);

4.2 激励视频

RewardVideoAd ad = new RewardVideoAd(POSID);
ad.enableDebug();

ad.setAdLoadListener(new AdLoadListener() {
    @Override public void onLoad() { ad.show(MainActivity.this); }
});

ad.setAdViewListener(new AdViewListener() {
    @Override public void onReward() {
        Toast.makeText(MainActivity.this, "奖励已获取", Toast.LENGTH_SHORT).show();
    }
});

ad.load(MainActivity.this);

4.3 全屏视频

FullScreenAd ad = new FullScreenAd(POSID);
ad.enableDebug();

ad.setAdLoadListener(new AdLoadListener() {
    @Override public void onLoad() { ad.show(MainActivity.this); }
    @Override public void onNoAd(int code, String message) {
        Toast.makeText(MainActivity.this, "无广告", Toast.LENGTH_SHORT).show();
    }
});

ad.load(MainActivity.this);

4.4 插屏广告

InterstitialAd ad = new InterstitialAd(POSID);
ad.enableDebug();

ad.setAdLoadListener(new AdLoadListener() {
    @Override public void onLoad() { ad.show(MainActivity.this); }
    @Override public void onNoAd(int code, String message) {
        Toast.makeText(MainActivity.this, message, Toast.LENGTH_SHORT).show();
    }
});

ad.load(MainActivity.this);
BannerAd ad = new BannerAd(POSID);
ad.enableDebug();

ad.setAdLoadListener(new AdLoadListener() {
    @Override public void onLoad() { ad.show(mContent); }
});

ad.load(MainActivity.this, mContent.getWidth(), mContent.getHeight());

4.6 信息流广告

FeedAd advert = new FeedAd(POSID);
advert.enableDebug();

advert.setAdLoadListener(new FeedLoadListener() {
    @Override public void onLoad(List list) {
        adapter.addData(fakeData, list);
    }
    @Override public void onNoAd(int code, String message) {
        adapter.addData(fakeData, Collections.emptyList());
    }
});

advert.load(this);

五、其他 API

获取 SDK 版本

String version = ZXAD.getVersion();

错误回调

所有广告的 onNoAd 回调中,message 参数会列出所有三方平台的错误代码和信息,请据此调试。

六、常见问题

1. 最低系统版本

宅心科技 SDK 仅支持 minSdkVersion ≥ 24(Android 7.0)

2. POSID 获取

请联系商务申请各广告类型的 POSID

3. 调试模式

调用 ad.enableDebug() 可开启 SDK 调试日志,发布前请关闭

更新日志

版本日期说明
2.7.12026.03.14更新宅心 SDK 至 2.7.1,倍孜 SDK 至 5.2.3.2
2.7.02026.03.13更新 SDK 版本,优化代码结构
2.6.12025.11.25初始版本