尽管ShareSDK尽可能屏蔽了不同社交平台间接口api差别,然而分享接口须要传递的差别仍然会因平台而异,本文将以列表的模式展现不同平台的分享参数(ShareParams)的字段要求,以不便开发者应用时翻阅。 留神没有表明可选的就是必填参数,不能为null或者空字符串,另一种状况是例如有imageUrl(”网络图片链接”)、imagePath(“/sdcard/abc.jpg”)、imageData(bitmap)是三选一。
国内平台
新浪微博
新浪微博反对分享文字、本地图片、网络图片
参数阐明 text:140字符以内
image:web分享ShareSDK不做限度间接提交给微博解决,微博客户端分享图片不能大于2M,仅反对JPEG、GIF、PNG格局; 注:微博分享链接是将链接写到setText内:eg:setText(“分享文本 http://mob.com”);
ImageArray String类型图片数组,可传手机本地图片门路和图片链接,分享多图的时候须要将Url参数正文掉,否则会默认分享链接;
分享文本
text
留神:以下分享类型必须有新浪微博客户端才能够分享,如果imagePath和imageUrl同时存在,imageUrl将被疏忽;
分享图文
text
imagePath
imageUrl
imageData
分享本地视频
FilePath("/sdcard/video.MP4")
text("文本")
腾讯微博
腾讯微博反对分享文字、本地图片、网络图片和经纬度信息 参数阐明 text:最多140个字字符 image:图片最大4M
分享文本
text
latitude(可选)
longitude(可选)
分享图文
text
imagePath
latitude(可选)
longitude(可选)
imageUrl ImageArray
2.5.0当前的版本新增分享多张图片的性能ImageArray。 因为腾讯微博分享网络图片并不属于高级接口,因而imageUrl优先级高于imagePath,这就是说,如果imagePath和imageUrl同时存在,imagePath将被疏忽。
QQ空间
提醒:必须须要QQ客户端才能够分享
QQ空间反对分享文字和图文 参数阐明 title:最多200个字符 text:最多600个字符
分享视频
FilePth("/sdcard/视频.mp4")
ShareType(platform.SHARE\_VIDEO)
分享文本
text
ShareType(platform.SHARE\_TEXT)
分享网页
text
imagePath
title
titleUrl
ShareType(platform.SHARE\_WEBPAGE)
imageUrl
分享图片
imagePath
ShareType(platform.SHARE\_IMAGE)
imageUrl
微信(好友、朋友圈、珍藏)
提醒:
1.必须须要客户端才能够分享;
2.微信客户端版本从6.7.2以上开始,勾销分享提醒分享胜利;即勾销分享和分享胜利都返回胜利事件;
3.Android11及之后的版本,微信分享图片不反对用imageData(bitmap)接口设置参数;
绕过审核只对微信好友、微信朋友圈无效 微信分享如果是绕过审核(配置信息BypassApproval属性设置为true为绕过审核),微信朋友圈能够分享单张图片或者图片与文字一起分享,微信好友能够进行文字或者单张图片进行分享,分享回调不会正确回调。 不绕过审核,微信三个平台中,好友的性能最残缺,朋友圈不能分享利用,珍藏不能分享利用,表格下以好友为例子: 参数阐明 title:512Bytes以内 text:10KB以内 imageData:10M以内 imagePath:10M以内(传递的imagePath门路不能超过10KB) imageUrl:10KB以内 musicUrl:10KB以内 url:10KB以内(MobSDK没有对参数另做限度,参数限度详细情况能够参考微信官网的限度详情点击这里查看)
留神:微信分享分绕过审核和不绕过审核,不绕过审核必须保障微信后盾配置的签名与您的app的签名统一,否则无奈分享;
分享文本
shareType(Platform.SHARE\_TEXT)
text
分享图片
shareType(Platform.SHARE\_IMAGE)
text(设置了不会显示,可选参数)
imagePath
imageUrl
imageData
分享音乐
shareType(Platform.SHARE\_MUSIC)
title
text(朋友圈不显示此字段)
imagePath
musicUrl
url(音讯点击后关上的页面)
imageUrl
imageData
分享视频
shareType(Platform.SHARE\_VIDEO)
title
text(朋友圈不显示此字段)
imagePath
url(视频网页地址)
imageUrl
imageData
分享网页
shareType(Platform.SHARE\_WEBPAGE)
title
text(朋友圈不显示此字段)
imagePath
url
imageUrl
imageData
分享文件
shareType(Platform.SHARE\_FILE)
title
text(不显示此字段)
filePath
分享小程序
shareType(Platform.SHARE\_WXMINIPROGRAM)
title
setWxUserName("小程序原始ID")
setWxPath("小程序页面门路")
url
text
imagePath
imageUrl
imageData
微信并无理论的分享网络图片和分享bitmap的性能,如果设置了网络图片,此图片会先下载会本地,之后再当作本地图片分享,因而提早较大。bitmap则好一些,然而因为bitmap并不知道图片的格局,因而都会被当作png编码,再提交微信客户端。
留神:分享小程序阐明,具体分享流程点击这里查看:
目前只反对分享微信好友,分享小程序必须配置小程序的原始ID和分享小程序页面的门路;配置办法有两种;
第一种:在办法中配置,如上表所示加上setWxUserName和setWxPath;
第二种:在ShareSDK.xml文件中配置上非凡参数,如下所示:userName是小程序的原始ID,path是小程序内的页面门路;而且必须保障微信开放平台与微信公众/小程序绑定才能够分享;
<Wechat Id="4" SortId="4" AppId="wx4868b35061f87885" AppSecret="64020361b8ec4c99936c0e3999a9f249" userName="gh_afb25ac019c9" path="/page/API" BypassApproval="false" Enable="true" />
提醒:微信客户端版本从6.7.2以上开始,勾销分享提醒分享胜利;即勾销分享和分享胜利都返回胜利事件;
QQ分享
QQ分享反对图文和音乐分享 参数阐明 title:最多30个字符 text:最多40个字符 QQ分享图文和音乐,在PC版本的QQ上可能只看到一条连贯,因为PC版本的QQ只会对其白名单的连贯作截图,如果不在此名单中,则只是显示连贯而已. 如果只分享图片在PC端看不到图片的,只会显示null,在手机端会显示图片和null字段。
分享图片
ImageUrl
imagePath
分享链接
title
titleUrl
text
imagePath
imageUrl
分享音频
title
titleUrl
text
imagePath
musicUrl
imageUrl
分享QQ小程序
shareType(Platform.QQ\_MINI\_PROGRAM)
text
title
titleUrl
imageUrl
setQQMiniProgramAppid("小程序appid")
setQQMiniProgramPath("小程序页面门路")
setQQMiniProgramType("")(小程序类型:develop/trial/release)
关上QQ小程序
shareType(Platform.OPEN\_QQMINIPROGRAM)
text
title
titleUrl
imageUrl
setQQMiniProgramAppid("小程序appid")
setQQMiniProgramPath("小程序页面门路")
setQQMiniProgramType("")(小程序类型:develop/trial/release)
(3.1.0版本之后,蕴含3.1.0)QQ绕过审核模式反对分享多图(BypassApproval="true"),ImageArray String类型图片数组,可传手机本地图片门路和图片链接
绕过审核分享多图
text(可不传)
imageArray
人人网
人人网反对分享文字和图文 参数阐明 title:最多30个字符 text:最多200个字符 comment:最多500个字符 image:反对bmp,png,gif,jpg格局
分享文本
text
分享链接
text
url
分享图文
comment
imagePath
imageUrl
与QQ空间一样,人人网不间接分享本地图片,如遇本地图片,会先将其发送到ShareSDK的文件服务器当前获得网络地址,再行分享
开心网
开心网能够分享文字和图片,其中图片能够反对网络图片和本地图片 参数阐明 text:最多140个字符或者280个英文字母字符 image:最大10M,反对jpg/jpeg/gif/png/bmp格局
分享文本
text
分享图文
text
imagePath
imageUrl
豆瓣
豆瓣反对分享文字和图文 参数阐明 image:反对JPEG,GIF,PNG格局,最大3M
(注:近期豆瓣api正在保护,ApiKey临时不对集体凋谢申请,如有企业单干相干要求,请发邮件到bd-team@douban.com,将有负责共事尽快与您分割)
分享文本
text
分享图文
text
imagePath
imageUrl
有道云笔记
有道云笔记事实上不是分享,而是创立一个笔记,以后能够发图片和图文笔记:
分享文本
title
notebook(可选)
address(可选)
text
url(可选)
分享图文
title
notebook(可选)
address(可选)
text
imagePath
url(可选)
imageUrl
易信(好友和朋友圈)
提醒:必须须要客户端才能够分享
易信的接口与微信的相似,然而易信临时不反对分享文件和表情 参数阐明 title:不能超过512个字 text:不能超过10240个字 imageData:不能超过10485760个字节 imagePath:不能超过10485760个字节 imageUrl:URL长度不能超过10240个字节
分享文本
shareType(SHARE\_TEXT)
title
text
分享图片
shareType(SHARE\_IMAGE)
title
text
imagePath
imageUrl
imageData
分享音乐
shareType(SHARE\_MUSIC)
title
text
imagePath
musicUrl
url(音讯点击后关上的页面)
imageUrl
imageData
分享视频
shareType(SHARE\_VIDEO)
title
text
imagePath
url(视频网页地址)
imageUrl
imageData
分享网页
shareType(SHARE\_WEBPAGE)
title
text
imagePath
url
imageUrl
imageData
明道
明道反对分享文本或图文 参数阐明 text:最多为2080个字符
注:明道限度分享网络图片的话必须要用https的图片链接,并且明道分享进来之后不给显示图片;
分享文本
text
url
分享网页
text
url
imagePath
imageUrl
明道自身只反对分享网络图片,如果打算分享imagePath,须要先将文件上传到ShareSDK的文件服务器,之后再将失去的地址当作网络图片分享。因为imagePath更耗流量,因而imageUrl优先级更高
支付宝
提醒:生活圈只反对分享网页、必须须要客户端才能够分享
分享文本
shareType(SHARE\_TEXT)
title
text
分享图片
shareType(SHARE\_IMAGE)
title
text
imagePath
imageUrl
imageData
分享网页
shareType(SHARE\_WEBPAGE)
title
text
imagePath
url(音讯点击后关上的页面)
imageUrl
imageData
钉钉
提醒:必须须要客户端才能够分享,应用imagePath分享本地图片限度在500kb,过大会导致失败
分享文本
shareType(SHARE\_TEXT)
title
text
分享图片
shareType(SHARE\_IMAGE)
title
text
imagePath
imageUrl
imageData
分享网页
shareType(SHARE\_WEBPAGE)
title
text
imagePath
url(音讯点击后关上的页面)
imageUrl
imageData
美拍
提醒:美拍是调用零碎客户端分享的,必须须要客户端才能够分享,没有精确的回调,点击调用客户端即默认提醒分享胜利
分享视频
FilePath(/sdcard/视频.mp4)
分享图片
FilePath(/sdcard/图片.jpg)
抖音
留神:目前分享图片只反对本地图片分享,倡议间接保留到手机相册门路下分享,否则抖音可能无奈找到图片;分享内容带水印可能会受到限制或被删除,请勿携带水印。
要求:
视频:
- 1、时长必须符合要求,最大不能超过1小时,最小值抖音动静配置;
- 2、必须是mp4文件,并且反对解析;
- 3、画面比例,最大边/最小边 要小于4
- 4、画幅尺寸最大边要小于1100px
- 5、多段视频拼接数不超过12个
图片:
- 1、宽高大于360
- 2、宽高比符合要求(需1/2.2<=宽高比<=2.2)
- 3、多图不超过12张
分享多图
shareType(SHARE\_IMAGE)
imageArray(String[] AVATARS(多个或单个本地图片门路))
title(选填)
hashtags(参数为数组格局,选填)
hashtag(title中加tag,选填)
tagPositio(插入题目的地位索引,参数为int类型,eg:1示意title第一个字符之后 插入,选填)
stack(贴纸,选填)
setActivity //适配9.0零碎
分享视频
shareType(SHARE\_VIDEO)
VideoPathArray(String[] AVATARS(多个或单个本地视频门路))
title(选填)
hashtags(参数为数组格局,选填)
hashtag(title中加tag,选填)
tagPositio(插入题目的地位索引,参数为int类型,eg:1示意title第一个字符之后 插入,选填)
stack(贴纸,选填)
setActivity //适配9.0零碎
图片+视频混合分享(3.9.6及之后版本反对)
shareType(Platform.DY\_MIXFILE)
ViDYMixFileArray(new String[]{本地图片相对地址,本地视频相对地址})(合成后程序为传入程序)
title(选填)
hashtag(参数为数组格局,选填)
hashtags(title中加tag,选填)
tagPositio(插入题目的地位索引,参数为int类型,eg:1示意title第一个字符之后 插入,选填)
stack(贴纸,选填)
setActivity //适配9.0零碎
ShareSDK 3.10.0及之后版本反对分享内容至好友列表,分享参数为:
分享图片
shareType(SHARE\_DYIM\_IMG)
imagePath(本地图片门路))
setActivity //适配9.0零碎
分享链接
shareType(SHARE\_DYIM\_WEBPAGE)
imageUrl(网络图片地址,选填))
title
url(网络链接,链接须要在抖音后盾认证)
setActivity //适配9.0零碎
企业微信
** 提醒:必须须要客户端才能够分享 **
分享文本
shareType(Platform.SHARE\_TEXT)
text
分享文件
shareType(Platform.SHARE\_FILE)
text
filepath
分享图片
shareType(Platform.SHARE\_IMAGE)
text
imagePath
分享视频
shareType(Platform.SHARE\_VIDEO)
text
filepath
分享网页
shareType(Platform.SHARE\_WEBPAGE)
title
text
imagePath
url
imageUrl
西瓜视频
** 提醒:必须须要客户端才能够分享,只反对分享网络视频 **
分享视频
shareType(Platform.SHARE\_VIDEO)
videoUri
setActivity //适配9.0零碎
快手
** 提醒:必须须要客户端才能够分享,只反对分享网络视频 **
** ShareSDK的3.8.2 版本适配快手原生SDK具体能够点击这里查看**
分享视频
setShareType(Platform.SHARE\_VIDEO)
setVideoUri
setActivity //适配9.0零碎
分享图片
setShareType(Platform.SHARE\_IMAGE)
setImagePath
setActivity //适配9.0零碎
小红书
** 提醒:必须须要客户端才能够分享,只反对分享网络视频 **
分享视频
setShareType(Platform.SHARE\_VIDEO)
setVideoUri
setActivity //适配9.0零碎
分享图片
setShareType(Platform.SHARE\_IMAGE)
setImagePath
setActivity //适配9.0零碎
绿洲
** 提醒:必须须要客户端才能够分享 **
分享图片
title
comment
imageUriList(本地图片uri参数)
imageUrlList(本地图片绝对路径分享)
分享网页
title
comment
videoUriOasis(本地视频uri参数)
videoPathOasis(本地视频绝对路径分享)
国外平台
分享参数阐明 image:至多200x200像素
注: 1.Facebook分享链接,所展现的图片、文字主动从分享的url中主动获取;
2.加载Facebook原生SDK的办法具体能够点击这里查看;
3.web引文分享(在web上方能够展现文字显示)-->Quote;
4.话题分享(在挪动端点击分享进来的话题可进行评论等)-->Hashtag
分享网页
Url
Quote("测试web引文分享")
分享图片
Hashtag("测试话题分享")
imagePath
imageUrl
分享视频
FilePth("/sdcard/视频.mp4")
分享多图
ImagePath("/sdcard/图片.jpg")
setImageArray(AVATARS)
留神:分享多图内是传一个string数组,外部必须传sdcard目录下的本地图片,而已图片不能雷同
Facebook提供了一种分享链接,卡片式的成果, 具体能够点击这里查看
Twitter反对文字和图文分享
分享文本
text
分享图文
text
imagePath
imageUrl
ImageArray(分享多图)
分享视频
FilePth("/sdcard/视频.mp4")
ShareType(platform.SHARE\_VIDEO)
Twitter提供了一种分享链接,卡片式的成果, 具体能够点击这里查看 Twitter平台比拟非凡分享之前必须受权,受权时,Twitter平台会有一个界面提醒用户会用到哪些权限,而Twitter 的App权限分级过于毛糙,分享动作必须的读写权限会申请过多权限,对于这个状况,咱们在3.8.2版本进行了适配,具体能够点击这里查看
印象笔记
提醒:印象笔记最新版本,分享胜利后不间接回调,须要按返回键才能够,并且返回勾销操作分享也胜利的,也提醒胜利的回调。
印象笔记能够反对文字和图文的分享,也反对利用客户端分享,只有在ShareSDL.xml中配置就行
分享文字
title
notebook(可选)
stack(可选)
publish(可选,示意是否公开)
text
tags(可选)
分享图文
title
notebook(可选)
stack(可选)
publish(可选,示意是否公开)
text
imagePath/imageUrl
tags(可选)
分享视频
text(可选)
FilePath
ShareType(Platform.SHARE\_VIDEO)
Linked-in
Linked-in反对分享文字或图文 分享参数阐明 title:最多200个byte text:最多256个byte comment:最多700个byte
分享链接(仅反对web端分享)
title
LinkedinDescription("形容")
text
url("分享链接")
分享文本
text
ShareType(Platform.SHARE\_TEXT)
分享图片 (仅反对客户端分享)
imageUrl("网络图片地址")
ShareType(Platform.SHARE\_IMAGE)
Linked-in自身并不反对分享本地图片,因而本地图片会先上传到ShareSDK文件服务器当前,再将返回图片链接进行分享。因为上传图片更耗流量,因而imageUrl的优先级高于imagePath。
FourSquare
FourSquare能够分享图文,然而分享时须要携带地位信息
分享文字
text
venueName
venueDescription
latitude
longitude
分享图文
text
venueName
venueDescription
latitude
longitude
imagePath
imageUrl
提醒:Pinterest必须用客户端才可分享,间接调用零碎客户端分享,所以无奈获取精确回调,点击调用Pinterest就默认提醒胜利。
分享图文
text
url
imagePath
imageUrl
Flickr
Flickr个别用来分享图文
分享图文
title
isPublic(可选,是否公开)
isFriend(可选,是否敌人可见)
isFamily(可选,是否家人可见)
safetyLevel(可选,安全级别)
contentType(可选,内容级别)
hidden(可选,可见级别)
text
imagePath/imageUrl
tags(可选)
Tumblr
Tumblr反对文字和图文分享,ShareSDK 3.9.2新增链接、音乐、视频分享
分享文本
ShareType(Platform.SHARE\_TEXT)
text
title
分享图文
ShareType(Platform.SHARE\_IMAGE)
text
url
imagePath
imageUrl
分享连贯
ShareType(Platform.SHARE\_WEBPAGE)
text(可选)
title(可选)
author(可选)
quote(可选)
imageUrl(可选)
url
分享音乐
ShareType(Platform.SHARE\_MUSIC)
title(可选)
musicUrl(音乐地址url)
filepath(limit 10MB))
分享视频
ShareType(Platform.SHARE\_VIDEO)
title(可选)
url(视频地址url))
filepath(limit 100MB))
Dropbox
实践上dropbox能够分享任何货色,只是以后的接口不提供间接分享文字的性能,图片分享则会被放到dropbox指定的图片目录下。dropbox个别用来分享文件,而不是图文分享
分享视频
filePath(/sdcard/视频.mp4)
ShareType(Platform.SHARE\_VIDEO)
分享图片
imagePath/imageUrl
分享文件
filePath
VK
VK反对分享文字和图文
分享文字链接
gropuId(可选,指定分享的组)
url
friendsOnly(可选,是否仅敌人可见)
text
latitude(可选)
longitude(可选)
分享图文链接
gropuId(可选,指定分享的组)
url
friendsOnly(可选,是否仅敌人可见)
text
imagePath
latitude(可选)
longitude(可选)
imageUrl
提醒:Instagram必须用客户端才可分享,间接调用零碎客户端分享,所以无奈获取精确回调,点击调用Instagram就默认提醒胜利。
分享图片
text(不显示)
ImagePath
imageUrl
分享视频
text(不显示)
FilePath(/sdcard/视屏文件)
ShareType(Platform.SHARE\_VIDEO)
Line
提醒:Line必须用客户端才可分享,间接调用零碎客户端分享,所以无奈获取精确回调,点击调用Line就默认提醒胜利。
Line反对分享文本或图片,但两者不能同时分享 参数阐明
分享文本
text
分享图片
imagePath
imageUrl
KakaoStory
提醒:调用零碎客户端分享,所以无奈返回精确回调,勾销分享也会提醒胜利回调。
分享链接(网络图片)
imageUrl
分享本地图片
imagePath
KakaoTalk
提醒:调用零碎客户端分享,所以无奈返回精确回调,勾销分享也会提醒胜利回调。ShareSDK的3.7.5 版本适配Kakao原生SDK具体能够点击这里查看
分享信息
text(文本)
分享图片
imagePath
imageUrl
提醒:调用零碎客户端分享,所以无奈返回精确回调,勾销分享也会提醒胜利回调。
分享文本
text
title(可选)
分享图片
imagePath
imageUrl
分享视频
filePath(视频本地sdcard地址)
关上聊天界面
address(联系人电话号码)
Instapaper
分享网页
url
title(可选)
text(可选)
FacebookMessenger
提醒:无奈返回精确回调,勾销分享也会提醒胜利回调。
分享图片
ShareType(Platform.SHARE\_IMAGE)
ImageUrl
imagePath
** 3.9.1及以上版本减少零碎分享性能,设置bypassApproval=true,既能够应用,零碎分享反对的分享内容如下: **
分享文本
ShareType(Platform.SHARE\_TEXT)
text
分享图片
ShareType(Platform.SHARE\_IMAGE)
imagePath
imageUrl
分享多图
ShareType(Platform.SHARE\_IMAGE)
imageArray
分享视频
ShareType(Platform.SHARE\_VIDEO)
filePath
Youtube
分享视频
FilePath("/sdcard/视频.mp4")
Telegram
提醒:调用零碎客户端分享,所以无奈返回精确回调,勾销分享也会提醒胜利回调。
分享文字
text
分享图片
imagePath("/sdcard/abc.png")
imageUrl("网路图片链接")
分享文本
ShareType(Platform.SHARE\_TEXT)
text("须要分享的内容")
title
Subreddit("分享的版块")
分享链接
ShareType(Platform.SHARE\_WEBPAGE)
text
title
url("分享的链接")
Subreddit("分享的版块")
分享图片
ShareType(Platform.SHARE\_IMAGE)
text
title
url("分享的链接")
Subreddit("分享的版块")
imageUrl("网路图片链接")
TikTok
分享多图
shareType(SHARE\_IMAGE)
imageArray(String[] AVATARS(多个或单个本地图片门路))
hashtags(参数为数组格局)
setActivity //适配9.0零碎
分享视频
shareType(SHARE\_VIDEO)
VideoPathArray(String[] AVATARS(多个或单个本地视频门路));
hashtags(参数为数组格局)
setActivity //适配9.0零碎
零碎平台
邮件
提醒:邮件调用的零碎默认的邮件客户端,没有精确回调,点击默认提醒胜利;
邮件分享调用手机上的邮件客户端,如果没有客户端,将不能分享邮件
分享文本
address
title
text
分享图文
address
title
text
imagePath
imageUrl
分享视频
FilePath("/sdcard/视频.mp4")
ShareType(Platform.SHARE\_VIDEO)
信息
提醒:信息调用的零碎默认的邮件客户端,没有精确回调,点击默认提醒胜利;
信息分短信和彩信,如果设置了题目或者图片,会间接当作彩信发送。发送信息的时候应用手机的信息软件
分享文本
address
title
text
分享图文
address
title
text
imagePath
imageUrl
分享视频
FilePath("/sdcard/视频.mp4")
ShareType(Platform.SHARE\_VIDEO)