Help Center/Details/

Full screen video


Full-screen video ads. The effect of this ad is to play full-screen videos. The video can be skipped after a certain period of time without having to watch the whole process.
Supported ad sizes: Full screen horizontal screen (aspect ratio 16:9), full screen vertical screen (aspect ratio 9:16). Android does not currently support gravity rotation权限
Template rendering full-screen video ads:Provided by default
SDK renders full-screen video ads: Reclaimed,No longer offer to create

Request method

Note: There is no difference between the template rendering full-screen and SDK rendering full-screen ad request methods, only the difference in request parameters.
The setExpressViewAcceptedSize parameter needs to be set in the full-screen video request method of template rendering. The value set is greater than 0.

Create TTAdNative object

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

Template rendering request AdSlot

AdSlot adSlot = new AdSlot.Builder()
        .setOrientation(orientation)//必填参数,期望视频的播放方向:TTAdConstant.HORIZONTAL 或 TTAdConstant.VERTICAL

SDK rendering request AdSlot

TTAdNative mTTAdNative = TTAdSdk.getAdManager().createAdNative(this);
AdSlot adSlot = new AdSlot.Builder()
        .setOrientation(orientation)//必填参数,期望视频的播放方向:TTAdConstant.HORIZONTAL 或 TTAdConstant.VERTICAL
Parameter description
Method Description
setCodeId() The code ID created by the platform starts with 9 and 9 digits
setExpressViewAcceptedSize() Set the size of the requested template creative. Unit: dp Set the value greater than 0 (required for template ads).Only the template needs to be set to render full-screen video.

Note: The template rendering code bit setExpressViewAcceptedSize is required, and the SDK template rendering code bit ID should not be passed.

Request ad

The access party can call loadFullScreenVideoAd(AdSlot adSlot, @NonNull FullScreenVideoAdListener listener) to asynchronously load the full-screen video ad

mTTAdNative.loadFullScreenVideoAd(adSlot, new TTAdNative.FullScreenVideoAdListener() {
    public void onError(int code, String message) {
    public void onFullScreenVideoAdLoad(TTFullScreenVideoAd ad)   {
    public void onFullScreenVideoCached() {


Method Parameter Description
Void setFullScreenVideoAdInteractionListener(TTFullScreenVideoAd.FullScreenVideoAdInteractionListener var1) TTFullScreenVideoAd.FullScreenVideoAdInteractionListener var1 Method description: Register interactive callback for interstitial ads
Parameter description: listener interactive listener
void setDownloadListener(TTAppDownloadListener var1) TTAppDownloadListener var1 Method description: download callback of registered advertisement
Parameter description: listener download status callback
int getInteractionType() No Method description: get the interactive type of the ad
Parameter description
2: Open in the browser (normal type)
3: Landing page (common type)
4: Application download
5: Make a call
-1: Unknown type
@MainThread void showFullScreenVideoAd(Activity var1) Activity var1 Method description: display full screen video interface
Parameter description: Activity: host activity
void showFullScreenVideoAd(Activity var1, RitScenes var2, String var3) Activity var1, RitScenes var2, String var3 Method description: display full screen video interface
Parameter description:
Activity: host activity
RitScenes: The scene where the ad is displayed
String: When the advertisement display scene is CUSTOMIZE_SCENES, the customized scene information
void setShowDownLoadBar(boolean var1) boolean var1 Method description: set display download bar
Parameter description: boolean type
Map<String, Object> getMediaExtraInfo() No Method description: return additional information about the ad
Parameter description: none
int getFullVideoAdType() No Method description: return the true type of the ad
Parameter description
TTAdConstant.AD_TYPE_UNKNOWN = -1;//Unknown type
TTAdConstant.AD_TYPE_COMMON_VIDEO //Ordinary video type
TTAdConstant.AD_TYPE_PLAYABLE_VIDEO //video + playable type
TTAdConstant.AD_TYPE_PLAYABLE //playable type
long getExpirationTimestamp() No Method description: Return the expiration time of the validity period. After this point in time, the advertisement is considered expired. Developers can use this interface to determine the current advertisement and when it expires
Parameter description: none
public interface FullScreenVideoAdInteractionListener No See FullScreenVideoAdInteractionListener description


Method Description
onAdShow() Ad display callback
onAdVideoBarClick() Advertisement download bar click callback
onAdClose() Ad close callback
onVideoComplete() Video playback complete callback
onSkippedVideo() Skip video playback callback


Method Description
onError() Advertisement request failed callback The returned error code (code) indicates the reason why the advertisement request failed. For details, please see
onFullScreenVideoAdLoad() Callback when ad loading is complete
onFullScreenVideoCached() Callback for the completion of the local loading of the advertising video, the access party can directly play the local video after this callback
onFullScreenVideoCached(TTFullScreenVideoAd ad) The callback for the completion of the local loading of the ad video, the local video can be played directly after the callback, and the parameter object can be used to play directly

Note: For the smoothness of the advertising video material, it is recommended to call the showFullScreenVideoAd method in the main thread to display the advertisement after the onFullScreenVideoCached method is loaded. Set the advertising object to null in time after displaying the advertisement

if (mttFullVideoAd != null&&mIsLoaded) {
    mttFullVideoAd.showFullScreenVideoAd(FullScreenVideoActivity.this, TTAdConstant.RitScenes.GAME_GIFT_BONUS, null);
    mttFullVideoAd = null;
} else {, "请先加载广告");

Advertising interaction listener

mttFullVideoAd.setFullScreenVideoAdInteractionListener(new TTFullScreenVideoAd.FullScreenVideoAdInteractionListener() {
    public void onAdShow() {
    public void onAdVideoBarClick() {

    public void onAdClose() {
    public void onVideoComplete() {
    public void onSkippedVideo() {


Destroy the ad object

    protected void onDestroy() {
        if (mttFullVideoAd != null) {
           mttFullVideoAd = null;

Reference Demo
For full-screen video ads, please refer to the FullScreenVideoActivity example in the demo

Did the content solve your problem?
Contact us