> >

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

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

1、新浪微博

新浪微博支持分享文字、本地图片、网络图片和经纬度信息 新浪微博使用客户端分享不会正确回调 参数说明 text:140字符以内image:web分享ShareSDK不做限制直接提交给微博处理,微博客户端分享图片不能大于2M,仅支持JPEG、GIF、PNG格式 latitude:有效范围:-90.0到+90.0,+表示北纬 longitude:有效范围:-180.0到+180.0,+表示东经 .注:微博分享链接是将链接写到setText内:eg:setText(“分享文本 http://mob.com”);

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

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

注意:ShareSDK2.8.3的版本android针对微博升级api做了处理;处理后应用内分享(web分享)必须用setUrl分享链接(并且分享的链接必须与微博后台配置的安全域名配置的链接一致)才可以正常分享

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个字符

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

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

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

微信并无实际的分享网络图片和分享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个字符

分享图片 ImageUrl
imagePath
分享链接 title titleUrl text imagePath
imageUrl
分享音频 title titleUrl text imagePath musicUrl
imageUrl

QQ分享图文和音乐,在PC版本的QQ上可能只看到一条连接,因为PC版本的QQ只会对其白名单的连接作截图,如果不在此名单中,则只是显示连接而已. 如果只分享图片在PC端看不到图片的,只会显示null,在手机端会显示图片和null字段。

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″)

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

11、信息

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

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

12、搜狐微博

搜狐微博支持分享文字和图文

分享文本 text
分享图文 text imagePath

13、网易微博

网易微博支持分享文字和图文 参数说明 text:最大163个字符 image:大小在1K到2M以内,支持jpg、png、bmp、gif格式

分享文本 text
分享图文 text imagePath

14、豆瓣

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

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

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

 

15、有道云笔记

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

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

16、搜狐随身看

搜狐随身看只能收藏一条url:

分享网页 url

17、印象笔记

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

分享文字 title notebook(可选) stack(可选) publish(可选,表示是否公开) text tags(可选)
分享图文 title notebook(可选) stack(可选) publish(可选,表示是否公开) text imagePath/imageUrl tags(可选)

18、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。

19、Google+

Google+支持文字和图片分享

分享文字 text
分享图文 text imagePath
imageUrl

20、FourSquare

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

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

21、Pinterest

Pinterest使用客户端分享

分享图文 text url imagePath
imageUrl

22、Flickr

Flickr一般用来分享图文

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

23、Tumblr

Tumblr支持文字和图文分享

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

24、Dropbox

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

分享图片 imagePath/imageUrl
分享文件 filePath

25、VK

VK支持分享文字和图文

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

26、Instagram

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

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

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

28、明道

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

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

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

29、Line

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

分享文本 text
分享图片 imagePath
imageUrl

30、KakaoStory

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

31、KakaoTalk

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

32、WhatsApp

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

33、蓝牙

(蓝牙分享2.7.1版本后删除)

分享文件    分享图片 filePath    imageUrl

34、Instapaper

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

35、FacebookMessenger

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

36、Pocket

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

37、支付宝

注意:生活圈只支持分享网页
分享文本 shareType(SHARE_TEXT) title text
分享图片 shareType(SHARE_IMAGE) title text imagePath
imageUrl
imageData
分享网页 shareType(SHARE_WEBPAGE) title text imagePath url(消息点击后打开的页面)
imageUrl
imageData

38、钉钉

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

39、美拍

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

40、Yuotube

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