視頻廣告

此模塊實現插屏視頻與激勵視頻廣告。閱讀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);