tt.createRewardedVideoAd

開發(fā)者可以在小游戲中使用 Video 廣告獲得收入。Video 廣告是由客戶端原生渲染，覆蓋在整個小游戲 Canvas 區(qū)域之上。Video 廣告展示的時候用戶不能操作小游戲。 Video 廣告目前支持豎屏展示。如果是橫屏游戲在展示時會先切到豎屏。開發(fā)者工具上暫不支持調(diào)試該 API，請直接在真機(jī)上進(jìn)行調(diào)試。

輸入

輸出

videoAd實(shí)例。

提示全局只有一個videoAd實(shí)例，重復(fù)創(chuàng)建沒有用。

videoAd的方法列表

videoAd.show()

廣告創(chuàng)建后默認(rèn)是隱藏的，可以通過該方法顯示廣告。 該方法返回一個 Promise 對象。當(dāng)廣告組件正常獲取素材時，該 Promise 對象會是一個 resolved Promise。當(dāng)廣告組件發(fā)生錯誤時，會是一個 rejected Promise，參數(shù)與error事件監(jiān)聽器獲得的參數(shù)相同。

videoAd.onLoad(listener)

綁定 load 事件的監(jiān)聽器。 廣告組件成功拉取廣告素材時會觸發(fā)load事件的監(jiān)聽器。

videoAd.offLoad(listener)

解除綁定 load 事件的監(jiān)聽器。

videoAd.load()

當(dāng)廣告素材加載出現(xiàn)錯誤時，可以通過 load 方法手動加載。 該方法返回一個 Promise。 如果廣告已經(jīng)自動拉取成功，調(diào)用該方法返回一個 resolved Promise；

// 顯示廣告
videoAd
  .show()
  .then(() => {
    console.log("廣告顯示成功");
  })
  .catch(err => {
    console.log("廣告組件出現(xiàn)問題", err);
    // 可以手動加載一次
    videoAd.load().then(() => {
      console.log("手動加載成功");
      // 加載成功后需要再顯示廣告
      return videoAd.show();
    });
  });

videoAd.onError(listener)

綁定 error 事件的監(jiān)聽器。 廣告組件拉取廣告素材時如果發(fā)生錯誤，會觸發(fā)error事件的監(jiān)聽器。監(jiān)聽器會獲得一個包含errCode和errMsg屬性的對象參數(shù)。

errCode 詳情

videoAd.offError(listener)

解除綁定 error 事件的監(jiān)聽器。

videoAd.onClose(listener)

綁定 close 事件的監(jiān)聽器。 當(dāng)用戶點(diǎn)擊了 Video 廣告上的關(guān)閉按鈕時，會觸發(fā)close事件的監(jiān)聽器。監(jiān)聽器會獲得一個包含isEnded屬性的對象參數(shù)，表征用戶是否完整觀看了視頻。

videoAd.onClose(res => {
  if (res.isEnded) {
    // 給予獎勵
  }
});

videoAd.offClose(listener)

解除綁定 close 事件的監(jiān)聽器。