常见问题

接入与编译

编译时报错 Build is failing with unexpected element <queries> found in <manifest> 或类似错误，关键词为 <queries>

这个是 Android11 的版本适配声明，需要升级 gradle 插件版本大于 4.0 或手动编辑 SDK 的 aar 中 AndroidManifest.xml，移除<application>标签下的<queries>内容

编译时报错 Unknown option '-keep' in line 1 of file 'xxxx\proguard.txt'

需要升级 gradle 插件版本大于 4.0 或手动将 SDK 的 aar 中proguard.txt内容复制到工程的混淆配置中，并在 aar 中删除该文件

SDK 初始化时机

SDK 支持延迟初始化，但需要确保 SDK 在主进程初始化，且第一次调用广告位与发起初始化之间有 1s 的间隔

需要将工程的 targetSdkVersion 降为28或以下

编译时出现 AndroidManifest 的 networkSecurityConfig 错误

需手动删除 SDK 包中 AndroidManifest.xml 的 <application> 标签下关于 networkSecurityConfig 的配置，并确保应用的 networkSecurityConfig 中配置了 usesCleartextTraffic=true

请求广告时出现 Crash ，错误信息为方法错误、方法校验失败等

需要更新至最新版本SDK

请求广告时报错包名不匹配

使用测试 ID 拉取广告时，需要将应用的applicationId也修改为测试的包名

Android11 设备使用移动网络时，无法加载广告且没有回调

修改应用的 targetSdkVersion 小于 30 或更新 SDK

ZJSDK 的 minSdkVersion 为 21，部分渠道 SDK 为 24，如果您的工程最低支持 21，请在主 module 的AndroidManifest.xml中添加<uses-sdk tools:overrideLibrary="com.bytedance.gromore,com.bytedance.sdk.openadsdk,com.bytedance.tools"/> 如配置中已有tools:overrideLibrary，则追加内容

android:label 冲突

请在主 module->AndroidManifest.xml-><Application节点下添加android:lable="YOUR_LABEL"配置，然后追加tools:replace="android:label配置以覆盖

如果提示找不到 tools 的 NS，在<Manifest节点追加xmlns:tools="http://schemas.android.com/tools"

android:allowBackup 冲突

请在主 module->AndroidManifest.xml-><Application节点下添加android:allowBackup="YOUR_STRATEGY"配置，然后追加tools:replace="android:allowBackup配置以覆盖

如果提示找不到 tools 的 NS，在<Manifest节点追加xmlns:tools="http://schemas.android.com/tools"

初始化

初始化报错 init error#java.lang.IllegalStateException:ignore init on process:com.xxx.yyy:zzzz

SDK不支持多进程调用，子进程的初始化会被忽略，调用时会抛出错误信息日志，但子进程的错误不影响主进程的调用，可以忽略

开屏广告

开屏广告的跳转设置

确认 ZJSplashAdInteractionListener 中的 onSplashAdClose()、onSplashAdShowError()回调方法都有做跳转的响应
确认开屏广告页面没有做超时自动跳转，只通过以上回调方法作为判断去跳转页面

需要修改容器的高度大于设备屏幕高度的95%
需要确认开屏广告的容器没有其他组件覆盖
使用RelativeLayout或ConstraintLayout时会偶现错误，建议使用FrameLayout作为开屏广告的容器

    private var isPaused = false       // 广告被点击后，当前activity是否pause
    private var isAdClicked = false    // 广告被点击
    private var isAdClosed = false     // 广告已结束

    private fun loadAd() {
        // 加载广告
        ZJSplashAd.loadAd(this, posId, object : ZJSplashAdLoadListener {
            
            override fun onError(code: Int, msg: String) {
                Log.e("ZJSplashAd", "开屏广告加载出错$code-$msg")
            }

            override fun onAdLoaded(splashAd: ZJSplashAd) {
                // 广告加载成功，配置交互回调
                splashAd.setAdInteractionListener(this@SplashActivity)
                splashAd.show(this@SplashActivity.container)
            }

        })
    }

    override fun onPause() {
        super.onPause()
        if (isAdClicked) {
            isPaused = true
        }
    }

    override fun onResume() {
        super.onResume()
        if (isPaused && isAdClosed) {
            jump()
        } else {
            isPaused = false
        }
    }
    
    //==================================================ZJSplashAdInteractionListener

    /**
     * 开屏点击
     */
    override fun onSplashAdClick() {
        isAdClicked = true
    }

    /**
     * 关闭
     */
    @Override
    override fun onSplashAdClose() {
        isAdClosed = true
        if (!isPaused) {
            jump()
        }
    }

视频内容的回调中可以根据播放状态计时
视频内容回调的ContentItem对象的id属性为唯一标识，materialType属性为视频类型
视频内容的计时与计次任务演示可以参考示例工程

H5页面

H5任务页无法获取到任务

调用ZJH5Ad时传入的ZjUser.userName如有特殊字符，需要进行urlEncode处理

常见问题

常见问题

目录