.createFlow

组件化接入广告位

概述

请先完成阅读：组件化方式接入广告位

使用该接口前，请先进行SDK初始化

createFlow组件是用来实现广告位自动渲染：

只要确定广告位的参数与需要渲染的位置即可，SDK会根据广告位ID自动渲染出对应类型的广告位
支持点击后自动跳转，自动刷新创意等功能

也可以参阅实例，看看如何在实际中使用createFlow渲染广告位。

page渲染多Icon广告位 page渲染浮动窗广告位 page渲染插屏广告位 page渲染伪视频广告位

接口描述

调用该组件后，自动按照推广位类型渲染UI，并支持点击、动态效果等
cocos引擎中，请在画布初始化完毕后才调用createFlow
cocos引擎依赖ScrollView模块

使用标准屏幕坐标系定位

使用实例

let flowUI = wx.tmSDK.createFlow({
    positionId: 1260，
    x: 0,     
    y: 300,   
});
// 监听销毁事件，闪屏中可以用于闪屏结束后做场景切换
flowUI.onDestroy(function(){
   console.log('销毁成功')
});
// 监听错误事件
flowUI.onError(function({message}){
    console.log(message)
});
// 监听初始化事件
flowUI.onRender(function({message}){
    console.log(message)
});

参数

字段名称

字段说明

positionId

广告位id

渲染x轴位置

推广位在画布中的渲染X轴方向位置，坐标原点为视图左上角

渲染y轴位置

推广位在画布中的渲染Y轴方向位置，坐标原点为视图左上角

width(可选参数)

渲染宽度

可选参数，设置后可调整推广位尺寸, 不设置则使用默认尺寸, 最小值为100,最大值为默认广告类型宽

zIndex(可选参数)

渲染层级

可选参数，设置后可调整UI的渲染层级，默认值为999999999

销毁

正常情况下，游戏场景切换时，该UI组件会自动销毁。如果需要在某些场景销毁该组件，请使用destroy方法。

flowUI.destroy();

可选参数: width

1、浮动icon类型下，可等比例设置渲染宽度，最小值为100，比例固定为190:270。
2、设置的宽度类型会根据当前尺寸画布与1080*1920的标准尺寸画布进行缩放。

let flowUI = tm_sdk.createFlow({
    ...,  
    width: 250, // 自定义浮动icon宽度为：在1080*1920尺寸下的宽度为250px。
});

可选参数: zIndex

1、可自定义设置渲染组件的层级
2、闪屏类型默认值则为加999999999 + 1，其他类型默认值为999999999。
3、实际显示的层级数会被引擎自动调整

let flowUI = wx.tmSDK.createFlow({
    ...,  
    zIndex: 250, // 设置组件层级为250, 实际显示的层级会被引擎所调整。
});

onDestroy

1、监听组件的销毁
2、可多个监听
3、返回message，销毁成功信息

flowUI.onDestroy(function({from, message}){
    console.log(from, message)
});

offDestroy

取消监听组件的销毁事件
传入与监听相同的回调函数只取消该回调

let destroyCallBack = function({from, message}){ // 假设onDestroy的时候绑定的为该函数
    console.log(from, message)
};
flowUI.offDestroy(); // 取消所有销毁监听事件
flowUI.offDestroy(destroyCallBack);  // 取消某个监听事件

onRender

监听组件的初始化
可多个监听
返回message，初始化成功信息

flowUI.onRender(function({message}){
    console.log(message)
});

offRender

取消监听组件的初始化
传入与监听相同的回调函数只取消该回调

let renderCallBack = function({message}){ // 假设onDestroy的时候绑定的为该函数
    console.log(message)
};
flowUI.offRender(); // 此取消所有销毁监听事件
flowUI.offRender(renderCallBack);  // 取消某个监听事件

onError

监听组件的错误信息
可多个监听
返回message错误详情

flowUI.onError(function({message}) {
    console.log(message)
});

offError

取消监听组件的初始化
传入与监听相同的回调函数只取消该回调

let errorCallBack = function({message}){ // 假设onDestroy的时候绑定的为该函数
    console.log(message)
};
flowUI.offError(); // 此取消所有销毁监听事件
flowUI.offError(errorCallBack);  // 只取消errorCallBack监听事件

监听广告位跳转事件

监听广告位是否触发点击跳转

回调参数中为返回的原始微信信息

flowUI.onNavigate(function(msg) {
 console.error(msg);
})

取消监听广告位跳转事件

let callBack = function(error){
    console.log(error)
};
flowUI.offNavigate(callBack);  // 取消某个监听事件

上一页组件化方式接入广告位下一页渲染多Icon广告位

最后更新于3年前