抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • JavaScript API
  • API 概览
  • 基础
  • 界面
  • 渲染
  • 数据缓存
  • 文件
  • 位置
  • 设备
  • 网络
  • 媒体
  • Worker
  • 数据分析
  • 支付
  • 广告
  • tt.createGridGamePanel
  • tt.createRewardedVideoAd
  • tt.createBannerAd
  • tt.createInterstitialAd
  • BannerAd
  • BannerAd
  • BannerAd.hide
  • BannerAd.show
  • BannerAd.onLoad
  • BannerAd.offLoad
  • BannerAd.onError
  • BannerAd.offError
  • BannerAd.onResize
  • BannerAd.offResize
  • BannerAd.destroy
  • RewardedVideoAd
  • InterstitialAd
  • GridGamePanel
  • 开放能力
  • C# API
  • 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

    返回值

    无

    错误码

    errNoerrMsg说明最低支持版本
    20001/s
    %s 代表占位符。
    1.3.0
    20000internal error
    小游戏框架内部错误,有需要请创建工单咨询
    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
    广告发送的次数已达当日上限
    一般第二天会恢复
    ​
    ​