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

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

    绑定 resize 事件的监听器。

    开发者除了可以在创建 bannerAd 实例时指定广告的 style,还可以在获得实例后修改其 style 属性中的属性值。一旦广告尺寸发生变化,会触发 resize 事件的监听器。监听器会获得一个包含 width 和 height 属性的对象参数,该参数表征广告的实际渲染尺寸。

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

    注意不要在该监听器内修改广告样式尺寸,否则会导致广告渲染死循环。

    相关教程

    语法

    BannerAd.onResize(callback)

    参数说明

    callback

    类型默认值必填说明最低支持版本
    function

    监听器函数

    1.3.0

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

    属性名类型说明最低支持版本
    widthnumber

    广告实际渲染的宽度

    1.3.0
    heightnumber

    广告实际渲染的高度

    1.3.0

    返回值

    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    999993internal errorF
    小游戏框架内部错误,有需要请创建工单咨询
    1.3.0
    999999invalid paramD
    1.3.0

    代码示例

    const { windowWidth, windowHeight } = tt.getSystemInfoSync(); const targetBannerAdWidth = 200; // 创建一个居于屏幕底部正中的广告 let bannerAd = tt.createBannerAd({ adUnitId: "YOUR_AD_UNIT_ID", style: { width: targetBannerAdWidth, top: windowHeight - (targetBannerAdWidth / 16) * 9, // 根据系统约定尺寸计算出广告高度 }, }); // 也可以手动修改属性以调整广告尺寸 bannerAd.style.left = (windowWidth - targetBannerAdWidth) / 2; // 尺寸调整时会触发回调,通过回调拿到的广告真实宽高再进行定位适配处理 // 注意:如果在回调里再次调整尺寸,要确保不要触发死循环!!! bannerAd.onResize((size) => { // good console.log(size.width, size.height); bannerAd.style.top = windowHeight - size.height; bannerAd.style.left = (windowWidth - size.width) / 2; // bad,会触发死循环 // bannerAd.style.width++; });