抖音开放平台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.onError
    收藏
    我的收藏

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

    绑定 error 事件的监听器。 广告组件拉取广告素材时如果发生错误,会触发 error 事件的监听器。

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

    语法

    BannerAd.onError(callback)

    参数说明

    callback

    类型默认值必填说明最低支持版本
    function
    事件监听器
    1.3.0

    callback 是一个回调函数,接收 object 类型的参数,属性如下:

    属性名类型说明最低支持版本
    errCodenumber
    错误码
    1.3.0
    errMsgstring
    错误信息
    1.3.0

    返回值

    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    122800/sD
    %s 代表占位符。
    1.3.0
    999993internal errorF
    小游戏框架内部错误,有需要请创建工单咨询
    1.3.0

    代码示例

    bannerAd.onError(({ errorCode, errMsg }) => { console.log(errorCode, errMsg) })

    错误码详情

    异常
    说明
    解决方案
    1000
    后端错误调用失败
    该项错误不是开发者的异常情况
    一般情况下忽略一段时间即可恢复
    1001
    参数错误
    使用方法错误
    查看 api 文档
    1002
    广告单元无效
    可能是拼写错误、或者误用了其他 APP 的广告 ID
    1003
    内部错误
    该项错误不是开发者的异常情况
    一般情况下忽略一段时间即可恢复
    1004
    无适合的广告
    广告不是每一次都会出现,这次没有出现可能是由于该用户不适合浏览广告
    属于正常情况,且开发者需要针对这种情况做形态上的兼容。
    1005
    广告组件审核中
    广告正在被审核,无法展现广告
    1006
    广告组件被驳回
    广告审核失败,无法展现广告
    1007
    广告能力被禁用
    广告能力已经被封禁,封禁期间无法展现广告
    1008
    广告单元已关闭
    该广告位的广告能力已经被关闭
    20002
    不支持 banner 广告 API
    该 APP 暂不支持 banner 广告
    检测对应的应用(appName)进行兼容,抖音暂不支持 banner 广告
    120002
    广告发送的次数已达当日上限
    一般第二天会恢复