基础库 1.3.0 开始支持本方法，这是一个同步方法。

开发者可以在小游戏中使用 Video 广告获得收入。Video 广告是由客户端原生渲染，覆盖在整个小游戏 Canvas 区域之上。观看广告时会暂停所有 JS 逻辑。Video 广告展示的时候用户不能操作小游戏。

前提条件	接入本能力需要先开通【流量主】能力，请前往小游戏开发者后台在「商业化」> 「流量主」申请开通能力在「流量主」> 「广告管理」中创建激励视频广告位，获取广告位 id
业务背景	无
使用限制	无
注意事项	建议开发者在广告开发时始终注册 onError 方法的监听，保证对所有广告异常情况的处理。广告是全屏展示，由于不同系统的识别有所区别，在 iOS 端，广告的播放和关闭会触发 onShow 和 onHide 事件，安卓则不会。但无论是否触发，在激励广告播放期间，游戏逻辑和渲染都会被暂停，用户不能操作小游戏。 Video 广告目前支持竖屏展示。如果是横屏游戏在展示时会先切到竖屏
相关教程	无

语法

tt.createRewardedVideoAd(params)

参数说明

params 类型说明

object 类型，属性如下：

属性名	类型	默认值	必填	说明	最低支持版本
multiton	boolean	false	否	是否开启再得广告模式（只支持安卓系统的抖音和抖音极速版）功能说明：激励再得能力	2.74.0
multitonRewardMsg	Array<string>		否	再得广告的奖励文案，玩家每看完一个广告都会展示，如【再看1个获得xx】 xx 即 multitonRewardMsg 中的文案，按顺序依次展示，单个文案最大长度为 7 multiton 为 true 时必填	2.74.0
multitonRewardTimes	number		否	额外观看广告的次数，合法的数据范围为 1-4，multiton 为 true 时必填	2.74.0
progressTip	boolean	false	否	是否开启进度提醒，开启时广告文案为【再看N个获得xx】，关闭时为【再看1个获得xx】。 N 表示玩家当前还需额外观看广告的次数。	2.74.0
adUnitId	string		是	广告位 id，后续可以在平台基于广告位 id 看数	1.3.0

返回值

类型	说明	最低支持版本
object	RewardedVideoAd 实例	1.3.0

错误码

errorCode	errMsg	errorType	说明	最低支持版本
999987	feature is not supported in app	D		1.3.0
999991	context exception	F	小游戏框架内部错误，有需要请创建工单咨询	1.3.0
101101	current activity is null, can not create game banner	D		1.3.0
101103	Please apply for an adUnitId	D		1.3.0
101102	can not create game banner	F	小游戏框架内部错误，有需要请创建工单咨询	1.3.0
999987	The scene does not support advertising	D		1.3.0
999999	The adUnitId is empty	D		1.3.0
101104	The adUnitId is closed	D		1.3.0
101105	The adUnitId is prohibit	D		1.3.0
101106	The adUnitId is invalid	D		1.3.0
999999	invalid param	D	参数错误	1.3.0
101101	multitonRewardTimes must be non-null when multiton is true	D		1.3.0
101102	multitonRewardMsg must have content when multiton is true	D		1.3.0
101103	multitonRewardTimes should greater than 1	D		1.3.0
101104	multitonRewardTimes should less than 4	D		1.3.0
101105	multitonRewardMsg is too long	D		1.3.0
999993	internal error	F	小游戏框架内部错误，有需要请创建工单咨询	1.3.0
999981	Host app does not support	D		1.3.0
999981	Host app not supported	D		1.3.0
999999	The adUnitId is empty	D	onVideoAdStateChange	1.3.0
101103	The adUnitId is invalid	D	onVideoAdStateChange	1.3.0
101107	unknown ad type	D	onVideoAdStateChange	1.3.0
999993	The adUnitId is invalid	F	小游戏框架内部错误，有需要请创建工单咨询	1.3.0
999999	unitid is illegal	D		1.3.0
101103	unitid is illegal	D		1.3.0
101107	unitid is illegal	D		1.3.0
999991	unitid is illegal	F	小游戏框架内部错误，有需要请创建工单咨询	1.3.0
101104	unitid is illegal	D		1.3.0
999985	request ad failed @1	U		1.3.0
999985	request ad failed @2	U		1.3.0
101110	request ad failed @3	F	小游戏框架内部错误，有需要请创建工单咨询	1.3.0
101111	request ad failed @4	F	小游戏框架内部错误，有需要请创建工单咨询	1.3.0
101111	request ad failed @7	F	小游戏框架内部错误，有需要请创建工单咨询	1.3.0
101112	request ad failed @5	F	小游戏框架内部错误，有需要请创建工单咨询	1.3.0
101113	request ad failed @6	F	小游戏框架内部错误，有需要请创建工单咨询	1.3.0
101114	request ad failed @8	F	小游戏框架内部错误，有需要请创建工单咨询	1.3.0
101115	request ad failed @9	F	小游戏框架内部错误，有需要请创建工单咨询	1.3.0
101116	request ad failed @10	F	小游戏框架内部错误，有需要请创建工单咨询	1.3.0
999991	request ad failed @50001/30001/20000	F	小游戏框架内部错误，有需要请创建工单咨询	1.3.0
101117	request ad failed @20001	F	小游戏框架内部错误，有需要请创建工单咨询	1.3.0
101118	request ad failed @50002	U		1.3.0

代码示例

激励再得能力介绍

该能力从基础库开始 2.74.0 开始支持，即抖音、抖 lite 版本为 23.4 时支持，预计 12 月生效

能力介绍：详情

const videoAd = tt.createRewardedVideoAd({
  adUnitId: "xxxxxxxxxxx",
  multiton: true,
  multitonRewardMsg: ['更多奖励1', '更多奖励2', '更多奖励3'],
  multitonRewardTimes: 3,
  progressTip: false,
});
videoAd.show().then(() => {
  console.log("视频广告展示");
});

录屏分享激励能力

当激励视频广告返回 1004 等错误，用户无法观看广告时，会自动拉起分享系统。具体逻辑为，本地存在录屏文件时，自动拉起录屏分享，不存在录屏时，拉起默认分享面板（分享给好友）。并在用户分享完成后，通过激励视频广告的 onClose 回调 count == 1 ，对于开发者来说，处理逻辑和之前一样。

需要注意：

•

该能力默认为开。

•

对于开发者无需修改，兼容现有广告逻辑，分享成功会回调 onClose 中 count == 1。

•

对于用户来说，表现为点击广告后无广告内容，因此弹出录屏分享或好友分享替代，开发者若有必要可以给予用户一定说明。

开发者文档

tt.createRewardedVideoAd
收藏
我的收藏

语法

参数说明

params 类型说明

返回值

错误码

代码示例

激励再得能力介绍

录屏分享激励能力

tt.createRewardedVideoAd收藏我的收藏

语法

参数说明

params 类型说明

返回值

错误码

代码示例

激励再得能力介绍

录屏分享激励能力

tt.createRewardedVideoAd
收藏
我的收藏