AdUnity SDK 接入文档 v2.7.1
一、导入 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);4.5 横幅广告
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.1 | 2026.03.14 | 更新宅心 SDK 至 2.7.1,倍孜 SDK 至 5.2.3.2 |
| 2.7.0 | 2026.03.13 | 更新 SDK 版本,优化代码结构 |
| 2.6.1 | 2025.11.25 | 初始版本 |