更新记录

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

原生插件通用使用流程:

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

Image text

插件接口

方法名 说明
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”,方便后面拦截分享功能。

Image text

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!

Image text

隐私、权限声明

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

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

插件本身不采集数据,插件使用的百川旗舰版sdk可能会采集数据

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

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