中文
登录
后可查看全部文档
开发测试/Android集成文档/全屏视频广告
全屏视频广告
最近更新 2022-01-30 11:23:08

简介

全屏视频广告,该广告的效果播放全屏的视频,视频一定时间后可跳过,无需全程观看完。

支持的广告尺寸: 全屏横屏(宽高比16:9)、全屏竖屏(宽高比9:16)。Android端暂不支持重力旋转


权限

模板渲染全屏视频广告:默认提供

SDK渲染全屏视频广告: 已回收,不再提供创建

请求方法

备注:模板渲染全屏和SDK渲染全屏的广告请求方式上没有差异,仅是请求参数上的差异。

模板渲染的全屏视频请求方法中需要设置setExpressViewAcceptedSize参数 设置的值大于0即可

创建TTAdNative对象

模板渲染请求AdSlot

SDK渲染请求AdSlot

参数说明

方法

说明

setCodeId()

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

setExpressViewAcceptedSize()

设置请求模板广告素材的尺寸 单位:dp 设置的值大于0(模板广告必填)。仅模板渲染全屏视频需要设置

setOrientation()

期望视频的播放方向 与创建代码位勾选的方向保持一致(必填)

setAdLoadType()

用于标注此次的广告请求用途为预加载(当做缓存)还是实时加载,方便后续为开发者优化相关策略,传入参数值:

UNKNOWN//未知,默认值,开发者未传入,或当此次加载的广告用途未知时使用

PRELOAD//预加载,当此次加载的广告用途为预加载(当作缓存)时使用

LOAD//实时加载,当此次加载的广告用途为实时播放时使用

注:模板渲染代码位setExpressViewAcceptedSize必填 ,SDK模板渲染代码位ID勿传

请求广告

接入方可调用loadFullScreenVideoAd(AdSlot adSlot, @NonNull FullScreenVideoAdListener listener)异步加载全屏视频广告

TTFullScreenVideoAd

方法

参数

说明

Void setFullScreenVideoAdInteractionListener(TTFullScreenVideoAd.FullScreenVideoAdInteractionListener var1)

TTFullScreenVideoAd.FullScreenVideoAdInteractionListener var1

方法说明:注册插屏广告交互回调参数说明:listener 交互监听器

void setDownloadListener(TTAppDownloadListener var1)

TTAppDownloadListener var1

方法说明:注册广告的下载回调参数说明:listener 下载状态回调

int getInteractionType();

方法说明:得到广告的交互类型参数说明2:在浏览器内打开 (普通类型)3:落地页(普通类型)4:应用下载5:拨打电话 -1:未知类型

@MainThread void showFullScreenVideoAd(Activity var1)

Activity var1

方法说明:展示全屏视频接口参数说明:Activity:宿主activity

void showFullScreenVideoAd(Activity var1, RitScenes var2, String var3);

Activity var1, RitScenes var2, String var3

方法说明:展示全屏视频接口参数说明:Activity:宿主activityRitScenes:广告展示的场景String:广告展示场景为 CUSTOMIZE_SCENES 时,自定义的场景信息

void setShowDownLoadBar(boolean var1)

boolean var1

方法说明:设置展示下载bar参数说明:boolean型Truefalse

Map<String, Object> getMediaExtraInfo()

方法说明:返回广告额外信息参数说明:无

int getFullVideoAdType()

方法说明:返回广告真实类型 参数说明TTAdConstant.AD_TYPE_UNKNOWN = -1;//未知类型TTAdConstant.AD_TYPE_COMMON_VIDEO //普通视频类型TTAdConstant.AD_TYPE_PLAYABLE_VIDEO //video + playable 类型TTAdConstant.AD_TYPE_PLAYABLE //playable类型

long getExpirationTimestamp()

方法说明:返回有效期的截止时间,超过这个时间点,广告视为过期,开发者可以通过这个接口判断当前广告,什么时间过期参数说明:无

public interface FullScreenVideoAdInteractionListener

见FullScreenVideoAdInteractionListener说明

FullScreenVideoAdInteractionListener

方法

说明

onAdShow()

广告的展示回调

onAdVideoBarClick()

广告下载bar点击回调

onAdClose()

广告关闭回调

onVideoComplete()

视频播放完成回调

onSkippedVideo()

跳过视频播放回调

FullScreenVideoAdListener

方法

说明

onError()

广告请求失败回调 返回的错误码(code)表示广告请求失败的原因,详情请见链接

onFullScreenVideoAdLoad()

广告加载完成的回调

onFullScreenVideoCached()

广告视频本地加载完成的回调,接入方可以在这个回调后直接播放本地视频

onFullScreenVideoCached(TTFullScreenVideoAd ad)

广告视频本地加载完成的回调,可以在这个回调后直接播放本地视频,直接使用参数对象来播放

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

广告交互监听器

销毁广告对象

参考Demo

全屏视频广告请参考demo中的FullScreenVideoActivity示例


本篇目录
联系我们