抖音开放平台Logo
开发者文档
控制台
  • API 概览
  • 开放能力
  • 基础
  • 渲染
  • 设备
  • 文件
  • 位置
  • 媒体
  • 网络
  • 游戏转发分享
  • 实时语音
  • 数据缓存
  • 系统
  • 广告
  • tt.createBannerAd
  • tt.createRewardedVideoAd
  • tt.createInterstitialAd
  • BannerAd
  • BannerAd
  • BannerAd.show
  • BannerAd.hide
  • BannerAd.onLoad
  • BannerAd.offLoad
  • BannerAd.onError
  • BannerAd.offError
  • BannerAd.onResize
  • BannerAd.offResize
  • BannerAd.destroy
  • RewardedVideoAd
  • InterstitialAd
  • 界面
  • 支付
  • Worker
  • BannerAd.show
    收藏
    我的收藏

    基础库 1.3.0 开始支持本方法,这是一个同步方法。

    广告创建后默认是隐藏的,可以通过该方法显示广告。 该方法返回一个 Promise 对象。当广告组件正常获取素材时,该 Promise 对象会是一个 resolved Promise。当广告组件发生错误时,会是一个 rejected Promise,参数与 error 事件监听器获得的参数相同。

    前提条件
    业务背景
    使用限制
    注意事项

    必须调用 BannerAd.onLoad 监听广告素材成功拉取后才能调用 BannerAd.show,否则广告将无法及时展示

    相关教程

    语法

    BannerAd.show()

    参数说明

    返回值

    类型说明最低支持版本
    Promise

    Promise 对象

    1.3.0

    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    122407Just shown an Ad, can't show now!D
    1.3.0
    999987feature is not supported in appD
    1.3.0
    999991context exceptionF
    小游戏框架内部错误,有需要请创建工单咨询
    1.3.0
    122401current activity is null, can not create game bannerD
    1.3.0
    122403Please apply for an adUnitIdD
    1.3.0
    122402can not create game bannerF
    小游戏框架内部错误,有需要请创建工单咨询
    1.3.0
    999987The scene does not support advertisingD
    1.3.0
    999999The adUnitId is emptyD
    1.3.0
    122404The adUnitId is closedD
    1.3.0
    122405The adUnitId is prohibitD
    1.3.0
    122406The adUnitId is invalidD
    1.3.0
    999993internal errorF
    小游戏框架内部错误,有需要请创建工单咨询
    1.3.0
    999986Just shown an Ad, can't show now!D
    1.3.0
    999986GridGamePanel with the same gridCount can show most oneD
    重复报 callback & event
    1.3.0
    999986The banner advertisement has triggered fallback, but fallback ad has shown too many times todayD
    重复报
    1.3.0
    122410The banner advertisement for current adUnitId hasn't completed loadingD
    1.3.0
    122410ad is not loaded, try call `show` in `onLoad` methodD
    重复报
    1.3.0
    122409ad not foundD
    1.3.0
    999999unitid is illegalD
    1.3.0
    122403unitid is illegalD
    1.3.0
    122407unitid is illegalD
    1.3.0
    122404unitid is illegalD
    1.3.0
    122405unitid is illegalD
    1.3.0
    999993unitid is illegalF
    小游戏框架内部错误,有需要请创建工单咨询
    1.3.0
    122409The banner advertisement for current adUnitId doesn't existD
    1.3.0
    999999The adUnitId is emptyD
    1.3.0
    122403The adUnitId is invalidD
    1.3.0
    122407unknown ad typeD
    1.3.0
    999993The adUnitId is invalidF
    小游戏框架内部错误,有需要请创建工单咨询
    1.3.0
    999993type is illegal paramF
    小游戏框架内部错误,有需要请创建工单咨询
    1.3.0
    999994app has enter backgroundU
    1.3.0

    代码示例

    const bannerAd = tt.createBannerAd({ adUnitId: "xxxx", }); bannerAd.onLoad(() => { bannerAd .show() .then(() => { console.log("广告显示成功"); }) .catch((err) => { console.log("广告组件出现问题", err); }); });