tt.createRewardedVideoAd

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

輸入

輸出

videoAd實(shí)例。

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

videoAd的方法列表

videoAd.show()

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

videoAd.onLoad(listener)

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

videoAd.offLoad(listener)

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

videoAd.load()

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

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

videoAd.onError(listener)

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

errCode 詳情

videoAd.offError(listener)

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

videoAd.onClose(listener)

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

videoAd.onClose(res => {
  if (res.isEnded) {
    // 給予獎(jiǎng)勵(lì)
  }
});

videoAd.offClose(listener)

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