帮助与文档

> >

Android 不同平台分享内容的详细说明

虽然ShareSDK尽可能屏蔽了不同社交平台间接口api差异,但是分享接口需要传递的差异依然会因平台而异,本文将以列表的形式展示不同平台的分享参数(ShareParams)的字段要求,以方便开发者使用时翻阅。 注意没有标明可选的就是必填参数,不能为null或者空字符串,另一种情况是例如有imageUrl、imagePath、imageData是三选一。

1、新浪微博

新浪微博支持分享文字、本地图片、网络图片 参数说明 text:140字符以内image:web分享ShareSDK不做限制直接提交给微博处理,微博客户端分享图片不能大于2M,仅支持JPEG、GIF、PNG格式 ;注:微博分享链接是将链接写到setText内:eg:setText(“分享文本 http://mob.com”);

分享文本 text
分享图文 text imagePath
imageUrl

如果imagePath和imageUrl同时存在,imageUrl将被忽略。

注意:分享本地视频必须用新浪微博客户端分享;

分享本地视频 setFilePath(“/sdcard/video.MP4”)

2、腾讯微博

腾讯微博支持分享文字、本地图片、网络图片和经纬度信息 参数说明 text:最多140个字字符 image:图片最大4M

分享文本 text latitude(可选) longitude(可选)
分享图文 text imagePath latitude(可选) longitude(可选)
imageUrl  ImageArray

2.5.0以后的版本新增分享多张图片的功能ImageArray。 由于腾讯微博分享网络图片并不属于高级接口,因此imageUrl优先级高于imagePath,这就是说,如果imagePath和imageUrl同时存在,imagePath将被忽略。

3、QQ空间

QQ空间支持分享文字和图文 参数说明 title:最多200个字符 text:最多600个字符
分享时一定要携带title、titleUrl、site、siteUrl,QQ空间本身不支持分享本地图片,因此如果想分享本地图片,图片会先上传到ShareSDK的文件服务器,得到连接以后才分享此链接。由于本地图片更耗流量,因此imageUrl优先级高于imagePath。 site是分享此内容的网站名称,仅在QQ空间使用;siteUrl是分享此内容的网站地址,仅在QQ空间使用;

分享视频 FilePth(“/sdcard/视频.mp4”) ShareType(platform.SHARE_VIDEO)
分享文本 title titleUrl text site siteUrl
发表说说 text imagePath site siteUrl
imageUrl
分享图文 title titleUrl text imagePath site siteUrl

(3.1.0版本之后,包含3.1.0)QQ空间绕过审核形式支持分享多图(BypassApproval=”true”),ImageArray String类型图片数组,可传手机本地图片路径和图片链接

绕过审核分享多图 text(可不传) imageArray

4、微信(好友、朋友圈、收藏)

绕过审核只对微信好友、微信朋友圈有效 微信分享如果是绕过审核(配置信息BypassApproval属性设置为true为绕过审核),微信朋友圈可以分享单张图片或者图片与文字一起分享,微信好友可以进行文字或者单张图片或者文件进行分享,分享回调不会正确回调。 不绕过审核,微信三个平台中,好友的功能最完整,朋友圈不能分享表情、文件和应用,收藏不能分享表情和应用,表格下以好友为例子: 参数说明 title:512Bytes以内 text:1KB以内 imageData:10M以内 imagePath:10M以内(传递的imagePath路径不能超过10KB) imageUrl:10KB以内 musicUrl:10KB以内 url:10KB以内 注意:微信分享分绕过审核和不绕过审核,不绕过审核必须保证微信后台配置的签名与您的app的签名一致,否则无法分享;

分享文本 shareType(Platform.SHARE_TEXT) title text
分享图片 shareType(Platform.SHARE_IMAGE) title 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_APPS) title text(朋友圈不显示此字段) imagePath  filePath(apk文件)  extInfo(应用信息脚本)
imageUrl
imageData
分享文件 shareType(Platform.SHARE_FILE) title text(朋友圈不显示此字段) imagePath filePath
imageUrl
imageData
分享表情 shareType(Platform.SHARE_EMOJI) title text(朋友圈不显示此字段) imagePath
imageUrl
imageData
分享小程序 shareType(Platform.SHARE_WXMINIPROGRAM) title url text imagePath
imageUrl
imageData

(3.1.0版本之后,包含3.1.0)微信和朋友圈绕过审核形式支持分享多图(BypassApproval=”true”),ImageArray String类型图片数组,可传手机本地图片路径和图片链接

绕过审核分享多图 text(可不传) imageArray

