tools

来自于:开发者立即使用

免SDK多图分享工具

本模块是一款淘客多图专用的分享工具,可以将多图或单图分享到微信好友和朋友圈,及QQ和QQ空间和微博

注意:使用该模块分享到qq或者是微博时,需保证在线并且超过一定登录时间

模块接口

share

分享内容

share({params}, callback(ret, err))

params

to:

  • 类型:字符串
  • 描述:(必须)分享的目标平台
  • 取值范围:

    • weixin (微信朋友圈)
    • weixn_friend (微信好友)
    • qq (QQ好友)
    • qq_zone (QQ空间)
    • weibo (微博)
    • system(系统)

      注: 在ios下qq和qq_friend是一样的,是要让用户来选择分享到哪个平台 在ios下weixin和weixn_friend是一样的,是要让用户来选择分享到哪个平台

picurl:

  • 类型:数组
  • 描述:(必须)[图片1,图片2,图片3....] 微信朋友圈,好友,QQ空间,QQ好友最多9张 (微博只能1张图)
  • 默认值:[]

content:

  • 类型:字符串
  • 描述:- 分享的文本 可单行或多行
          -  目前测试只有安卓的微博可带文字,其它都不能直接传到分享页去,旧版微信可以传过去,新版不行
          - 安卓端朋友圈现在新版微信都不带内容了,如有内容可复制到剪贴板再粘贴(旧版之前是可以)
          - 苹果端版本从ios11开始是微信专用的分享,需打开选择好友或朋友圈才能分享,所以文字也需要先复制到剪贴板再粘贴
          - 苹果端ios11以下是可以绕过微信选择页面,直接前往朋友圈或是好友界面分享.
    

show_dialog:

  • 类型:布尔型
  • 描述:(可选项,在IOS上才有效) 在IOS 11及以上没有办法直接绕过系统分享对框,必须将此处设为true 就先调用系统对话框来让用户选择分享到哪个用户,如选择微信,再调用微信的专用分享页去选择分享到朋友圈或是好友 (微博,QQ也都一样,这个是系统限制)
      -  若将这里设为true,则to参数无效,因为他会让用户来选择分享到哪去,
      -  如设为false,则分享前需先检测一下IOS版本,是11及以上,就必须设为true,不然没反应.
      -  ios微博分享,必须设为true,不然发不出去
      -  建议直接把这里设为true最省事,不然要做下版本和分享目录检测
    
  • 默认值:false

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  • code : 1或0 ios系统code=1代表分享成功,其它代表取消(在IOS上如果系统版本>=11或是show_dialog=true,这里就不会有回调) android系统code=1代表打开目标应用成功(是否有进行分享这个没办法知道)
    {
     code: 1      //1代表调用目标客户端成功 其它代表失败
    }
    

err:

  • 类型:JSON对象
  • 内部字段:
{
   code: 0      //1代表调用目标客户端成功 其它代表失败
}

示例代码

var dir = api.wgtRootDir+'/';
var images = [
        dir+'image/1.jpg',
        dir+'image/2.jpg',
        dir+'image/3.jpg',
        dir+'image/4.jpg',
        dir+'image/5.jpg',
        dir+'image/6.jpg',
        dir+'image/7.jpg',
        dir+'image/8.jpg',
        dir+'image/9.jpg',
];

var param = {
    picurl:images,
    to:"weixin",
    content:"【在吗?我领了淘宝发的新春现金红包,你帮我拆开后我们都有机会拿最高2018元红I包!",
    show_dialog:false,
};
tools.share(param,function(res){
    alert(JSON.strify(res));
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本