Log In
You can then view all documents
Installation/Android/Full screen video
Full screen video
Last updated 2022-01-19 21:57:46

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 defaultSDK 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

Template rendering request AdSlot

SDK rendering request AdSlot

Parameter description




The code ID created by the platform starts with 9 and 9 digits


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





Void setFullScreenVideoAdInteractionListener(TTFullScreenVideoAd.FullScreenVideoAdInteractionListener var1)

TTFullScreenVideoAd.FullScreenVideoAdInteractionListener var1

Method description: Register interactive callback for interstitial adsParameter description: listener interactive listener

void setDownloadListener(TTAppDownloadListener var1)

TTAppDownloadListener var1

Method description: download callback of registered advertisementParameter description: listener download status callback

int getInteractionType()


Method description: get the interactive type of the adParameter description2: Open in the browser (normal type)3: Landing page (common type)4: Application download5: Make a call-1: Unknown type

@MainThread void showFullScreenVideoAd(Activity var1)

Activity var1

Method description: display full screen video interfaceParameter description: Activity: host activity

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

Activity var1, RitScenes var2, String var3

Method description: display full screen video interfaceParameter description:Activity: host activityRitScenes: The scene where the ad is displayedString: When the advertisement display scene is CUSTOMIZE_SCENES, the customized scene information

void setShowDownLoadBar(boolean var1)

boolean var1

Method description: set display download barParameter description: boolean typeTruefalse

Map<String, Object> getMediaExtraInfo()


Method description: return additional information about the adParameter description: none

int getFullVideoAdType()


Method description: return the true type of the adParameter descriptionTTAdConstant.AD_TYPE_UNKNOWN = -1;//Unknown typeTTAdConstant.AD_TYPE_COMMON_VIDEO //Ordinary video typeTTAdConstant.AD_TYPE_PLAYABLE_VIDEO //video + playable typeTTAdConstant.AD_TYPE_PLAYABLE //playable type

long getExpirationTimestamp()


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 expiresParameter description: none

public interface FullScreenVideoAdInteractionListener


See FullScreenVideoAdInteractionListener description





Ad display callback


Advertisement download bar click callback


Ad close callback


Video playback complete callback


Skip video playback callback





Advertisement request failed callback The returned error code (code) indicates the reason why the advertisement request failed. For details, please see https://www.csjplatform.com/support/doc/5de4cc6d78c8690012a90aa5?from=ad.oceanengine.com&id=5de4cc6d78c8690012a90aa5


Callback when ad loading is complete


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

Advertising interaction listener

Destroy the ad object

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

Contact us