微信并无实际的分享网络图片和分享bitmap的功能,如果设置了网络图片,此图片会先下载会本地,之后再当作本地图片分享,因此延迟较大。bitmap则好一些,但是由于bitmap并不知道图片的格式,因此都会被当作png编码,再提交微信客户端。此外,SHARE_EMOJI支持gif文件,但是如果使用imageData,则默认只是提交一个png图片,因为bitmap是静态图片。
注意:分享小程序目前只支持分享微信好友,分享小程序必须在sharesdk.xml文件中配置上特殊参数,如下所示:userName是小程序的原始ID,path是小程序内的页面路径;而且必须保证微信开放平台与微信公众/小程序绑定才可以分享;

<Wechat
Id=”4″
SortId=”4″
AppId=”wx4868b35061f87885″
AppSecret=”64020361b8ec4c99936c0e3999a9f249″
userName=”gh_afb25ac019c9″
path=”/page/API”
BypassApproval=”false”
Enable=”true” />

5、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

(3.1.0版本之后,包含3.1.0)QQ绕过审核形式支持分享多图(BypassApproval=”true”),ImageArray String类型图片数组,可传手机本地图片路径和图片链接

绕过审核分享多图 text(可不传) imageArray

6、Facebook

Facebook支持文字和图文分享 分享参数说明 image:至少200×200像素

分享文本 text
分享图文 text imagePath
imageUrl
分享网页链接 shareType(Platform.SHARE_WEBPAGE) text Url
imageUrl

注:Facebook分享链接,只能使用ImageUrl,设置ImagePath无法显示图片
Fb客户端分享类型如下所示:

分享网页 Url
分享图片 imagePath
imageUrl
分享视频 FilePth(“/sdcard/视频.mp4”)
分享多图 ImagePath(“/sdcard/图片.jpg”) setImageArray(AVATARS)

注意:分享多图内是传一个string数组,内部必须传sdcard目录下的本地图片,而已图片不能相同

7、Twitter

Twitter支持文字和图文分享

分享视频 FilePth(“/sdcard/视频.mp4”) ShareType(platform.SHARE_VIDEO)
分享文本 text
分享图文 text imagePath
imageUrl
ImageArray(分享多图)

8、人人网

人人网支持分享文字和图文 参数说明 title:最多30个字符 text:最多200个字符 comment:最多500个字符 image:支持bmp,png,gif,jpg格式

分享文本 url comment
分享图文 url imagePath comment
imageUrl

与QQ空间一样,人人网不直接分享本地图片,如遇本地图片,会先将其发送到ShareSDK的文件服务器以后取得网络地址,再行分享

9、开心网

开心网可以分享文字和图片,其中图片可以支持网络图片和本地图片 参数说明 text:最多140个字符或者280个英文字母字符 image:最大10M,支持jpg/jpeg/gif/png/bmp格式

分享文本 text
分享图文 text imagePath
imageUrl

10、邮件

邮件分享调用手机上的邮件客户端,如果没有客户端,将不能分享邮件

分享文本 address title text
分享图文 address title text imagePath  imageUrl
分享视频 FilePath(“/sdcard/视频.mp4”) ShareType(Platform.SHARE_VIDEO)

11、信息

信息分短信和彩信,如果设置了标题或者图片,会直接当作彩信发送。发送信息的时候使用手机的信息软件

分享文本 address title text
分享图文 address title text imagePath  imageUrl
分享视频 FilePath(“/sdcard/视频.mp4”) ShareType(Platform.SHARE_VIDEO)

12、豆瓣

豆瓣支持分享文字和图文 参数说明 image:支持JPEG,GIF,PNG格式,最大3M

(注:近期豆瓣api正在维护,ApiKey暂时不对个人开放申请,如有企业合作相关要求,请发邮件到bd-team@douban.com,将有负责同事尽快与您联系)

分享文本 text
分享图文 text imagePath /imageUrl

 

13、有道云笔记

有道云笔记事实上不是分享,而是创建一个笔记,当前可以发图片和图文笔记:

分享文本 title notebook(可选) address(可选) text url(可选)
分享图文 title notebook(可选) address(可选) text imagePath url(可选)
imageUrl

14、印象笔记

印象笔记可以支持文字和图文的分享,也支持利用客户端分享,只要在ShareSDL.xml中配置就行

分享文字 title notebook(可选) stack(可选) publish(可选,表示是否公开) text tags(可选)
分享图文 title notebook(可选) stack(可选) publish(可选,表示是否公开) text imagePath/imageUrl tags(可选)
分享视频 text(可选) FilePath ShareType(Platform.SHARE_VIDEO)

15、Linked-in

Linked-in支持分享文字或图文 分享参数说明 title:最多200个byte text:最多256个byte comment:最多700个byte

