中文
登录
后可查看全部文档
开发测试/Android集成文档/SDK初始化配置
SDK初始化配置
最近更新 2022-03-24 14:51:44

重点

穿山甲SDK需要在主线程中初始化

多进程涉及WebView的使用,用户想要使用自己的数据路径,可以在SDK初始化之前调用WebView.setDataDirectorySuffix()

开发者需要在Application#onCreate()方法中调用以下代码来初始化穿山甲sdk。重点: 目前SDK已支持多进程,如果明确某个进程不会使用到广告SDK,可以只针对特定进程初始化广告sdk


初始化接口说明

3450以上版本SDK初始化

调整说明:穿山甲在3450版本对SDK的初始化方法进行了较大的改动,支持了同步初始化异步初始化两种方式,并且TTAdConfig.Builder中支持异步初始化API将不再生效。优化后同步初始化异步初始化两种方式的耗时没有显著差异,后者将部分初始化逻辑放到了子线程。开发者若使用异步初始化方法,请注意需要在success回调之后再去请求广告。

新增初始化接口

重点说明:若您接入的是穿山甲Pro版本的SDK,则只能使用异步初始化的方式。同时混淆规则也要同步调整

穿山甲SDK初始化API:**该API必须在主线程中调用,穿山甲会将初始化操作放在子线程执行。**

fail回调状态码

vale

说明

4000

本地执行API错误导致初始化错误码


初始化状态接口
调整API

穿山甲SDK初始化方法:该API调整为必须在主线程中调用,初始化操作会在主线程执行。

过期&无效API

3450以下版本SDK初始化方法

注意: AppId为必填内容,若appid是通过服务端下发的,那么在初始化前需要做不为空的判断。

隐私信息控制开关

示例:

注意:

  • 重写getTTLocation()之前需要设置isCanUseLocation()
  • 重写getDevImei()之前需要先设置isCanUsePhoneState()

构建TTAdManager对象

TTAdManager对象为整个SDK的入口接口,可用于广告获取权限请求版本号获取等

构建方法

TTAdManger接口说明

夜间模式

SDK导入需要注意的点:

1、TTAdManagerHolder保持单例模式

2、单进程多次初始化SDK以第一次初始设置的信息为主;

3、appId是平台上穿件应用生成的7位数字;

4、任何类型的视频广告加载后播放出现黑屏都可以按以下方式尝试解决:

  • 清单文件中的黑屏权限是否添加
  • 尝试使用TextureView控件播放视频

5、appName不为空即可 建议和平台创建的应用名称保持一致

6、directDownloadNetworkType配置:

  • 可根据具体的产品需求自行配置,方法中的网络集合为允许直接下载的网络
  • 若需要在任何网络下用户下载都有确认弹窗,方法中里直接写空(非null)即可

7、supportMultiProcess说明:

  • 若项目是单进程必须更改为false
  • 若项目是多进程,则需要设置true。多进程中如果每个进程中都需要展示广告 必须每个进程都进行SDK的初始化 如果您的应用需要支持多进程,请务必设置TTAdConfig.supportMultiProcess(true)。确认app多进程支持判断方法:a、穿山甲sdk初始化b、穿山甲广告获取c、穿山甲广告展示这三个关键点的调用在不同进程则为多进程,否则即为单进程如非必要尽量不要使用多进程开关,多进程效率不如单进程高

8、provider配置

  • 无论单进程还是多进程都必须配置穿山甲所需provider
  • 无论平台应用处于测试状态还是正式状态都需要配置provider
  • 为不影响到广告的转化及收益 请务必在清单文件中配置xxx.TTMultiProvider

9、如果您的应用对资源也进行混淆(如andResGuard),请不要混淆穿山甲的任何资源,防止资源找不到而发生崩溃的问题。

SDK压缩文件内whiteList.txt 白名单上的资源不支持混淆 ,开发者在SDK更新迭代过程中需要重新检查一遍白名单内容


本篇目录
联系我们