tools

来自于:开发者立即使用

share

免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:

  • 类型:字符串
  • 描述:- 分享的文本 可单行或多行

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

show_dialog:

  • 类型:布尔型
  • 描述:(可选项,在IOS上才有效) 在IOS 11及以上没有办法直接绕过系统分享对框,必须将此处设为true 就先调用系统对话框来让用户选择分享到哪个用户,如选择微信,再调用微信的专用分享页去选择分享到朋友圈或是好友 (微博,QQ也都一样,这个是系统限制)

    1. - 若将这里设为true,则to参数无效,因为他会让用户来选择分享到哪去,
    2. - 如设为false,则分享前需先检测一下IOS版本,是11及以上,就必须设为true,不然没反应.
    3. - ios微博分享,必须设为true,不然发不出去
    4. - 建议直接把这里设为true最省事,不然要做下版本和分享目录检测
  • 默认值:false

callback(ret, err)

ret:

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

    1. {
    2. code: 1 //1代表调用目标客户端成功 其它代表失败
    3. }

err:

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

示例代码

  1. var dir = api.wgtRootDir+'/';
  2. var images = [
  3. dir+'image/1.jpg',
  4. dir+'image/2.jpg',
  5. dir+'image/3.jpg',
  6. dir+'image/4.jpg',
  7. dir+'image/5.jpg',
  8. dir+'image/6.jpg',
  9. dir+'image/7.jpg',
  10. dir+'image/8.jpg',
  11. dir+'image/9.jpg',
  12. ];
  13. var param = {
  14. picurl:images,
  15. to:"weixin",
  16. content:"【在吗?我领了淘宝发的新春现金红包,你帮我拆开后我们都有机会拿最高2018元红I包!",
  17. show_dialog:false,
  18. };
  19. tools.share(param,function(res){
  20. alert(JSON.strify(res));
  21. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本