更新记录

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

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
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.在百川控制台-我的产品后台开通百川电商旗舰版权限

Image text

Image text

  • 3.在我的套件中点击配置项版本管理增加版本

Image text

  • 4.分别配置购物车和商品详情套件

Image text

  • 5.配置底部分享按钮,如果要实现分享功能,底部-分享icon跳转url这一项一定要配置为“http://share”,方便后面拦截分享功能。

Image text

  • 6.发布套件,在app开发过程中可以选择白名单进行快速调试。套件的所有改动都需要发布方可生效。

Image text

配置插件

  • 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.制作自定义基座并运行自定义基座(点击运行->运行到手机或模拟器->运行基座选择->自定义调试基座)

Image text

插件接口

方法名 说明
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!

Image text

隐私、权限声明

1. 本插件需要申请的系统权限列表:

android.permission.READ_PHONE_STATE android.permission.WRITE_SETTINGS android.permission.BLUETOOTH android.permission.READ_SETTINGS android.permission.GET_TASKS 详情可参考:https://alimama.open.taobao.com/docV3.htm?docId=118885&docType=1&noHeader=1

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件使用的 阿里百川 SDK会采集数据,详情可参考:https://alimama.open.taobao.com/docV3.htm?docId=118885&docType=1&noHeader=1

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问