尽管 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(“ 文本 ”)
linkcard
腾讯微博
腾讯微博反对分享文字、本地图片、网络图片和经纬度信息 参数阐明 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 是小程序内的页面门路;而且必须保障微信开放平台与微信公众 / 小程序绑定才能够分享;
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
钉钉
提醒:必须须要客户端才能够分享
分享文本 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(本地视频绝对路径分享)
国外平台
Facebook
分享参数阐明 image:至多 200×200 像素
注: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
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 必须用客户端才可分享,间接调用零碎客户端分享,所以无奈获取精确回调,点击调用 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 必须用客户端才可分享,间接调用零碎客户端分享,所以无奈获取精确回调,点击调用 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
WhatsApp
提醒:调用零碎客户端分享,所以无奈返回精确回调,勾销分享也会提醒胜利回调。
分享文本 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(“ 网路图片链接 ”)
Reddit
分享文本 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)