Skip to content

横幅

此模块实现横幅广告的展示及清除。阅读JOGOS_SDK 简介页面与您的游戏引擎相关的部分后,可以按如下方式使用相关的功能:

javascript
window.JOGOS_SDK.banner;
广告要求

请务必阅读我们的广告要求,因为如果您的游戏不遵守这些要求,您的游戏将被拒绝,且没有任何反馈。

请求展示横幅广告

横幅广告共有 5 种尺寸可供选择:

  • 排行榜 (728x90)
  • 中等(300x250)
  • 移动设备(320x50)
  • 主页 (468x60)
  • 大型移动设备 (320x100)
限制
  • 同一时刻只能显示 2 个尺寸不同的横幅广告
  • 同一横幅广告位置必须显示 60 秒后,方可再次刷新广告
  • 如果横幅不遵循以上规则和尺寸,它很可能不会显示

首先,您需要在屏幕上创建横幅广告的容器,可选的指定宽度和高度:

html
<div id="banner-container" style="width: 300px; height: 250px"></div>

然后使用以下方法请求显示横幅广告(注意id需与容器的id保持一致):

javascript
try {
  await window.JOGOS_SDK.banner.requestBanner('banner-container');
} catch (e) {
  console.log('Banner request error', e);
}

同一时刻最多只能展示两个横幅广告,否则会抛出异常:'500 At most two banners can be displayed at the same time'。

使用相同的id执行此方法,会替换原有广告,在指定的时间内(一般为 60 秒)重复执行,会抛出异常:500 The time for each call to method requestBanner cannot exceed ${time} seconds

清除指定横幅

然后使用以下方法可清除id为指定值的横幅:

javascript
await window.JOGOS_SDK.banner.clearBanner('banner-container');

清除所有横幅

然后使用以下方法可清除所有横幅:

javascript
await window.JOGOS_SDK.banner.clearAllBanners();

本地测试

本地测试时,并不会展示真实的广告,查看最终显示效果可将您的游戏打包上传至开发者平台 QA 工具中进行测试。