更新记录
1.0.7(2021-07-23)
1.修复iOS渠道授权闪退的bug
1.0.6(2021-03-26)
1.修复ios部分bug
1.0.5(2021-03-12)
1.修复bug
查看更多平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:4.4 - 10.0 | armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 | 适用版本区间:9 - 14 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在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原生插件配置”->”云端插件“列表中删除该插件重新选择
插件简介
UZK-AlibcByultimate插件(不带直播间)封装了阿里百川旗舰版sdk,如果需要接入标准版可以接入我另外一个百川插件新版阿里百川SDK安卓4.0.0.15苹果4.0.1.6
安卓使用demo
链接:https://pan.baidu.com/s/1jZXiHsoSfE2ff9VWAKTpgA 提取码:xfme
准备事项
- 1.在百川控制台-我的产品后台开通百川电商旗舰版权限
- 2.在百川套件平台申请开通相关套件。
- 3.在我的套件中点击配置项版本管理增加版本
- 4.分别配置购物车和商品详情套件
- 5.配置底部分享按钮,如果要实现分享功能,底部-分享icon跳转url这一项一定要配置为“http://share”,方便后面拦截分享功能。
- 6.发布套件,在app开发过程中可以选择白名单进行快速调试。套件的所有改动都需要发布方可生效。
配置插件
- 1.下载插件页面右上角的示例代码,并将nativeplugins目录拷贝到项目的根目录,并分别替换安卓和ios的安全图片
android安全图片路径
UZK-AlibcByultimate/android/res/drawable/yw_1222_baichuan.jpg
ios安全图片路径
UZK-AlibcByultimate/ios/yw_1222_baichuan.jpg
- 2.云端选择试用或者购买,并绑定到项目中,在项目的app原生插件配置中选择云端插件
- 3.IOS 要在配置 manifest.json 文件中找到 ios 项,加入以下代码。。
"ios" : {
"urltypes" : [
{
"urlschemes" : ["tbopen+你在百川创建应用的appkey"]//不加会导致拉起手淘回不到自己的app。或者登陆失败
}
],
"urlschemewhitelist" : "tbopen,tmall"//不加会导致拉不起手淘
}
- 4.制作自定义基座并运行自定义基座(点击运行->运行到手机或模拟器->运行基座选择->自定义调试基座)
插件接口
方法名 | 说明 |
---|---|
init() | 初始化sdk |
showFloatWindow() | 开启自检工具 |
login() | 淘宝授权登陆 |
getUserInfo() | 获取授权登陆用户信息 |
logout() | 退出登陆 |
openByUrl() | 打开URL页面 |
openByCode() | 打开套件页面 |
myevent() | 注册监听 |
showFloatWindow() | 开启自检工具 |
topAuth() | 渠道授权(新增) |
实例化插件 ,在需要用到插件的页面引入
const plug= uni.requireNativePlugin('UZK-AlibcByultimate');
1.初始化sdk
plug.init(res=>{
});
2.开启自检工具
plug.showFloatWindow();
- 安卓需要在打包的时候增加相关权限
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
3.授权登陆
plug.login(res=>{
});
4.获取授权登陆用户信息
plug.getUserInfo(res=>{
});
5.退出登陆
plug.logout(res=>{
});
6.打开URL页面
plug.openByUrl({
url:"优惠券链接"
},res=>{
});
参数名 | 释义 | 是否必传 | 默认值 |
---|---|---|---|
url | 目标打开的url | 是 | 无 |
unionId | 淘客unionId | 否 | 无 |
subPid | 三方的淘客广告位(可选参数 | 否 | 无 |
pid | 推广位id | 否 | 无 |
materialSourceUrl | 媒体物料来源url(非必填项):数据链路的回溯支持 | 否 | 无 |
relationId | 渠道id | 否 | 无 |
openType | 打开类型 支持参数native/auto | 否 | native |
degradeType | 唤端失败端降级类型 支持参数download/h5/none | 否 | download |
degradeUrl | 降级url,degradeType参数为h5的时候必传 | degradeType参数为h5的时候必传 | 无 |
7.打开套件页面
plug.openByCode({
//参数见下方说明
},res=>{
});
参数名 | 释义 | 是否必传 | 默认值 |
---|---|---|---|
code | 百川套件 | 是 | 无 |
unionId | 淘客unionId | 否 | 无 |
subPid | 三方的淘客广告位(可选参数 | 否 | 无 |
pid | 推广位id | 否 | 无 |
item_id | 商品ID | 打开商品详情的时候必传 | 无 |
couponActivityId | 券id | 否 | 无 |
relationId | 渠道id | 否 | 无 |
openType | 打开类型 支持参数native/auto | 否 | native |
pageType | 媒体设置的当前页面类型导购版本为guide、渠道管理版本为agent、返利版本为rebate | 是 | agent |
vegasCode | 加密淘礼金id | 否 | 无 |
flRate | 当前用户返利比例,乘以10000后小数点可保留6位,例如:33.33333333%可以传入3333.333333 | 否 | 无 |
dlRate | dlRate: 当前用户渠道比例,乘以10000后小数点可保留6位,例如:33.33333333%可以传入3333.333333 | 否 | 无 |
maxDlRate | 当前用户最高渠道比例,乘以10000后小数点可保留6为,例如:33.33333333%可以传入3333.333333 | 否 | 无 |
8.监听详情页分享按钮
plug.myevent({
//具体用法参考插件页面右上角示例项目。
},res=>{
});
9.目前支持的套件列表
套件名 | 释义 |
---|---|
suite://bc.suite.basic/bc.template.cart | 打开购物车 |
suite://bc.suite.basic/bc.template.detail | 打开商品详情 |
10.渠道授权
topAuth() {
plug.topAuth({
appkey:24622990,//appkey
appname:"优折扣",//应用名称
image:"https://avatar.csdnimg.cn/8/F/4/3_mad1989.jpg"//应用图标
},res => {
console.log(JSON.stringify(res))
}
)
},
参数名 | 释义 | 是否必传 | 默认值 |
---|---|---|---|
appkey | 淘宝联盟appkey | 是 | 无 |
appname | 应用名称 | 是 | 无 |
image | 显示的图片(必须为网络图片) | 是 | 无 |
使用该方法获取access_token后,传给后端,后端去请求淘宝api获取渠道id!