tencent cloud

腾讯云超级应用服务

广告

Download
聚焦模式
字号
最后更新时间: 2025-04-09 18:35:49

wx.createRewardedVideoAd

wx.createRewardedVideoAd(Object object)

功能描述:创建激励视频广告组件。调用该方法创建的激励视频广告是一个页面单例的,并且在小程序端的单例对象不允许跨页面使用。
参数:Object object
属性
类型
默认值
必填
说明
adUnitId
string
-
广告单元 id
multiton
boolean
-
是否启用多例模式,默认为 false
返回值:RewardedVideoAd激励视频广告组件。

RewardedVideoAd

激励视频广告会被渲染成一个原生组件,层级比普通组件高。激励视频广告对象是一个页面单例对象,激励广告默认是隐藏的,需要调用 RewardedVideoAd.show() 将其显示。

RewardedVideoAd.load()

功能描述:加载激励视频广告。
返回值Promise,激励视频广告加载数据的结果。

RewardedVideoAd.show()

功能描述:显示激励视频广告。
返回值Promise,激励视频广告显示操作的结果。

RewardedVideoAd.destroy()

功能描述:销毁激励视频广告实例。

RewardedVideoAd.onLoad(function listener)

功能描述:监听激励视频广告加载事件。
参数:function listener,激励视频广告加载事件的监听函数。

RewardedVideoAd.offLoad(function listener)

功能描述:移除激励视频广告加载事件的监听函数。
参数:function listener,onLoad 传入的监听函数。不传此参数则移除所有监听函数。
示例代码:
const listener = function (res) { console.log(res) }

RewardedVideoAd.onLoad(listener)
RewardedVideoAd.offLoad(listener) // 需传入与监听时同一个的函数对象

RewardedVideoAd.onError(function listener)

功能描述:监听激励视频错误事件。
参数:function listener,激励视频错误事件的监听函数。
返回参数:Object res。
属性
类型
说明
errMsg
string
错误信息
errCode
number
错误码

RewardedVideoAd.offError(function listener)

功能描述:移除激励视频错误事件的监听函数。
参数:function listener,onError 传入的监听函数。不传此参数则移除所有监听函数。
示例代码:
const listener = function (res) { console.log(res) }

RewardedVideoAd.onError(listener)
RewardedVideoAd.offError(listener) // 需传入与监听时同一个的函数对象

RewardedVideoAd.onClose(function listener)

功能描述:监听用户点击关闭广告按钮的事件。
参数:function listener,用户点击关闭广告按钮的事件的监听函数。
返回参数:Object res
属性
类型
说明
isEnded
boolean
视频是否是在用户完整观看的情况下被关闭的

RewardedVideoAd.offClose(function listener)

功能描述:移除用户点击关闭广告按钮的事件的监听函数。
参数:function listener,onClose 传入的监听函数。不传此参数则移除所有监听函数。
示例代码:
const listener = function (res) { console.log(res) }

RewardedVideoAd.onClose(listener)
RewardedVideoAd.offClose(listener) // 需传入与监听时同一个的函数对象

错误码信息

错误码是通过 onError 获取到的错误信息。调试期间,可以通过异常返回来捕获信息。可以针对异常返回加上适当的监控信息辅助排查现网情况。
错误码
异常情况
理由
1000
后端接口调用失败
该项错误不是开发者导致的异常情况
1001
参数错误
使用方法错误
1002
广告单元无效
可能是广告位 ID 拼写错误或者是误用了其他 APP 的广告 ID
1003
内部错误
该项错误不是开发者导致的异常情况
1004
无合适的广告
广告不是每一次都会出现,这次没有出现可能是由于该用户不适合浏览广告
1010
广告功能已禁用
您的广告功能已禁用

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