1. 描述

本模块将个小游戏平台的banner接口进行封装，方便游戏内调用统一接口展示banner广告

请注意

抖音平台（或称作字节）不允许游戏界面展示banner，如果游戏界面展示了banner会有审核被拒的风险，所以建议抖音平台仅在弹窗界面、结束界面等不直接影响用户游戏操作的页面展示banner。

展示位置

banner默认在屏幕底部并铺满屏幕宽展示；

另外SDK还提供了一个接口GameHelper.AdsFunc.initBannerTop(y:number)控制banner的展示位置，主要有两个作用：

banner刷新

SDK支持banner每间隔一定时间自动刷新，可通过广告后台参数自定义修改

2. 接入说明

2.1 展示banner

在需要展示banner的页面调用GameHelper.AdsFunc.showBanner()；

当某个页面不需要banner时，调用GameHelper.AdsFunc.hideBanner()；

如果需要banner以游戏页面某个固定高度作为banner最高点时，可以调用GameHelper.AdsFunc.initBannerTop并传入该点的y坐标值即可，banner将紧贴该位置进行展示；

传入y坐标值时请注意以Canvas坐标系为锚点（即画面中心）；

如下图，传入第二条红色的line2的y坐标值（-450），banner将紧贴line2位置进行展示；

同时，在小屏设备上若line2离屏幕底部距离不足banner可展示的最小高度，banner将自动隐藏。

# 3. 接口索引

方法

GameHelper.AdsFunc.initBannerTop(y:number)

说明

设置banner可展示的最高处的y坐标 （微信小游戏将以该坐标作为banner的顶部进行展示）

参数

参数	类型	默认值	是否必填	说明
y	number	/	是	banner可展示的最高点的y坐标（Canvas坐标系下）

示例

GameHelper.AdsFunc.initBannerTop(-450);

GameHelper.AdsFunc.showBanner()

说明

展示banner

参数

无

示例

GameHelper.AdsFunc.showBanner();

GameHelper.AdsFunc.hideBanner()

说明

隐藏banner

参数

无

示例

GameHelper.AdsFunc.hideBanner();