激励视频广告

激励视频广告组件是由客户端原生的图片、文本、视频控件组成的，层级最高，会覆盖在上屏 Canvas 上。

开发者可以调用 mgtv.createRewardedVideoAd 创建激励视频广告组件。

const rewardedVideoAd = mgtv.createRewardedVideoAd({ adUnitId: 'xxxx' })

激励视频广告组件默认是隐藏的，因此可以提前创建，以提前初始化组件。

let rewardedVideoAd = mgtv.createRewardedVideoAd({ adUnitId: 'xxxx' })

为避免滥用广告资源，目前每个用户每天可观看激励式视频广告的次数有限，建议展示广告按钮前先判断广告是否加载成功。

显示/隐藏

激励视频广告组件默认是隐藏的，需要调用 RewardedVideoAd.show() 进行显示。

rewardedVideoAd.show()

只有在用户点击激励视频广告组件上的 关闭广告 按钮时，广告才会关闭。开发者不可控制激励视频广告组件的隐藏。

广告加载

激励视频广告组件目前不支持自动加载广告。在组件创建后需要调用 RewardedVideoAd.load() 加载一次广告。

如果加载成功。RewardedVideoAd.onLoad() 会执行。

rewardedVideoAd.onLoad(() => {
  console.log('激励视频 广告加载成功')
})

如果加载失败，通过 RewardedVideoAd.onError() 注册的回调函数会执行，回调函数的参数是一个包含错误信息的对象。

rewardedVideoAd.onError(err => {
  console.log(err)
})

监听用户关闭广告

只有在用户点击激励视频广告组件上的 关闭广告 按钮时，广告才会关闭。这个事件可以通过 RewardedVideoAd.onClose() 监听。

RewardedVideoAd.onClose() 的回调函数会传入一个参数 res，res.isEnded 描述广告被关闭时的状态。

属性	类型	说明
isEnded	boolean	视频是否是在用户完整观看的情况下被关闭的，true 表示用户是在视频播放完以后关闭的视频，false 表示用户在视频播放过程中关闭了视频

开发者需要根据 res.isEnded 判断是否视频是否播放结束、可以向用户下发奖励。

rewardedVideoAd.onClose(res => {
  // 用户点击了【关闭广告】按钮
  if (res && res.isEnded) {
    // 正常播放结束，可以下发游戏奖励
  } else {
    // 播放中途退出，不下发游戏奖励
  }
})