Help Center/Details/

全屏视频

简介

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

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

权限

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

请求方法

备注:模板渲染全屏和SDK渲染全屏的广告请求方式上没有差异,仅是请求参数上的差异。
模板渲染的全屏视频请求方法中需要设置setExpressViewAcceptedSize参数 设置的值大于0即可

创建TTAdNative对象

//创建TTAdNative对象,createAdNative(Context context) context需要传入Activity对象
TTAdNative mTTAdNative = TTAdSdk.getAdManager().createAdNative(this);

模板渲染请求AdSlot

AdSlot adSlot = new AdSlot.Builder()
        .setCodeId(codeId)
        //模板广告需要设置期望个性化模板广告的大小,单位dp,激励视频场景,只要设置的值大于0即可
        且仅是模板渲染的代码位ID使用,非模板渲染代码位切勿使用
        .setExpressViewAcceptedSize(500,500)
        .setSupportDeepLink(true)
        .setOrientation(orientation)//必填参数,期望视频的播放方向:TTAdConstant.HORIZONTAL 或 TTAdConstant.VERTICAL
        .setAdLoadType(PRELOAD)//推荐使用,用于标注此次的广告请求用途为预加载(当做缓存)还是实时加载,方便后续为开发者优化相关策略
        .build();

SDK渲染请求AdSlot

TTAdNative mTTAdNative = TTAdSdk.getAdManager().createAdNative(this);
SDK渲染请求AdSlot
AdSlot adSlot = new AdSlot.Builder()
        .setCodeId(codeId)
        .setSupportDeepLink(true)
        .setOrientation(orientation)//必填参数,期望视频的播放方向:TTAdConstant.HORIZONTAL 或 TTAdConstant.VERTICAL
        .setAdLoadType(PRELOAD)//推荐使用,用于标注此次的广告请求用途为预加载(当做缓存)还是实时加载,方便后续为开发者优化相关策略
        .build();

参数说明

方法 说明
setCodeId() 平台创建的代码位ID 以9开头9位数字
setExpressViewAcceptedSize() 设置请求模板广告素材的尺寸 单位:dp 设置的值大于0(模板广告必填)。仅模板渲染全屏视频需要设置
setOrientation() 期望视频的播放方向 与创建代码位勾选的方向保持一致(必填)
setAdLoadType() 用于标注此次的广告请求用途为预加载(当做缓存)还是实时加载,方便后续为开发者优化相关策略,传入参数值:
UNKNOWN//未知,默认值,开发者未传入,或当此次加载的广告用途未知时使用
PRELOAD//预加载,当此次加载的广告用途为预加载(当作缓存)时使用
LOAD//实时加载,当此次加载的广告用途为实时播放时使用

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

请求广告

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

mTTAdNative.loadFullScreenVideoAd(adSlot, new TTAdNative.FullScreenVideoAdListener() {
	//请求广告失败
    @Override
    public void onError(int code, String message) {
       
    }
	//广告物料加载完成的回调
    @Override
    public void onFullScreenVideoAdLoad(TTFullScreenVideoAd ad)   {
       
    } 
   //广告视频本地加载完成的回调,接入方可以在这个回调后直接播放本地视频
    @Override
    public void onFullScreenVideoCached() {
   	
   }
);

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:宿主activity
RitScenes:广告展示的场景
String:广告展示场景为 CUSTOMIZE_SCENES 时,自定义的场景信息
void setShowDownLoadBar(boolean var1) boolean var1 方法说明:设置展示下载bar
参数说明:boolean型
True
false
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

if (mttFullVideoAd != null&&mIsLoaded) {
    //展示广告,并传入广告展示的场景
    mttFullVideoAd.showFullScreenVideoAd(FullScreenVideoActivity.this, TTAdConstant.RitScenes.GAME_GIFT_BONUS, null);
    mttFullVideoAd = null;
} else {
    TToast.show(FullScreenVideoActivity.this, "请先加载广告");
}

广告交互监听器

mttFullVideoAd.setFullScreenVideoAdInteractionListener(new TTFullScreenVideoAd.FullScreenVideoAdInteractionListener() {
	//广告的展示回调
    @Override
    public void onAdShow() {
       
    }
	//广告的下载bar点击回调
    @Override
    public void onAdVideoBarClick() {

   }
	//广告关闭的回调
    @Override
    public void onAdClose() {
       
    }
	//视频播放完毕的回调
    @Override
    public void onVideoComplete() {
       
    }
	//跳过视频播放
    @Override
    public void onSkippedVideo() {

    }
});

销毁广告对象

//在Activity的onDestroy方法中清空广告对象
 @Override
    protected void onDestroy() {
        super.onDestroy();
        if (mttFullVideoAd != null) {
           mttFullVideoAd = null;
       }
    }

参考Demo

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

Did the content solve your problem?
Contact us