draw-ad 视频流广告
收藏我的收藏
基础库 3.38.0 开始支持本组件
| 前提条件 | 无 |
| 业务背景 | 无 |
| 使用限制 | 视频流广告组件是原生组件,不支持通过 css 调整组件的样式。 |
| 注意事项 | 视频流广告内容完全展示时,自动开始播放,广告内容完全移出屏幕时,自动停止播放。注意视频流广告布局尺寸不要超出屏幕,否则会导致广告无法播放。 |
| 相关教程 | 无 |
属性说明
| 属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
|---|---|---|---|---|---|
| unit-id | string | 是 | 广告位 id,需要预先在「小程序管理后台 > 流量主模块」配置生成。 | 3.38.0 | |
| full-screen | boolean | 否 | 控制视频流广告是否铺满开发者可自定义屏幕区域。该属性不支持动态变更 | 3.38.0 | |
| scale | number | 1.5 | 否 | 广告高度/宽度的比例,取 值范围 1.5-2.2,宽度默认屏幕宽度,不可变更,仅在 full-screen 为 false 时生效。 该属性不支持动态变更 | 3.38.0 |
| binderror | function | 否 | 广告加载失败的回调方法。回调值 `event.detail = { errMsg, errorCode, errorType}` | 3.38.0 | |
| bindplay | function | 否 | 组件开始播放时的回调方法 | 3.38.0 | |
| bindstop | function | 否 | 组件开始播放时的回调方法。组件滑离屏幕、小程序退后台、组件销毁 ( 开发者主动销毁、小程序页面销毁等导致的组件销毁 ) 时触发 | 3.38.0 |
错误码
| errorCode | errMsg | errorType | 说明 | 最低支持版本 |
|---|---|---|---|---|
| 169302 | The adUnitId is closed 或 The adUnitId is prohibit 或 The adUnitId is invalid | D | 广告位已关闭 或 广告位已禁止 或 广告位非法 | 3.38.0 |
| 169305 | request ad data fail:%s,server code=%ld | F | 小程序框架内部错误,有需要请拉客服咨询 | 3.38.0 |
代码示例
<!-- pages/draw-ad/draw-ad.ttml --> <draw-ad unit-id="{{unitId}}" full-screen="{{fullScreen}}" scale="{{scale}}" binderror="onDrawAdError" bindplay="onDrawAdPlay" bindstop="onDrawAdStop"></draw-ad> <view> <button bindtap="updateFullScreen">updateFullScreen</button> <button bindtap="updateScale">updateScale</button> </view>
// pages/draw-ad/draw-ad.js Page({ data: { unitId: "dpcnwfbzctrqzqq18a", fullScreen: true, scale: 1.5, drawStyle: "", }, onDrawAdError(e) { console.log("error", e); }, onDrawAdPlay(e) { console.log("play"); }, onDrawAdStop(e) { console.log("stop"); }, });
