更新记录
1.0.1(2022-04-25)
1、追加开屏图配置参数完整性check,详见“开屏图配置”
2、追加开屏展示图显示时间参数,详见“开屏图配置”
1.0.0(2022-04-21)
初始版本
平台兼容性
Android | iOS |
---|---|
× | 适用版本区间:10 - 15 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios
注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择
说明
ios自定义Storyboard
插件支持动态修改开屏 Storyboard
1.0.1更新内容
1、追加开屏图配置参数完整性check,详见“开屏图配置”
2、追加开屏展示图显示时间参数,详见“开屏图配置”
调用方式
//注册调用开屏 在app.vue onLaunch
var bfjrModule = uni.requireNativePlugin('u7746-StoryboardModule');
var paramObj = {};
bfjrModule.registerCallbackFunc(paramObj, (ret) => {
//ret返回json格式 {“status”:"0","jump":"xxxx"}
//status 0表示用户正常进入 没有点点击广告图片 1表示点击
//jump是设置开屏图时配置的跳转地址
//接收到的回周数据如果向后传递 请开发者自行处理
console.log(ret);
//后续“分发”页等待状态维护
that.$isResolve();
});
开屏图配置
//开发者自行决定调用地
var bfjrModule = uni.requireNativePlugin('u7746-StoryboardModule');
var paramObj = {};
//开屏图片网络地址 必须
paramObj.url = url;
//客户点击图片要跳转的app内部地址 必须
paramObj.jump = 'pages/index/index';
//关闭时间 非必须,默认为5秒关闭
paramObj.closetime = 5;
bfjrModule.updateADFunc(paramObj, (ret) => {
//ret 1设置成功 -1传冲图片错误 -2配置失败 -3非空参数为空
content: JSON.stringify(ret)
});
关闭开屏图配置
//开发者自行决定调用地
var bfjrModule = uni.requireNativePlugin('u7746-StoryboardModule');
var paramObj = {};
paramObj.status = "1";//写死
bfjrModule.clearADFunc(paramObj, (ret) => {
//ret 1设置成功 -1设置失败
content: JSON.stringify(ret)
});
个人建议
//开发者入口页做成分发页概念(page.jsont page[]里第一个节点)
//main.js里配置
Vue.prototype.$onLaunched = new Promise(resolve => {
Vue.prototype.$isResolve = resolve
})
//分发页的onload事件里
async onLoad() {
//等待开屏图片客户操作回调完成
await this.$onLaunched;
//判断是否要跳转开屏页对应的地址 还是进入主业务页
}
重要提示 以上所有操作的效果都是在设置完成后 app再次打开生效