更新记录

1.7.0（2020-09-23）

修复iOS跳转url加载速度过慢的问题

1.6.0（2020-09-08）

-修改方法loginH5ByToken()参数变化

1.5.0（2020-09-07）

新增 渠道备案(无感静默式) 新增 兼容本系列阿里实人认证 , 使用本插件需导入部分sdk,详见使用说明

平台兼容性

原生插件通用使用流程：

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原生插件配置”->”云端插件“列表中删除该插件重新选择

准备工作

1.首先加入百川http://baichuan.taobao.com/,在阿里百川控制台创建应用获取appkey 2.在阿里百川控制台“我的产品后台”中申请百川电商SDK 3.申请安全图片。安全图片选择V5版本 4.开通电商业务产品权限

插件说明

唤醒手淘。

任何投放都可直接唤醒手淘打开。当消费者无手淘时，默认引导手淘下载，但开发者可自行调整为退回到H5页面打开(请注意此时登录态不再支持透传)； 部分页面可支持在开发者APP内打开，可以默认不唤醒手淘。这部分页面，新版百川SDK将通过套件功能对外开放，在套件内会包含相应可被调用的页面。

登录

支持媒体APP里面使用淘宝账号登录，媒体使用百川SDK提供的能力时，百川SDK会透传用户登录态。

授权

用户可将某些功能/能力同意给媒体使用，媒体可通过获取用户的授权，访问页面/API等数据。

使用方式

android安全图片路径:nativeplugins/TQ-AliBCModule/android/res/drawable/yw_1222.jpg

IOS的安全图片下载下来后需要重新命名为yw_1222_baichuan.jpg，否则会初始化失败

IOS安全图片路径:nativeplugins/TQ-AliBCModule/ios/yw_1222_baichuan.jpg

安卓需要增加的包(在官网下载sdk中),也可通过下载实例文件快速找到这两个包

需要加入文件SecurityBodySDK-external-release-5.4.112-preInstall.aar,SecurityGuardSDK-external-release-5.4.193-preInstall.aar,放到nativeplugins/TQ-AliBCModule/android目录下

如果使用了本系列插件中的 <阿里实人认证TQ-AliAuthPlugin> 导致sdk冲突,请联系我们

IOS 要在配置 manifest.json 文件中找到 ios 项,加入以下代码

"ios" : {
        "urltypes" : [
        {
        "urlschemes" : ["tbopen+你在百川创建应用的appkey"]//不加会导致拉起手淘回不到自己的app。或者登陆失败
        }
        ],
        "urlschemewhitelist" : "tbopen,tmall"//不加会导致拉不起手淘
}

提示： 如果你的APP同时也集成了支付宝SDK,要把插件包中的 UTDID.framework 和 utdid4all-1.1.5.3_proguard.jar 文件删除否则会提示冲突。，如果没有集成则保留一起打包。

必须提交云打包 或 制作自定义基座 ,才能有效果

调用插件

var ali = uni.requireNativePlugin("TQ-AliBCModule")
初始化:
ali.init(e => {
    console.log(e)
});
登录授权:
ali.login(e => {
    console.log(e)
})
获取用户信息
ali.getUserInfo(e=>{
    console.log(e)
})
打开商铺:
ali.openShop(
    pid, 
    shopId,
    tclient,
    backUrl,
(ret) => {

})
打开商品详情:
ali.openProductDetail(
    pid,
    productId,
    client,
    backUrl,
(ret) => {

})
打开购物车:
ali.openMyCart(
    pid,
    client,
    backUrl,
(ret) => {

})
打开url:
ali.openByUrl(
    pid,
    url,
    client,
    backUrl,
(ret) => {

})
渠道备案,静默无感式
ali.loginH5ByToken(
pid,
url,
client,
(ret)=>{

})

6.参数说明

pid：

类型：字符串
描述：(可选项)采用联盟PID方式打点。

client：

类型：字符串
描述：（可选项）拉起淘宝或者天猫客户端，默认拉起淘宝客户端
默认值：taobao
取值范围：
taobao（淘宝）
tmall（天猫）

backUrl:

类型：字符串
描述：指定手淘回跳的地址，跳转至isv指定的url
规则: tbopen${appkey}://xx.xx.xx

shopId:

类型：字符串
描述：需要跳转的商铺id

productId:

类型：字符串
描述：需要跳转的商品id

url:
类型：字符串
描述: 打开百川SDK套件内的相关页面

新增渠道备案 loginH5ByToken（静默无感式）

支持token的方式进行备案

用token的方式链接格式为： https://oauth.m.taobao.com/authorize?response_type=token&client_id=你的淘宝联盟APPKEY&redirect_uri=你的回调地址&state=你的自定义参数&view=web

关于回调地址

在你的回调地址中引入一个百川的js

<script type="text/javascript" src="https://g.alicdn.com/mtb/lib_BC/0.1.0/p/index/index.js">

在页面中执行一段js,达到自动关闭当前的百川webview

    setTimeout(function () {
        console.log(JSON.stringify(Baichuan));
        Baichuan.closeWebView();
    },2000);

注意事项

1.所谓静默式就是用户无需二次授权就可以获取到用户的渠道。该接口无任何ui界面，无感知的

2.该方法命中率不敢保证百分百，可以多执行几次。

3.调用该接口前一定要先进行一次手淘授权，login()。

Q&A

• QQ -- 419231612

  ---

有使用上的问题可以随时联系，谢谢