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及更高版本