视频广告

此模块实现插屏视频与激励视频广告。阅读JOGOS_SDK 简介页面与您的游戏引擎相关的部分，并按如下方式使用视频广告的相关功能：

window.JOGOS_SDK.ad;

广告要求

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

请求播放视频广告

我们支持两种不同类型的视频广告：插屏广告（midgame）和激励广告（rewarded）;

• 插屏广告：当用户死亡、完成关卡等时，看情况可以触发游戏插屏广告。
• 激励广告：用户主动请求观看激励广告以换取奖励（额外生命、角色死亡时复活、额外物品、额外属性等）。

// 回调函数
const callbacks = {
  // 开始播放广告时会调用此函数
  onstarted: () => console.log('ad started'),
  // 播放广告结束时会调用此函数
  onfinished: () => console.log('ad finished'),
  // 播放广告出错时会调用此函数
  onerror: (error) => console.log('ad error:', error),
};

// 请求显示插屏广告
window.JOGOS_SDK.ad.requestAd('midgame', callbacks);
// 请求显示激励广告
window.JOGOS_SDK.ad.requestAd('rewarded', callbacks);

调用广告须知

• 插屏广告有最低刷新时间（一般为 60 秒），频繁调用会触发异常：500 At least a ${time} second interval is required to display new advertisements。

• 激励广告最天有最大限制（一般每用户每天 30 次），过多调用会触发异常：500 You can only watch up to ${max} rewarded ads per day。

• 我们建议您设计激励广告点时，广告点设计冷却时间或每日限额次数。你也可以通过以下接口，获取当前用户激励广告的剩余次数，来决定你的激励广告是否需要隐藏。

const result = await window.JOGOS_SDK.ad.getRewardAdCount();
console.log('Remaining rewardAd count ', result);

广告拦截检测

广告要求

我们的游戏设计允许在广告拦截状态下继续运行，但检测机制可能存在误判。为避免误判影响正常用户，建议采取温和的限制措施：仅对广告拦截用户限制增值内容（如特殊皮肤、额外关卡等），并确保关闭广告拦截后只需刷新页面即可恢复完整功能。请务必完善自动存档功能，防止因页面刷新导致进度丢失而影响用户体验。

使用以下方法检测用户是否阻止了广告：

const result = await window.JOGOS_SDK.ad.hasAdblock();
console.log('Adblock usage fetched', result);