更新记录
1.0.6(2021-03-26)
1.修复ios部分bug
1.0.5(2021-03-12)
1.修复bug
1.0.4(2021-03-09)
1.新增渠道授权方法
查看更多平台兼容性
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-AlibcBylive插件 封装了阿里百川旗舰版sdk(包含直播间,打开全新套件功能),目前安卓版本为5.0.0.7,iOS版本为5.0.0.7。 目前百川官方不对外申请开通,只接受邀约制,如果你有旗舰版相应权限,可以尝试接入,如果没有可以接入我对另外一个百川插件新版阿里百川SDK安卓4.0.0.15苹果4.0.1.6
安卓使用demo
链接:https://pan.baidu.com/s/1jZXiHsoSfE2ff9VWAKTpgA 提取码:xfme
准备事项
- 1.下载插件页面右上角的示例代码,并将nativeplugins目录拷贝到项目的根目录,并分别替换安卓和ios的安全图片
android安全图片路径
UZK-AlibcBylive/android/res/drawable/yw_1222_baichuan.jpg
ios安全图片路径
UZK-AlibcBylive/ios/yw_1222_baichuan.jpg
- 2.云端选择试用或者购买,并绑定到项目中,在项目的app原生插件配置中选择云端插件
- 3.IOS 要在配置 manifest.json 文件中找到 ios 项,加入以下代码。。
"ios" : { "urltypes" : [ { "urlschemes" : ["tbopen+你在百川创建应用的appkey"]//不加会导致拉起手淘回不到自己的app。或者登陆失败 } ], "urlschemewhitelist" : "tbopen,tmall"//不加会导致拉不起手淘 }
- 4.制作自定义基座并运行自定义基座(点击运行->运行到手机或模拟器->运行基座选择->自定义调试基座)
插件接口
方法名 | 说明 |
---|---|
init() | 初始化sdk |
login() | 淘宝授权登陆 |
getUserInfo() | 获取授权登陆用户信息 |
logout() | 退出登陆 |
openByUrl() | 打开URL页面 |
openByCode() | 打开套件页面 |
myevent() | 注册监听 |
showFloatWindow() | 开启自检工具 |
topAuth() | 渠道授权(新增) |
实例化插件 ,在需要用到插件的页面引入
const plug= uni.requireNativePlugin('UZK-AlibcBylive');
1.初始化sdk
plug.init(res=>{
});
2.授权登陆
plug.login(res=>{
});
3.获取授权登陆用户信息
plug.getUserInfo(res=>{
});
4.退出登陆
plug.logout(res=>{
});
5.打开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的时候必传 | 无 |
6.打开套件页面
plug.openByCode({
//参数见下方说明
},res=>{
});
参数名 | 释义 | 是否必传 | 默认值 |
---|---|---|---|
code | 百川套件 | 是 | 无 |
unionId | 淘客unionId | 否 | 无 |
subPid | 三方的淘客广告位(可选参数 | 否 | 无 |
pid | 推广位id | 否 | 无 |
liveid | 直播间id() | 打开指定直播间ID的时候必传 | 无 |
item_id | 商品ID | 打开商品详情的时候必传 | 无 |
couponActivityId | 券id | 否 | 无 |
relationId | 渠道id | 否 | 无 |
openType | 打开类型 支持参数native/auto | 否 | native |
vegasCode | 加密淘礼金id | 否 | 无 |
flRate | 当前用户返利比例,乘以10000后小数点可保留6位,例如:33.33333333%可以传入3333.333333 | 否 | 无 |
dlRate | dlRate: 当前用户渠道比例,乘以10000后小数点可保留6位,例如:33.33333333%可以传入3333.333333 | 否 | 无 |
maxDlRate | 当前用户最高渠道比例,乘以10000后小数点可保留6为,例如:33.33333333%可以传入3333.333333 | 否 | 无 |
7.目前支持的套件列表
套件名 | 释义 |
---|---|
suite://bc.suite.live/bc.template.live.list | 打开直播间列表 |
suite://bc.suite.live/baichuan.liveroom.template | 打开指定直播间 |
suite://bc.suite.live/bc.template.detail | 打开商品详情 |
suite://bc.suite.live/bc.template.cart | 打开购物车 |
8.监听详情页分享按钮
plug.myevent({
//具体用法参考插件页面右上角示例项目。
},res=>{
});
- 配置底部分享按钮,如果要实现分享功能,底部-分享icon跳转url这一项一定要配置为“http://share”,方便后面拦截分享功能。
9.开启自检工具
plug.showFloatWindow();
- 安卓需要在打包的时候增加相关权限
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
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!