为了方便开发者接入,联盟共建了统一 SDK,开发者接入 sdk 后能更快的实现登录、支付与广告功能,建议采用统一 SDK 方式接入。
创建 banner 广告组件,每次调用该方法创建 banner 广告都会返回一个全新的实例。
Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
adUnitId | String | 是 | 广告单元 id | |
adIntervals | Number | 否 | 广告自动刷新的间隔时间,单位为秒,参数值必须大于等于 30(该参数不传入时 Banner 广告不会自动刷新) | |
style | Object | 是 | banner 广告组件的样式 |
结构属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
left | Number | 是 | banner 广告组件的左上角横坐标,单位 px。 | |
top | Number | 是 | banner 广告组件的左上角纵坐标,单位 px。 | |
width | Number | 是 | banner 广告组件的宽度,单位 px。 | |
height | Number | 是 | banner 广告组件的高度,单位 px。 |
banner 广告组件实例。banner 广告组件是一个原生组件,层级比普通组件高。banner 广告组件默认是隐藏的,需要调用 BannerAd.show() 将其显示。banner 广告会根据开发者设置的宽度进行等比缩放,缩放后的尺寸将通过 BannerAd.onResize() 事件中提供。
banner 广告组件的样式。style 上的属性的值仅为开发者设置的值,banner 广告会根据开发者设置的宽度进行等比缩放,缩放后的真实尺寸需要通过 BannerAd.onResize() 事件获得。
属性 | 类型 | 说明 |
---|---|---|
left | Number | banner 广告组件的左上角横坐标,单位 px。 |
top | Number | banner 广告组件的左上角纵坐标,单位 px。 |
width | Number | banner 广告组件的宽度,单位 px。最小 300,最大至 屏幕宽度(屏幕宽度可以通过 qg.getSystemInfoSync() 获取)。 |
height | Number | banner 广告组件的高度,单位 px。 |
监听 banner 广告尺寸变化事件。
banner 广告尺寸变化事件的监听函数
属性 | 类型 | 说明 |
---|---|---|
width | Number | 缩放后的宽度,单位 px。 |
height | Number | 缩放后的高度,单位 px。 |
销毁 banner 广告。
监听 banner 广告关闭事件
banner 广告关闭事件的回调函数
取消监听 banner 广告关闭事件
banner 广告关闭事件的回调函数
隐藏 banner 广告。
移除 banner 广告加载事件的监听函数
onLoad 传入的监听函数。不传此参数则移除所有监听函数。
const listener = function(res) {
console.log(res);
};
BannerAd.onLoad(listener);
BannerAd.offLoad(listener); // 需传入与监听时同一个的函数对象
移除 banner 广告错误事件的监听函数
onError 传入的监听函数。不传此参数则移除所有监听函数。
const listener = function(res) {
console.log(res);
};
BannerAd.onError(listener);
BannerAd.offError(listener); // 需传入与监听时同一个的函数对象
移除 banner 广告尺寸变化事件的监听函数
onResize 传入的监听函数。不传此参数则移除所有监听函数。
const listener = function(res) {
console.log(res);
};
BannerAd.onResize(listener);
BannerAd.offResize(listener); // 需传入与监听时同一个的函数对象
监听 banner 广告错误事件。
banner 广告错误事件的监听函数
属性 | 类型 | 说明 |
---|---|---|
errMsg | String | 错误信息 |
errCode | Number | 错误码 |
监听 banner 广告加载事件。
banner 广告加载事件的监听函数
显示 banner 广告。
banner 广告显示操作的结果