更新记录

1.18(2019-10-29)

优化android 获取用户信息逻辑,有限检查是否登录,并自动进行登录

1.17(2019-10-21)

完善淘客授权,统一ios及android返回值

1.15(2019-10-08)

  1. iOS版本上线,略微调整价格,望谅解

  2. 完善帮助文档

  3. 完善案例

查看更多

平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 11.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原生插件配置”->”云端插件“列表中删除该插件重新选择


官方文档

Android下载体验

5+版本需要离线打包,有需要可联系作者37894663

下载安全图片

1.用您的签名任意生成apk,上传到百川官网

2.android 下载安全图片放置目录nativeplugins/PP-ALBC/android/res/drawable/yw_1222.jpg

3.iOS 下载安全图片放置目录nativeplugins/PP-ALBC/ios/yw_1222.jpg (更换后需要重新打包)

4.iOS 另外需要在项目的 manifest.json 文件加入下面代码 (修改后需要重新打包)


//"app-plus" ==> "distribute" ==> "ios" 节点

"ios" : {
    "urltypes" : [
        {
            //AppKey从百川开发者控制台 应用管理 页面获得
            //tbopen{AppKey} 24545262为测试案例的Appkey
            "urlschemes" : [ "tbopen24545262" ] 
        }
    ]
}

调用实例及参数说明(androin ios 调用方式一致)

初始化配置

    const PPBC = uni.requireNativePlugin('PP-ALBC');
    //以下有值的皆为默认值
    PPBC.initOptions({
        //淘客信息配置
        pid:'',  
        unionId:'',
        subPid:'',
        // (注:1、如果走adzoneId的方式分佣打点,需要在extraParams中显式传入taokeAppkey,否则打点失败;    
        //  2、如果是打开店铺页面(shop),需要在extraParams中显式传入sellerId,否则同步打点转链失败)
        adzoneId:'',
        taokeAppkey:'',
        sellerId:'',
        // 自定义参数 trackParams
        trackParams:{},
        //OpenType(页面打开方式)(Auto和Native)
        //Native表示唤端,Auto表示不做设置
        openType:'Auto',  
        //clientType表示唤端类型(taobao和tmall)
        //taobao---唤起淘宝客户端;tmall---唤起天猫客户端
        clientType:'taobao',
        //BACK_URL(返回小把手):唤端返回的scheme(android传入可隐藏"返回小把手")
        backUrl:'alisdk://',//(ios无此参数)
        //AlibcFailModeType(唤端失败模式(未安装淘宝)) 参数如下
        //AlibcNativeFailModeNONE:不做处理;
        //AlibcNativeFailModeJumpBROWER:跳转浏览器;
        //AlibcNativeFailModeJumpDOWNLOAD:跳转下载页;
        //AlibcNativeFailModeJumpH5:应用内webview打开)
        failModeType:'AlibcNativeFailModeJumpH5'
    }, result => {
        console.log(JSON.stringify(result))
    });

淘宝客授权

自行拼装地址传入请求地址即可然后按照实例传入 拼装格式:https://oauth.taobao.com/authorize?response_type=token&client_id=25016850&redirect_uri=你的回调地址&state=附加参数&view=wap';

提供的接口代码实例

    // 登录
    inter('login')
    //获取用户信息
    inter('getUserInfo')
    //我的购物车
    inter('myCar')
    //跳转商户(shopid)
    inter('openShopById',{shopid:'114548164'})
    //跳转商品(itemid)
    inter('openItemById',{itemid:'563479060793'})
    //打开链接(url) 优惠券、淘客授权等,部分页面不支持,请自行尝试
    inter('openItemByUrl',{itemurl:'https://s.click.taobao.com/ZgAl20w'})
    //淘宝客授权,实例(返回code)
    let tkurl='https://oauth.taobao.com/authorize?response_type=code&client_id=23196777&redirect_uri=http://tool.chaozhi.hk/api/authorize.php&state=1024&view=wap';
    inter('taokeauth',{authurl:tkurl})

    //封装方法
    inter(order, param) {
        const PPBC = uni.requireNativePlugin('PP-ALBC');
        let config = {order: order}
        if (typeof param == 'object')
            for (let s in param) {
                config[s] = param[s]
            }
        PPBC.show(config, result => {
            console.log(JSON.stringify(result))
        });
    }

参数返回接口

用户信息为例

    result={
        msg:"获取成功",
        code:200,
        data:
        {
            openId:"",
            topAccessToken:"",
            nick:"",
            userid:"",//iOS 无此返回
            openSid:"",
            topExpireTime:"", //iOS 无此返回
            avatarUrl:"",
            topAuthCode:""
        }
    }

隐私、权限声明

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

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

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

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