tt.createRewardedVideoAd

2020-02-15 01:53 更新


开发者可以在小游戏中使用 Video 广告获得收入。Video 广告是由客户端原生渲染,覆盖在整个小游戏 Canvas 区域之上。Video 广告展示的时候用户不能操作小游戏。 Video 广告目前支持竖屏展示。如果是横屏游戏在展示时会先切到竖屏。开发者工具上暂不支持调试该 API,请直接在真机上进行调试。

输入

名称数据类型属性默认值描述
adUnitIdstringrequired广告位 id


输出

videoAd实例。

提示全局只有一个videoAd实例,重复创建没有用。


videoAd的方法列表

videoAd.show()

广告创建后默认是隐藏的,可以通过该方法显示广告。 该方法返回一个 Promise 对象。当广告组件正常获取素材时,该 Promise 对象会是一个 resolved Promise。当广告组件发生错误时,会是一个 rejected Promise,参数与error事件监听器获得的参数相同。

videoAd.onLoad(listener)

绑定 load 事件的监听器。 广告组件成功拉取广告素材时会触发load事件的监听器。

videoAd.offLoad(listener)

解除绑定 load 事件的监听器。

videoAd.load()

当广告素材加载出现错误时,可以通过 load 方法手动加载。 该方法返回一个 Promise。 如果广告已经自动拉取成功,调用该方法返回一个 resolved Promise;

// 显示广告
videoAd
  .show()
  .then(() => {
    console.log("广告显示成功");
  })
  .catch(err => {
    console.log("广告组件出现问题", err);
    // 可以手动加载一次
    videoAd.load().then(() => {
      console.log("手动加载成功");
      // 加载成功后需要再显示广告
      return videoAd.show();
    });
  });

videoAd.onError(listener)

绑定 error 事件的监听器。 广告组件拉取广告素材时如果发生错误,会触发error事件的监听器。监听器会获得一个包含errCode和errMsg属性的对象参数。

errCode 详情

videoAd.offError(listener)

解除绑定 error 事件的监听器。

videoAd.onClose(listener)

绑定 close 事件的监听器。 当用户点击了 Video 广告上的关闭按钮时,会触发close事件的监听器。监听器会获得一个包含isEnded属性的对象参数,表征用户是否完整观看了视频。

videoAd.onClose(res => {
  if (res.isEnded) {
    // 给予奖励
  }
});

videoAd.offClose(listener)

解除绑定 close 事件的监听器。

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号