中文
登录
后可查看全部文档
开发测试/Android集成文档/新模版渲染插屏广告
新模版渲染插屏广告
最近更新 2026-03-17 16:35:03

一、简介

插屏广告场景一般为应用功能自然体验中断时,例如,暂停视频播放,游戏关卡之间。插屏广告不应突然出现,不应干扰用户使用应用的正常流程,例如应用加载,退出应用或者游戏过程中。

新插屏广告分为全屏、半屏、优选(全屏+半屏),不同场景下开发者都可以选择投放的广告类型,分别为图片+视频、仅视频、仅图片。

二、构建请求参数

1. 使用示例

创建TTAdNative对象

复制

构建请求AdSlot

复制

2. 接口说明

方法

说明

setCodeId()

平台创建的代码位ID 9开头9位数字

setAdLoadType()

用于标注此次的广告请求用途为预加载(当做缓存)还是实时加载,方便后续为开发者优化相关策略,传入参数值:
UNKNOWN:未知,默认值,开发者未传入,或当此次加载的广告用途未知时使用PRELOAD:预加载,当此次加载的广告用途为预加载(当作缓存)时使用
LOAD:实时加载,当此次加载的广告用途为实时播放时使用

三、请求及展示广告

接入方可调用loadFullScreenVideoAd加载广告,为广告视频素材的流畅,建议在 onFullScreenVideoCached 加载完毕后 ,再在主线程中调用showFullScreenVideoAd方法进行广告的展示,展示广告完毕之后及时把广告对象置为null

2. 使用示例

复制

2. 接口说明

方法

说明

onError()

广告请求失败回调 返回的错误码(code)说明请见链接

onFullScreenVideoAdLoad()

广告加载完成的回调

onFullScreenVideoCached()

广告视频/图片加载完成的回调,接入方可以在此回调调用showFullScreenVideoAd方法进行广告的展示

四、监听广告行为

1. 使用示例

复制

2. 接口说明

方法

说明

onAdShow()

广告的展示回调

onAdVideoBarClick()

广告下载bar点击回调

onAdClose()

广告关闭回调,当广告关闭时,开发者可根据项目实际情况做对应的逻辑处理

onVideoComplete()

视频播放完成回调

onSkippedVideo()

跳过视频播放回调,当点击跳过按钮时,开发者可根据项目实际情况做对应的逻辑处理,另点击跳过后会默认触发广告关闭回调

五、监听下载状态

在获取到TTFullScreenVideoAd对象之后,展示广告之前,调用setDownloadListener设置下载状态监听下载进度和状态;

复制

六、销毁广告对象

复制

七、资源

新插屏广告请参考demo中的FullScreenVideoActivity示例


本篇目录
联系我们