微信小游戏激励视频广告创建拉取错误码

╰+哭是因爲堅強的太久メ 2022-04-05 15:18 1192阅读 0赞

## 激励视频广告 ##

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

开发者可以调用 [wx.createRewardedVideoAd][] 创建激励视频广告组件。该方法返回的是一个全局单例。

const video1 = wx.createRewardedVideoAd({adUnitId: 'xxxx'})
    const video2 = wx.createRewardedVideoAd({adUnitId: 'xxxx'})
    console.log(video1 === video2)
    // true

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

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

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

### 显示/隐藏 ###

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

bannerAd.show()

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

### 广告拉取成功与失败 ###

激励视频广告组件是自动拉取广告并进行更新的。在组件创建后会拉取一次广告，用户点击 `关闭广告` 后会去拉取下一条广告。

如果拉取成功。[RewardedVideoAd.onLoad()][RewardedVideoAd.onLoad] 会执行，[RewardedVideoAd.show()][RewardedVideoAd.show] 返回的 Promise 也会是一个 resolved Promise。两者的回调函数中都没有参数传递。

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

如果拉取失败，通过 [RewardedVideoAd.onError()][RewardedVideoAd.onError] 注册的回调函数会执行，回调函数的参数是一个包含错误信息的对象。[常见异常错误参考文档][RewardedVideoAd.onError]

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

[RewardedVideoAd.show()][RewardedVideoAd.show] 返回的 Promise 也会是一个 rejected Promise。

rewardedVideoAd.show()
      .catch(err => console.log(err))

### **监听错误码** ###

### RewardedVideoAd.onError(function callback) ###

监听激励视频错误事件

参数

function callback

激励视频错误事件的回调函数

参数

**Object res**

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>类型</th> 
   <th>说明</th> 
   <th>最低版本</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>errMsg</td> 
   <td>string</td> 
   <td>错误信息</td> 
   <td>&nbsp;</td> 
  </tr> 
  <tr> 
   <td>errCode</td> 
   <td>number</td> 
   <td>错误码</td> 
   <td><a href="https://developers.weixin.qq.com/minigame/dev/framework/compatibility.html" rel="nofollow">2.2.2</a></td> 
  </tr> 
 </tbody> 
</table>

**errCode 的合法值**

<table> 
 <thead> 
  <tr> 
   <th>值</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>1000</td> 
   <td>后端接口调用失败</td> 
  </tr> 
  <tr> 
   <td>1001</td> 
   <td>参数错误</td> 
  </tr> 
  <tr> 
   <td>1002</td> 
   <td>广告单元无效</td> 
  </tr> 
  <tr> 
   <td>1003</td> 
   <td>内部错误</td> 
  </tr> 
  <tr> 
   <td>1004</td> 
   <td>无合适的广告</td> 
  </tr> 
  <tr> 
   <td>1005</td> 
   <td>广告组件审核中</td> 
  </tr> 
  <tr> 
   <td>1006</td> 
   <td>广告组件被驳回</td> 
  </tr> 
  <tr> 
   <td>1007</td> 
   <td>广告组件被封禁</td> 
  </tr> 
  <tr> 
   <td>1008</td> 
   <td>广告单元已关闭</td> 
  </tr> 
 </tbody> 
</table>

错误码信息与解决方案表

错误码是通过onError获取到的错误信息。调试期间，可以通过异常返回来捕获信息。 在小程序发布上线之后，如果遇到异常问题，可以在[“运维中心“][Link 1]里面搜寻错误日志，还可以针对异常返回加上适当的监控信息。

<table> 
 <thead> 
  <tr> 
   <th>代码</th> 
   <th>异常情况</th> 
   <th>理由</th> 
   <th>解决方案</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>1000</td> 
   <td>后端错误调用失败</td> 
   <td>该项错误不是开发者的异常情况</td> 
   <td>一般情况下忽略一段时间即可恢复。</td> 
  </tr> 
  <tr> 
   <td>1001</td> 
   <td>参数错误</td> 
   <td>使用方法错误</td> 
   <td>可以前往developers.weixin.qq.com确认具体教程（小程序和小游戏分别有各自的教程，可以在顶部选项中，“设计”一栏的右侧进行切换。</td> 
  </tr> 
  <tr> 
   <td>1002</td> 
   <td>广告单元无效</td> 
   <td>可能是拼写错误、或者误用了其他APP的广告ID</td> 
   <td>请重新前往mp.weixin.qq.com确认广告位ID。</td> 
  </tr> 
  <tr> 
   <td>1003</td> 
   <td>内部错误</td> 
   <td>该项错误不是开发者的异常情况</td> 
   <td>一般情况下忽略一段时间即可恢复。</td> 
  </tr> 
  <tr> 
   <td>1004</td> 
   <td>无适合的广告</td> 
   <td>广告不是每一次都会出现，这次没有出现可能是由于该用户不适合浏览广告</td> 
   <td>属于正常情况，且开发者需要针对这种情况做形态上的兼容。</td> 
  </tr> 
  <tr> 
   <td>1005</td> 
   <td>广告组件审核中</td> 
   <td>你的广告正在被审核，无法展现广告</td> 
   <td>请前往mp.weixin.qq.com确认审核状态，且开发者需要针对这种情况做形态上的兼容。</td> 
  </tr> 
  <tr> 
   <td>1006</td> 
   <td>广告组件被驳回</td> 
   <td>你的广告审核失败，无法展现广告</td> 
   <td>请前往mp.weixin.qq.com确认审核状态，且开发者需要针对这种情况做形态上的兼容。</td> 
  </tr> 
  <tr> 
   <td>1007</td> 
   <td>广告组件被驳回</td> 
   <td>你的广告能力已经被封禁，封禁期间无法展现广告</td> 
   <td>请前往mp.weixin.qq.com确认小程序广告封禁状态。</td> 
  </tr> 
  <tr> 
   <td>1008</td> 
   <td>广告单元已关闭</td> 
   <td>该广告位的广告能力已经被关闭</td> 
   <td>请前往mp.weixin.qq.com重新打开对应广告位的展现。</td> 
  </tr> 
 </tbody> 
</table>

### 拉取失败，重新拉取 ###

showRewardeVideo()
        {
            this.rewardedVideoAd.show().catch(this._onShowRewardVideoAdError.bind(this));
        },
    
        _onShowRewardVideoAdError(err)
        {
            console.log(err);
            this.showRewardeVideo();
        },

官方 ： [https://developers.weixin.qq.com/minigame/dev/tutorial/ad/rewarded-video-ad.html][https_developers.weixin.qq.com_minigame_dev_tutorial_ad_rewarded-video-ad.html]

[wx.createRewardedVideoAd]: https://developers.weixin.qq.com/minigame/dev/api/wx.createRewardedVideoAd.html
[RewardedVideoAd.show]: https://developers.weixin.qq.com/minigame/dev/api/RewardedVideoAd.show.html
[RewardedVideoAd.onLoad]: https://developers.weixin.qq.com/minigame/dev/api/RewardedVideoAd.onLoad.html
[RewardedVideoAd.onError]: https://developers.weixin.qq.com/minigame/dev/api/RewardedVideoAd.onError.html
[Link 1]: https://mp.weixin.qq.com/
[https_developers.weixin.qq.com_minigame_dev_tutorial_ad_rewarded-video-ad.html]: https://developers.weixin.qq.com/minigame/dev/tutorial/ad/rewarded-video-ad.html