更新记录

2.5.0（2026-03-04）

• 把 topAuth 方法参数由之前的appkey 名称统一改成 appKey 。

2.4.0（2026-02-27）

• 从百川标准版 升级到 百川旗舰版SDK ,Android 5.0.2.6 版本，ios 5.0.0.18 版本。

2.3.0（2021-03-29）

修复android h5授权缓慢问题。

平台兼容性

原生插件通用使用流程：

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 和 ios 百川电商 SDK旗舰版 插件使用

百川官网网址:https://console.baichuan.taobao.com

引用插件

const Baichuan= uni.requireNativePlugin('Html5app-Baichuan');

• 创建百川应用

• 开通百川电商旗舰版

在百川套件平台网站获取安全图片:https://suite.baichuan.taobao.com/suite2.htm#/sdk

安全图片使用要求

• 获取安全图片，必须先用自己应用的签名证书，先打包一个apk 或 ipa 安装包，再上传到百川后台获取安全图片。
• 下载安全图片后，把它命名为：yw_1222_baichuan.jpg ,把它放在以下相应的目录下，再提交云打包 -在项目根目录下插件nativeplugins目录下
• android :创建Html5app-Baichuan/android/res/drawable
• ios : 创建Html5app-Baichuan/ios

必须: Android 端需要设置关闭混肴 功能，否则 百川识别不到安全图片。

• 在配置文件manifest.json 中添加以下参数 -"enableResourceOptimizations" : false 设置为false 关闭混肴

 "distribute" : {
    "android" : {
        "enableResourceOptimizations" : false
    }
}

必须: IOS 端的配置 urlscheme

• urltypes：tbopen35081809 ,tbopen+appkey 组合
• urlschemewhitelist： 添加淘宝应用白名单 tbopen,tmall,taobaolite

 "distribute" : {
   "ios" : {
    "urltypes" : "tbopen35081809", //其中35081809换成你appkey
    "urlschemewhitelist" : "tbopen,tmall,taobaolite",
    }
}

方法使用说明

1. 初始化

    Baichuan.initSDK(function(res){

         console.log(res);
    });

2. 淘宝授权登录

 Baichuan.login(function(res){
       console.log(res);

  });

• 授权成功返回数据

  {
  "userId": "AAG58s5aAObLKIoV95uHtooy",
  "code": 0,
  "nick": "tb199428463",
  "msg": "授权登录成功"
  }

3. 退出授权登录

Baichuan.logout(function(res){
     console.log(res);
});

4. TopAuth授权登录

• 媒体自主传入appKey, appKey 留空，默认使用内置百川安全图片中的appkey信息

  Baichuan.topAuth({appKey:""},
  res=>{
  
   console.log(res);
  }
  );

• TopAuth 授权成功返回的数据

  {
  "accessToken": "50000400647ri77Xe6hHjNzQwEh2G2fKvBRQDYjbUBLyvCJjSlO8zOVrY091dce4e33u",
  "expireTime": "7775999",
  "topAuthCode": "aycqZ4BtRnVn4ykbd0GYAame28614896",
  "topAccessToken": "6302301eaa77b07d2f71908872db465994c22111c6db1652207848976694",
  "code": 0,
  "userId": "AAG58s5aAObLKIoV95uHtooy",
  "nick": "tb199428463",
  "msg": "授权登录成功"
  }

5. 打开商品链接

Baichuan.openByUrl(
{
url:"https://m.tb.cn/h.6FNbtf2",
showParams: //页面打开方式自定义参数
{      
    setOpenType:"native", // 打开类型 auto，native
    setBackUrl:"alisdk://", //小把手
    setClientType:"taobao", //唤端类型：手淘：taobao，天猫：tmall
    setDegradeType:"", // 降级类型 none，h5，download
    setDegradeUrl:"", //支持唯一自定义的降级url
    setTitle:"" //标题
},
taokeParams: //淘客参数
{
    pid:"", //淘客广告位
    unionId:"", // 淘客unionId
    subPid:"", //三方的淘客广告位（可选参数）
    relationId:"", //渠道id（非必填项）
    materialSourceUrl:"", //媒体物料来源url（非必填项）：数据链路的回溯支持
    extParams:{} //扩展参数(分佣相关的)              
},
trackParams:{} //链路跟踪参数（自定义）
},
function(res)
{
  console.log(res);

}

);

6. 打开电商套件

Baichuan.openByCode(
{
code:"suite://bc.suite.basic/bc.template.cart", //套件code
showParams: //页面打开方式自定义参数
{      
setOpenType:"native", // 打开类型 auto，native
setBackUrl:"alisdk://", //小把手
setClientType:"taobao", //唤端类型：手淘：taobao，天猫：tmall
setDegradeType:"", // 降级类型 none，h5，download
setDegradeUrl:"", //支持唯一自定义的降级url
setTitle:"" //标题
},
bizParams://业务参数
{
setId:"",         // 商品id（详情页面必传）
setSellerId:"",  //卖家id（店铺页面必传）
setShopId:"",   //店铺id（店铺页面必传）
setExtParams:{} //扩展业务参数（涉及到联盟侧诸如返佣比例等参数，具体含义及获取会在分佣相关部分说明
},
taokeParams: //淘客参数
{
pid:"", //淘客广告位
unionId:"", // 淘客unionId
subPid:"", //三方的淘客广告位（可选参数）
relationId:"", //渠道id（非必填项）
materialSourceUrl:"", //媒体物料来源url（非必填项）：数据链路的回溯支持
extParams:{} //扩展参数(分佣相关的)

},
trackParams:{}  //链路跟踪参数（自定义）
},
function(res)
{
console.log(res);
}
);

7. 获取用户信息

  Baichuan.getUserInfo(function(res){
     console.log(res);
 });

8. 获取Utdid

   let uid=Baichuan.getUtdid(); 
   console.log(uid);

9. 设置Isv 版本

Baichuan.setIsvVersion(
{
 version:"1.0.0" //设置三方媒体应用版本号
},
function(res){   
  console.log(res);
});

10.设置渠道

Baichuan.setChannel({
typeName:"",  //渠道类型（默认为：0）
channelName:"" //渠道名称（默认为：空）
}
},
function(res){           
  console.log(res);
});