logo

帮助中心/文档详情/

Android全屏视频广告

简介

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

支持的广告尺寸: 全屏横屏(宽高比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
        .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
        .build();

参数说明

方法 说明
setCodeId() 平台创建的代码位ID 以9开头9位数字
setExpressViewAcceptedSize() 设置请求模板广告素材的尺寸 单位:dp 设置的值大于0(模板广告必填)。仅模板渲染全屏视频需要设置
setOrientation() 期望视频的播放方向 与创建代码位勾选的方向保持一致(必填)

注:模板渲染代码位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() {
   	
   }
);

FullScreenVideoAdListener

方法 说明
onError() 广告请求失败回调 返回的错误码(code)表示广告请求失败的原因,详情请见链接
onFullScreenVideoAdLoad() 广告加载完成的回调
onFullScreenVideoCached() 广告视频本地加载完成的回调,接入方可以在这个回调后直接播放本地视频

注:为广告视频素材的流畅,建议在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() {

    }
});
FullScreenVideoAdInteractionListener
方法 说明
onAdShow() 广告的展示回调
onAdVideoBarClick() 广告下载bar点击回调
onAdClose() 广告关闭回调
onVideoComplete() 视频播放完成回调
onSkippedVideo() 跳过视频播放回调

销毁广告对象

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

参考Demo

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

文档内容是否对您有帮助?
联系我们