分享文字 title titleUrl text comment(可选)
分享图文 title titleUrl text imagePath comment(可选)
imageUrl

Linked-in本身并不支持分享本地图片,因此本地图片会先上传到ShareSDK文件服务器以后,再将返回图片链接进行分享。由于上传图片更耗流量,因此imageUrl的优先级高于imagePath。

16、Google+

Google+支持文字和图片分享

分享视频 FilePath(“/sdcard/视频.mp4”) ShareType(Platform.SHARE_VIDEO)
分享文字 text
分享图文 text imagePath
imageUrl

17、FourSquare

FourSquare可以分享图文,但是分享时需要携带位置信息

分享文字 text venueName venueDescription latitude longitude
分享图文 text venueName venueDescription latitude longitude imagePath/imageUrl

18、Pinterest

Pinterest使用客户端分享

分享图文 text url imagePath
imageUrl

19、Flickr

Flickr一般用来分享图文

分享图文 title isPublic(可选,是否公开) isFriend(可选,是否朋友可见) isFamily(可选,是否家人可见) safetyLevel(可选,安全级别) contentType(可选,内容级别) hidden(可选,可见级别) text imagePath/imageUrl tags(可选)

20、Tumblr

Tumblr支持文字和图文分享

分享文本 text title
分享图文 text url imagePath
imageUrl

21、Dropbox

理论上dropbox可以分享任何东西,只是当前的接口不提供直接分享文字的功能,图片分享则会被放到dropbox指定的图片目录下。dropbox一般用来分享文件,而不是图文分享

分享视频 filePath(/sdcard/视频.mp4) ShareType(Platform.SHARE_VIDEO)
分享图片 imagePath/imageUrl
分享文件 filePath

22、VK

VK支持分享文字和图文

分享文字 gropuId(可选,指定分享的组) url friendsOnly(可选,是否仅朋友可见) text latitude(可选) longitude(可选)
分享图文 gropuId(可选,指定分享的组) url friendsOnly(可选,是否仅朋友可见) text imagePath latitude(可选) longitude(可选)
imageUrl

23、Instagram

分享图片 text(不显示) ImagePath
imageUrl
分享视频 text(不显示) FilePath(/sdcard/视屏文件)

24、易信(好友和朋友圈)

易信的接口与微信的类似,但是易信暂时不支持分享文件和表情 参数说明 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

25、明道

明道支持分享文本或图文 参数说明 text:最多为2080个字符

分享文本 text url
分享网页 text url imagePath
imageUrl

明道本身只支持分享网络图片,如果打算分享imagePath,需要先将文件上传到ShareSDK的文件服务器,之后再将得到的地址当作网络图片分享。由于imagePath更耗流量,因此imageUrl优先级更高

26、Line

Line支持分享文本或图片,但两者不能同时分享 参数说明

分享文本 text
分享图片 imagePath
imageUrl

27、KakaoStory

分享图文(网络图片) text site title(可选) comment(可选) imageUrl(可选)
分享本地图片 imagePath text title

28、KakaoTalk

注:2.5.9以后版本集成kakao升级说明

分享信息 text(文本) site(应用按钮名称) url(网站连接,分享的连接的域名,需要在kakao开发者平台进行配置) imageUrl(图片链接)

29、WhatsApp

分享文本 text title(可选)
分享图片 imagePath  imageUrl
分享视频 filePath(视频本地sdcard地址)
打开聊天界面 address(联系人电话号码)

30、Instapaper

分享网页 url title(可选) text(可选)

31、FacebookMessenger

分享图片 address(如:-123456@chat.facebook.com) imagePath imageUrl

32、Pocket

分享网页 url title(可选) tags(可选)

33、支付宝

注意:生活圈只支持分享网页

分享文本 shareType(SHARE_TEXT) title text
分享图片 shareType(SHARE_IMAGE) title text imagePath
imageUrl
imageData
分享网页 shareType(SHARE_WEBPAGE) title text imagePath url(消息点击后打开的页面)
imageUrl
imageData

34、钉钉

分享文本 shareType(SHARE_TEXT) title text
分享图片 shareType(SHARE_IMAGE) title text imagePath
imageUrl
imageData
分享网页 shareType(SHARE_WEBPAGE) title text imagePath url(消息点击后打开的页面)
imageUrl
imageData

35、美拍

分享视频 FilePath(/sdcard/视频.mp4)
分享图片 FilePath(/sdcard/图片.jpg)

36、Yuotube

分享视频 FilePath(“/sdcard/视频.mp4”)

37、Telegram

ImageArray String类型图片数组,可传手机本地图片路径和图片链接

分享图文 text(可不传) imagePath
imageUrl
imageData
imageArray(多图分享)
2 1