NSMutableDictionary+SSDKShare.h 57 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203
  1. //
  2. // NSMutableDictionary+SSDKShare.h
  3. // ShareSDK
  4. //
  5. // Created by Max on 2018/5/8.
  6. // Copyright © 2018年 掌淘科技. All rights reserved.
  7. //
  8. #import <Foundation/Foundation.h>
  9. #import <UIKit/UIKit.h>
  10. #import <ShareSDK/SSDKTypeDefine.h>
  11. /// <#Description#>
  12. @interface NSMutableDictionary (SSDKShare)
  13. /**
  14. 设置分享标识
  15. @param flags 标识
  16. */
  17. - (void)SSDKSetShareFlags:(NSArray <NSString *>*)flags;
  18. /**
  19. * 设置分享参数
  20. *
  21. * @param text 文本
  22. * @param images 图片集合,传入参数可以为单张图片信息,也可以为一个NSArray,数组元素可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。如: @"http://www.mob.com/images/logo_black.png" 或 @[@"http://www.mob.com/images/logo_black.png"]
  23. * @param url 网页路径/应用路径
  24. * @param title 标题
  25. * @param type 分享类型
  26. */
  27. - (void)SSDKSetupShareParamsByText:(NSString *)text
  28. images:(id)images
  29. url:(NSURL *)url
  30. title:(NSString *)title
  31. type:(SSDKContentType)type;
  32. /// 设置系统分享-相册图片/视频分享参数
  33. /// @param imageAsset 图片
  34. /// @param videoAsset 视频
  35. - (void)SSDKSetupShareParamsByImageAsset:(NSArray *)imageAsset
  36. videoAsset:(id)videoAsset
  37. completeHandle:(void(^)(BOOL complete))completeHandle;
  38. #pragma mark - Wechat
  39. /**
  40. * 设置微信分享参数
  41. *
  42. * @param text 文本
  43. * @param title 标题
  44. * @param url 分享链接
  45. * @param thumbImage 缩略图,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage
  46. * @param image 图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage
  47. * @param musicFileURL 音乐文件链接地址
  48. * @param extInfo 扩展信息
  49. * @param fileData 文件数据,可以为NSData、UIImage、NSString、NSURL(文件路径)、SSDKData、SSDKImage
  50. * @param emoticonData 表情数据,可以为NSData、UIImage、NSURL(文件路径)、SSDKData、SSDKImage
  51. * @param fileExtension 源文件后缀名
  52. * @param sourceFileData 源文件数据,可以为NSData、NSString、NSURL(文件路径)、SSDKData
  53. * @param type 分享类型,支持SSDKContentTypeText、SSDKContentTypeImage、SSDKContentTypeWebPage、SSDKContentTypeApp、SSDKContentTypeAudio和SSDKContentTypeVideo
  54. * @param platformSubType 平台子类型,只能传入其中一个
  55. *
  56. * 分享文本时:
  57. * 设置type为SSDKContentTypeText, 并填入text参数
  58. *
  59. * 分享图片时:
  60. * 设置type为SSDKContentTypeImage, 非gif图片时:填入title和image参数,如果为gif图片则需要填写title和emoticonData参数
  61. *
  62. * 分享网页时:
  63. * 设置type为SSDKContentTypeWebPage, 并设置text、title、url以及thumbImage参数,如果尚未设置thumbImage则会从image参数中读取图片并对图片进行缩放操作。
  64. *
  65. * 分享应用时:
  66. * 设置type为SSDKContentTypeApp,并设置text、title、extInfo(可选)以及fileData(可选)参数。
  67. *
  68. * 分享音乐时:
  69. * 设置type为SSDKContentTypeAudio,并设置text、title、url以及musicFileURL(可选)参数。
  70. *
  71. * 分享视频时:
  72. * 设置type为SSDKContentTypeVideo,并设置text、title、url参数
  73. *
  74. * 分享文件时:
  75. * 设置type为SSDKContentTypeFile(例如.mp3、.mp4、.pdf、.docx的分享),设置title、sourceFileExtension、sourceFileData,以及thumbImage参数,如果尚未设置thumbImage则会从image参数中读取图片并对图片进行缩放操作参数
  76. */
  77. - (void)SSDKSetupWeChatParamsByText:(NSString *)text
  78. title:(NSString *)title
  79. url:(NSURL *)url
  80. thumbImage:(id)thumbImage
  81. image:(id)image
  82. musicFileURL:(NSURL *)musicFileURL
  83. extInfo:(NSString *)extInfo
  84. fileData:(id)fileData
  85. emoticonData:(id)emoticonData
  86. sourceFileExtension:(NSString *)fileExtension
  87. sourceFileData:(id)sourceFileData
  88. type:(SSDKContentType)type
  89. forPlatformSubType:(SSDKPlatformType)platformSubType;
  90. /**
  91. v4.1.2 为微信小程序分享增加
  92. @param title 标题
  93. @param description 详细说明
  94. @param webpageUrl 网址(6.5.6以下版本微信会自动转化为分享链接 必填)
  95. @param path 跳转到页面路径
  96. @param thumbImage 缩略图 , 旧版微信客户端(6.5.8及以下版本)小程序类型消息卡片使用小图卡片样式 要求图片数据小于32k
  97. @param hdThumbImage 高清缩略图,建议长宽比是 5:4 ,6.5.9及以上版本微信客户端小程序类型分享使用 要求图片数据小于128k
  98. @param userName 小程序的userName (必填)
  99. @param withShareTicket 是否使用带 shareTicket 的转发
  100. @param type 分享小程序的版本(0-正式,1-开发,2-体验)
  101. @param platformSubType 分享自平台 微信小程序暂只支持 SSDKPlatformSubTypeWechatSession(微信好友分享)
  102. */
  103. - (void)SSDKSetupWeChatMiniProgramShareParamsByTitle:(NSString *)title
  104. description:(NSString *)description
  105. webpageUrl:(NSURL *)webpageUrl
  106. path:(NSString *)path
  107. thumbImage:(id)thumbImage
  108. hdThumbImage:(id)hdThumbImage
  109. userName:(NSString *)userName
  110. withShareTicket:(BOOL)withShareTicket
  111. miniProgramType:(NSUInteger)type
  112. forPlatformSubType:(SSDKPlatformType)platformSubType;
  113. #pragma mark - QQ
  114. /**
  115. * 设置QQ分享参数
  116. *
  117. * @param text 分享内容
  118. * @param title 分享标题
  119. * @param url 分享链接(如果分享类型为音频/视频时,应该传入音频/视频的网络URL地址)
  120. [特别说明:分享视频到QZone时,视频为网络视频,请传入视频网络URL地址;视频为本地视频的,请传入来源于手机系统相册的相关的Asset URL地址]
  121. * @param audioFlashURL 分享音频时缩略图播放源,仅平台子类型为SSDKPlatformSubTypeQQFriend,且分享类型为Audio时生效
  122. * @param videoFlashURL 分享视频时缩略图播放源,仅平台子类型为SSDKPlatformSubTypeQQFriend,且分享类型为Video时生效
  123. * @param thumbImage 缩略图,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage
  124. * @param images 图片集合,传入参数可以为单张图片信息,也可以为一个NSArray,数组元素可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage
  125. QQ会采用首张图片,QZone则支持图片数组
  126. * @param type 分享类型, 仅支持Text、Image、WebPage、Audio、Video类型
  127. * @param platformSubType 平台子类型,只能传入SSDKPlatformSubTypeQZone或者SSDKPlatformSubTypeQQFriend其中一个
  128. */
  129. - (void)SSDKSetupQQParamsByText:(NSString *)text
  130. title:(NSString *)title
  131. url:(NSURL *)url
  132. audioFlashURL:(NSURL *)audioFlashURL
  133. videoFlashURL:(NSURL *)videoFlashURL
  134. thumbImage:(id)thumbImage
  135. images:(id)images
  136. type:(SSDKContentType)type
  137. forPlatformSubType:(SSDKPlatformType)platformSubType;
  138. /**
  139. v4.3.0 为QQ平台支持小程序分享增加,使用小程序分享 请在白名单中(LSApplicationQueriesSchemes)添加mqqopensdkminiapp
  140. @param title 标题
  141. @param description 详细说明
  142. @param webpageUrl 网址
  143. @param hdThumbImage 高清缩略图
  144. @param miniAppID 必填,小程序的AppId(注:必须在QQ互联平台中,将该小程序与分享的App绑定)
  145. @param miniPath 必填,小程序的展示路径
  146. @param miniWebpageUrl 必填,兼容低版本的网页链接
  147. @param miniProgramType 非必填,小程序的类型,默认正式版(3),可选测试版(1)、预览版(4)
  148. @param platformSubType 分享自平台 小程序暂只支持 SSDKPlatformSubTypeQQFriend(QQ好友分享)
  149. */
  150. - (void)SSDKSetupQQMiniProgramShareParamsByTitle:(NSString *)title
  151. description:(NSString *)description
  152. webpageUrl:(NSURL *)webpageUrl
  153. hdThumbImage:(id)hdThumbImage
  154. miniAppID:(NSString *)miniAppID
  155. miniPath:(NSString *)miniPath
  156. miniWebpageUrl:(NSString *)miniWebpageUrl
  157. miniProgramType:(NSUInteger)miniProgramType
  158. forPlatformSubType:(SSDKPlatformType)platformSubType;
  159. - (void)SSDKSetupQQParamsByText:(NSString *)text
  160. title:(NSString *)title
  161. url:(NSURL *)url
  162. thumbImage:(id)thumbImage
  163. image:(id)image
  164. type:(SSDKContentType)type
  165. forPlatformSubType:(SSDKPlatformType)platformSubType __deprecated_msg("discard form v4.2.0");
  166. #pragma mark - SinaWeibo
  167. /*
  168. 设置新浪微博分享参数, linkCard分享模式必要参数为 text,title,image,url,type,其中image仅支持网络连接,type为webpage
  169. @param text 文本
  170. @param title 标题
  171. @param images 图片集合,传入参数可以为单张图片信息,也可以为一个NSArray,数组元素可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。如: @"http://www.mob.com/images/logo_black.png" 或 @[@"http://www.mob.com/images/logo_black.png"]
  172. @param video 分享视频, 本地路径。
  173. @param url 分享链接
  174. @param latitude 纬度
  175. @param longitude 经度
  176. @param objectID 对象ID,标识系统内内容唯一性,应传入系统中分享内容的唯一标识,没有时可以传入nil
  177. @param isShareToStory 是否分享到故事
  178. @param type 分享类型,仅支持Text、Image、WebPage 类型
  179. 设置 SSDKEnableSinaWeiboAPIShare 使用API进行分享 但text中需要附 安全域 安全域在新浪微博开放平台设置
  180. @param dataDictionary 数据存储字典 如果传入nil将新建
  181. */
  182. - (void)SSDKSetupSinaWeiboShareParamsByText:(NSString *)text
  183. title:(NSString *)title
  184. images:(id)images
  185. video:(NSString *)video
  186. url:(NSURL *)url
  187. latitude:(double)latitude
  188. longitude:(double)longitude
  189. objectID:(NSString *)objectID
  190. isShareToStory:(BOOL)shareToStory
  191. type:(SSDKContentType)type;
  192. /**
  193. 新浪微博设置linkcard分享方式
  194. @param text 描述
  195. @param cardTitle 卡片标题
  196. @param cardSummary 卡片摘要
  197. @param images 图片,只支持网络图片
  198. @param url 跳转链接
  199. */
  200. - (void)SSDKSetupSinaWeiboLinkCardShareParamsByText:(NSString *)text
  201. cardTitle:(NSString *)cardTitle
  202. cardSummary:(NSString *)cardSummary
  203. images:(id)images
  204. url:(NSURL *)url;
  205. #pragma mark - Facebook
  206. /**
  207. * 设置Facebook分享参数
  208. *
  209. * @param text 分享内容
  210. 分享类型为Text类型时,作为文字主体内容
  211. 分享类型为WebPage类型时,作为连接描述
  212. * @param image 图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage
  213. 分享类型为Image类型时,若使用客户端分享,可传入 单张/多张 的 本地/网络 图片;如果不使用客户端分享,仅支持单张的本地/网络图片
  214. 分享类型为App(应用邀请)时 只支持网络图片链接
  215. *【Facebook通过客户端分享图片,可不需依赖任何权限;否则需要申请publish_actions权限】*
  216. 分享类型为WebPage类型时,无论是否使用客户端,仅支持单张的网络图片
  217. * @param url 链接
  218. 分享类型为WebPage类型时,为链接地址
  219. [如果分享的连接是AppStore/GooglePlay/Facebook个人/公共主页,所对应的图片,标题,描述等参数可能不会生效,而实际生效的是FB通过爬虫网络根据连接搜刮而来的信息]
  220. 分享类型为Video类型时,需传入视频地址且但必须是相册地址
  221. * @param title 链接标题
  222. 分享类型为WebPage类型时,为链接标题
  223. * @param urlName 连接名称
  224. 分享类型为WebPage类型时,为链接名称,仅在非客户端分享时生效
  225. * @param attachementUrl 附件链接(附加的媒体文件(SWF 或 MP3)的网址。如果是 SWF,还必须指定image以提供视频的缩略图)
  226. 分享类型为WebPage类型时,为链,仅在非客户端分享时生效
  227. * @param type 分享类型
  228. 当使用客户端分享时,支持Image、WebPage,Video类型
  229. 当不适用客户端分享是,支持Text、Image、WebPage、App(应用邀请)类型
  230. */
  231. - (void)SSDKSetupFacebookParamsByText:(NSString *)text
  232. image:(id)image
  233. url:(NSURL *)url
  234. urlTitle:(NSString *)title
  235. urlName:(NSString *)urlName
  236. attachementUrl:(NSURL *)attachementUrl
  237. type:(SSDKContentType)type __deprecated_msg("discard form v4.2.0");
  238. /**
  239. * 设置Facebook分享参数
  240. *
  241. * @param text 分享内容
  242. 分享类型为Text类型时,作为文字主体内容
  243. 分享类型为WebPage类型时,作为连接描述
  244. * @param image 图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage
  245. 分享类型为Image类型时,若使用客户端分享,可传入 单张/多张 的 本地/网络 图片;如果不使用客户端分享,仅支持单张的本地/网络图片
  246. 分享类型为App(应用邀请)时 只支持网络图片链接
  247. *【Facebook通过客户端分享图片,可不需依赖任何权限;否则需要申请publish_actions权限】*
  248. 分享类型为WebPage类型时,无论是否使用客户端,仅支持单张的网络图片
  249. * @param url 链接
  250. 分享类型为WebPage类型时,为链接地址
  251. [如果分享的连接是AppStore/GooglePlay/Facebook个人/公共主页,所对应的图片,标题,描述等参数可能不会生效,而实际生效的是FB通过爬虫网络根据连接搜刮而来的信息]
  252. 分享类型为Video类型时,需传入视频地址且但必须是相册地址
  253. * @param title 链接标题
  254. 分享类型为WebPage类型时,为链接标题
  255. * @param urlName 连接名称
  256. 分享类型为WebPage类型时,为链接名称,仅在非客户端分享时生效
  257. * @param attachementUrl 附件链接(附加的媒体文件(SWF 或 MP3)的网址。如果是 SWF,还必须指定image以提供视频的缩略图)
  258. 分享类型为WebPage类型时,为链,仅在非客户端分享时生效
  259. * @param hashtag 话题标签
  260. 开发者指定的话题标签,将添加至分享内容中。用户可决定是否在分享对话框中移除这种话题标签。话题标签应包含#符号,例如#facebook,不能是纯数字
  261. * @param quote 话题标签
  262. 随分享的链接一同显示的引文由用户自行高亮选择,也可由开发者预先定义(例如文章的醒目引文) 此参数只适用于链接分享类型
  263. * @param shareType 包含facebooksdk
  264. * @param type 分享类型
  265. 当使用客户端分享时,支持Image、WebPage,Video类型
  266. 当不适用客户端分享是,支持Text、Image、WebPage、App(应用邀请)类型
  267. */
  268. - (void)SSDKSetupFacebookParamsByText:(NSString *)text
  269. image:(id)image
  270. url:(NSURL *)url
  271. urlTitle:(NSString *)title
  272. urlName:(NSString *)urlName
  273. attachementUrl:(NSURL *)attachementUrl
  274. hashtag:(NSString *)hashtag
  275. quote:(NSString *)quote
  276. shareType:(SSDKFacebookShareType)shareType
  277. type:(SSDKContentType)type;
  278. /**
  279. * 设置Facebook分享参数
  280. *
  281. * @param text 分享内容
  282. 分享类型为Text类型时,作为文字主体内容
  283. 分享类型为WebPage类型时,作为连接描述
  284. * @param image 图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage
  285. 分享类型为Image类型时,若使用客户端分享,可传入 单张/多张 的 本地/网络 图片;如果不使用客户端分享,仅支持单张的本地/网络图片
  286. 分享类型为App(应用邀请)时 只支持网络图片链接
  287. *【Facebook通过客户端分享图片,可不需依赖任何权限;否则需要申请publish_actions权限】*
  288. 分享类型为WebPage类型时,无论是否使用客户端,仅支持单张的网络图片
  289. * @param url 链接
  290. 分享类型为WebPage类型时,为链接地址
  291. [如果分享的连接是AppStore/GooglePlay/Facebook个人/公共主页,所对应的图片,标题,描述等参数可能不会生效,而实际生效的是FB通过爬虫网络根据连接搜刮而来的信息]
  292. 分享类型为Video类型时,需传入视频地址且但必须是相册地址
  293. * @param title 链接标题
  294. 分享类型为WebPage类型时,为链接标题
  295. * @param urlName 连接名称
  296. 分享类型为WebPage类型时,为链接名称,仅在非客户端分享时生效
  297. * @param attachementUrl 附件链接(附加的媒体文件(SWF 或 MP3)的网址。如果是 SWF,还必须指定image以提供视频的缩略图)
  298. 分享类型为WebPage类型时,为链,仅在非客户端分享时生效
  299. * @param hashtag 话题标签
  300. 开发者指定的话题标签,将添加至分享内容中。用户可决定是否在分享对话框中移除这种话题标签。话题标签应包含#符号,例如#facebook,不能是纯数字
  301. * @param quote 话题标签
  302. 随分享的链接一同显示的引文由用户自行高亮选择,也可由开发者预先定义(例如文章的醒目引文) 此参数只适用于链接分享类型
  303. * @param sortShareTypes 设置分享优先级顺序,如sheet->native->web, 传@[@(SSDKFacebookShareTypeShareSheet),@(SSDKFacebookShareTypeNative),@(SSDKFacebookShareTypeBrowser) ]或sheet->web->native,@[@(SSDKFacebookShareTypeShareSheet),@(SSDKFacebookShareTypeBrowser),@(SSDKFacebookShareTypeNative) ],如果数组的最后一个元素为-1, 则在分享链结束仍然是分享失败的情况下,会默认执行接下来内部的优先级顺序,否则就停止执行
  304. * @param type 分享类型
  305. 当使用客户端分享时,支持Image、WebPage,Video类型
  306. 当不适用客户端分享是,支持Text、Image、WebPage、App(应用邀请)类型
  307. */
  308. - (void)SSDKSetupFacebookParamsByText:(NSString *)text
  309. image:(id)image
  310. url:(NSURL *)url
  311. urlTitle:(NSString *)title
  312. urlName:(NSString *)urlName
  313. attachementUrl:(NSURL *)attachementUrl
  314. hashtag:(NSString *)hashtag
  315. quote:(NSString *)quote
  316. sortShareTypes:(NSArray <NSNumber *>*)sortShareTypes
  317. type:(SSDKContentType)type;
  318. /**
  319. Facebook 分享参数 SSDKSetupFacebookParamsByText:image:url:urlTitle:urlName:attachementUrl:hashtag:quote:shareType:type的扩展
  320. imageAsset 设置分享图片的PHAsset,为一个数组
  321. videoAsset 设置分享视频的PHAsset,或localIdentifier
  322. 此方法可以将图片与视频的分享内容改为PHAsset 或localIdentifier
  323. */
  324. - (void)SSDKSetupFacebookParamsByImagePHAsset:(NSArray*)imageAsset
  325. videoPHAsset:(id)videoAsset;
  326. #pragma mark - Facebook Messenger
  327. /**
  328. * 设置Facebook Messenger分享参数
  329. *
  330. * @param image 分享图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。
  331. * @param audio 分享音频, 可以为NSData、NSString、NSURL(文件路径)、SSDKData。
  332. * @param video 分享视频, 可以为NSData、NSString、NSURL(文件路径)、SSDKData。
  333. * @param type 分享类型,仅支持Image、Audio、Video
  334. */
  335. - (void)SSDKSetupFacebookMessengerParamsByImage:(id)image
  336. gif:(id)gif
  337. audio:(id)audio
  338. video:(id)video
  339. type:(SSDKContentType)type;
  340. /**
  341. 设置Facebook Messenger分享参数 WebPage类型时 image参数 仅支持单张网络图片
  342. @since ver 3.6.0
  343. @param title WebPage类型 标题
  344. @param url WebPage类型 网址
  345. @param text WebPage类型 链接的引用说明
  346. @param images 分享图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。NSArray 图片数组
  347. WebPage类型仅支持单张 网络图片
  348. @param gif 分享GIF图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。
  349. @param audio 分享音频, 可以为NSData、NSString、NSURL(文件路径)、SSDKData。
  350. @param video 分享视频, 可以为NSData、NSString、NSURL(文件路径)、SSDKData。
  351. @param type 分享类型,支持Image、Audio、Video WebPage
  352. */
  353. - (void)SSDKSetupFacebookMessengerParamsByTitle:(NSString *)title
  354. url:(NSURL *)url
  355. quoteText:(NSString *)text
  356. images:(id)images
  357. gif:(id)gif
  358. audio:(id)audio
  359. video:(id)video
  360. type:(SSDKContentType)type;
  361. #pragma mark - Twitter
  362. /**
  363. 设置Twitter分享参数
  364. @param text 分享内容
  365. @param images 分享图片列表,传入参数可以为单张图片信息,也可以为一个NSArray,数组元素可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。如: @"http://www.mob.com/images/logo_black.png" 或 @[@"http://www.mob.com/images/logo_black.png"]
  366. @param video 本地文件地址
  367. @param latitude 地理位置,纬度
  368. @param longitude 地理位置,经度
  369. @param type 分享类型,仅支持Text、Image、Video类型
  370. */
  371. - (void)SSDKSetupTwitterParamsByText:(NSString *)text
  372. images:(id)images
  373. video:(NSURL*)video
  374. latitude:(double)latitude
  375. longitude:(double)longitude
  376. type:(SSDKContentType)type;
  377. - (void)SSDKSetupTwitterParamsByText:(NSString *)text
  378. images:(id)images
  379. latitude:(double)latitude
  380. longitude:(double)longitude
  381. type:(SSDKContentType)type __deprecated_msg("Discard form v4.2.0, using \"SSDKSetupTwitterParamsByText:images:video:latitude:longitude:type:\" instead.");
  382. - (void)SSDKSetupTwitterParamsByText:(NSString *)text
  383. video:(NSURL*)video
  384. latitude:(double)latitude
  385. longitude:(double)longitude
  386. tag:(NSString *)str __deprecated_msg("Discard form v4.2.0, using \"SSDKSetupTwitterParamsByText:images:video:latitude:longitude:type:\" instead.");
  387. #pragma mark - Instagram
  388. /**
  389. * 设置Instagram分享参数
  390. *
  391. * @param image 分享图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage,仅在type为Image时有效。
  392. * @param point 分享菜单的显示位置,仅用于iPad版
  393. */
  394. - (void)SSDKSetupInstagramByImage:(id)image
  395. menuDisplayPoint:(CGPoint)point;
  396. /**
  397. 设置Instagram 视频分享参数 video 视频地址 可以为相册地址 或 本地文件地址
  398. @param video 视频地址 可以为相册地址 或 本地文件地址
  399. 使用相册地址时 注:为了效果需要确保其为相册的最新文件
  400. */
  401. - (void)SSDKSetupInstagramByVideo:(NSURL *)video;
  402. #pragma mark - DingTalk
  403. /**
  404. * 设置Ding Talk分享参数
  405. *
  406. * @param text 文本内容
  407. * @param image 图片
  408. * @param title 标题
  409. * @param url 链接
  410. * @param type 分享类型,仅支持Text、Image、Webpage、Audio
  411. */
  412. - (void)SSDKSetupDingTalkParamsByText:(NSString *)text
  413. image:(id)image
  414. title:(NSString *)title
  415. url:(NSURL *)url
  416. type:(SSDKContentType)type;
  417. #pragma mark - 支付宝
  418. /**
  419. * 设置支付宝分享参数
  420. *
  421. * @param text 分享文本
  422. * @param image 分享图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。
  423. * @param title 标题
  424. * @param url 分享链接
  425. * @param type 分享类型,仅支持Text、Image、WebPage
  426. * @param platformType 分享平台类型,仅支持输入SSDKPlatformTypeAliSocial和SSDKPlatformTypeAliSocialTimeline
  427. * 分享类型,平台支持情况如下:
  428. * SSDKPlatformTypeAliSocial(支付宝好友):支持Text、Image、WebPage
  429. * SSDKPlatformTypeAliSocialTimeline(支付宝朋友圈):支持Image、WebPage
  430. *
  431. */
  432. - (void)SSDKSetupAliSocialParamsByText:(NSString *)text
  433. image:(id)image
  434. title:(NSString *)title
  435. url:(NSURL *)url
  436. type:(SSDKContentType)type
  437. platformType:(SSDKPlatformType)platformType;
  438. #pragma mark - Pinterest
  439. /**
  440. * 设置Pinterest分享参数
  441. *
  442. * @param image 分享图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。
  443. * @param desc 图片描述
  444. * @param url 链接地址
  445. * @param boardName Board名称
  446. */
  447. - (void)SSDKSetupPinterestParamsByImage:(id)image
  448. desc:(NSString *)desc
  449. url:(NSURL *)url
  450. boardName:(NSString *)boardName;
  451. #pragma mark - Dropbox
  452. /**
  453. * 设置Dropbox分享参数
  454. *
  455. * @param attachment 分享附件。附可以为NSData、UIImage、NSString、NSURL(文件路径)、SSDKData、SSDKImage,注:只允许指定本地资源
  456. */
  457. - (void)SSDKSetupDropboxParamsByAttachment:(id)attachment;
  458. #pragma mark - 易信
  459. /**
  460. * 设置易信分享参数
  461. *
  462. * @param text 文本
  463. * @param title 标题
  464. * @param url 分享链接
  465. * @param thumbImage 缩略图,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage
  466. * @param image 图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage
  467. * @param musicFileURL 音乐文件链接地址
  468. * @param extInfo 扩展信息
  469. * @param fileData 文件数据,可以为NSData、UIImage、NSString、NSURL(文件路径)、SSDKData、SSDKImage
  470. * @param comment 评论信息,在应用内分享朋友圈时该字段有效
  471. * @param userId 发送給指定用户的唯一标识,在应用内分享好友时需要指定。注:如果双方为非好友关系发送消息即使提示成功,对方也无法接受。
  472. * @param type 分享类型,支持SSDKContentTypeText、SSDKContentTypeImage、SSDKContentTypeWebPage、SSDKContentTypeApp、SSDKContentTypeAudio和SSDKContentTypeVideo
  473. * @param platformSubType 平台子类型,只能传入SSDKPlatformTypeYiXinSession、SSDKPlatformTypeYiXinTimeline和SSDKPlatformTypeYiXinFav其中一个
  474. *
  475. * 分享文本时:
  476. * 设置type为SSDKContentTypeText, 并填入text参数
  477. *
  478. * 分享图片时:
  479. * 设置type为SSDKContentTypeImage, 非gif图片时:填入title和image参数
  480. *
  481. * 分享网页时:
  482. * 设置type为SSDKContentTypeWebPage, 并设置text、title、url以及thumbImage参数,如果尚未设置thumbImage则会从image参数中读取图片并对图片进行缩放操作。
  483. *
  484. * 分享应用时:
  485. * 设置type为SSDKContentTypeApp,并设置text、title、extInfo(可选)以及fileData(可选)参数。
  486. *
  487. * 分享音乐时:
  488. * 设置type为SSDKContentTypeAudio,并设置text、title、url以及musicFileURL(可选)参数。
  489. *
  490. * 分享视频时:
  491. * 设置type为SSDKContentTypeVideo,并设置text、title、url参数
  492. */
  493. - (void)SSDKSetupYiXinParamsByText:(NSString *)text
  494. title:(NSString *)title
  495. url:(NSURL *)url
  496. thumbImage:(id)thumbImage
  497. image:(id)image
  498. musicFileURL:(NSURL *)musicFileURL
  499. musicLowBandUrl:(id)musicLowBandUrl
  500. musicDataUrl:(id)musicDataUrl
  501. musicLowBandDataUrl:(id)musicLowBandDataUrl
  502. extInfo:(NSString *)extInfo
  503. fileData:(id)fileData
  504. videoLowBandUrl:(id)videoLowBandUrl
  505. comment:(NSString *)comment
  506. toUserId:(NSString *)userId
  507. type:(SSDKContentType)type
  508. forPlatformSubType:(SSDKPlatformType)platformSubType;
  509. #pragma mark - Flickr
  510. /**
  511. * 设置Flickr分享参数
  512. *
  513. * @param text 图片描述
  514. * @param image 分享图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。
  515. * @param title 图片标题
  516. * @param tags 图片标签列表
  517. * @param isPublic 指定是否公开图片,NO 私有 YES 公开。
  518. * @param isFriend 指定好友是否可以查看图片,NO 不允许,YES 允许
  519. * @param isFamily 指定家人是否可以查看图片,NO 不允许,YES 允许
  520. * @param safetyLevel 安全级别。1 安全 2 辅导级 3 限制级。
  521. * @param contentType 1 照片、2 屏幕截图、3 其他。
  522. * @param hidden 1 照片、2 屏幕截图、3 其他。
  523. */
  524. - (void)SSDKSetupFlickrParamsByText:(NSString *)text
  525. image:(id)image
  526. title:(NSString *)title
  527. tags:(NSArray *)tags
  528. isPublic:(BOOL)isPublic
  529. isFriend:(BOOL)isFriend
  530. isFamily:(BOOL)isFamily
  531. safetyLevel:(NSInteger)safetyLevel
  532. contentType:(NSInteger)contentType
  533. hidden:(NSInteger)hidden;
  534. #pragma mark - Instapaper
  535. /**
  536. * 设置Instapaper分享参数
  537. *
  538. * @param url 分享链接,如果isPrivateFromSource为YES并且content不为空时将忽略此参数
  539. * @param title 分享标题
  540. * @param desc 分享的链接描述
  541. * @param content 内容
  542. * @param isPrivateFromSource 是否为私有源
  543. * @param folderId 文件夹ID
  544. * @param resolveFinalUrl 解决最终URL问题标识,默认开启,用于解决跳转页面问题,设置为NO则表示不进行跳转
  545. */
  546. - (void)SSDKSetupInstapaperParamsByUrl:(NSURL *)url
  547. title:(NSString *)title
  548. desc:(NSString *)desc
  549. content:(NSString *)content
  550. isPrivateFromSource:(BOOL)isPrivateFromSource
  551. folderId:(NSInteger)folderId
  552. resolveFinalUrl:(BOOL)resolveFinalUrl;
  553. #pragma mark - Line
  554. /**
  555. * 设置Line分享参数
  556. *
  557. * @param text 分享文本
  558. * @param image 分享图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。
  559. * @param type 分享类型,仅支持Text、Image
  560. */
  561. - (void)SSDKSetupLineParamsByText:(NSString *)text
  562. image:(id)image
  563. type:(SSDKContentType)type;
  564. #pragma mark - Evernote
  565. /** v4.0.0
  566. * 设置印象笔记分享参数,注:中国版和国际版都是调用此接口进行分享参数设置。
  567. *
  568. * @param text 分享文本
  569. * @param images 分享图片列表,传入参数可以为单张图片信息,也可以为一个NSArray,数组元素可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage,如: @"http://www.mob.com/images/logo_black.png" 或 @[@"http://www.mob.com/images/logo_black.png"]
  570. * @param video 分享的视频的本地地址 仅支持本地视频 仅支持 mp4格式视频
  571. * @param title 标题
  572. * @param notebook 笔记本GUID
  573. * @param tags 标签GUID列表
  574. * @param platformType 分享平台类型,仅支持输入SSDKPlatformTypeYinXiang和SSDKPlatformTypeEvernote
  575. */
  576. - (void)SSDKSetupEvernoteParamsByText:(NSString *)text
  577. images:(id)images
  578. video:(NSURL *)video
  579. title:(NSString *)title
  580. notebook:(NSString *)notebook
  581. tags:(NSArray *)tags
  582. platformType:(SSDKPlatformType)platformType;
  583. - (void)SSDKSetupEvernoteParamsByText:(NSString *)text
  584. images:(id)images
  585. title:(NSString *)title
  586. notebook:(NSString *)notebook
  587. tags:(NSArray *)tags
  588. platformType:(SSDKPlatformType)platformType __deprecated_msg("discard form v4.2.0");
  589. #pragma mark - Google+
  590. /**
  591. * 设置GooglePlus分享参数
  592. *
  593. * @param text 文本
  594. * @param url 分享链接,仅在type为WebPage时有效
  595. * @param type 分享类型,仅支持Text、WebPage类型
  596. */
  597. - (void)SSDKSetupGooglePlusParamsByText:(NSString *)text
  598. url:(NSURL *)url
  599. type:(SSDKContentType)type;
  600. #pragma mark - Kakao
  601. /**
  602. * 设置KaKao分享参数
  603. */
  604. - (void)SSDKSetupKaKaoParamsByText:(NSString *)text
  605. images:(id)images
  606. title:(NSString *)title
  607. url:(NSURL *)url
  608. permission:(NSString *)permission
  609. enableShare:(BOOL)enableShare
  610. imageSize:(CGSize)imageSize
  611. appButtonTitle:(NSString *)appButtonTitle
  612. androidExecParam:(NSDictionary *)androidExecParam
  613. androidMarkParam:(NSString *)androidMarkParam
  614. iphoneExecParams:(NSDictionary *)iphoneExecParams
  615. iphoneMarkParam:(NSString *)iphoneMarkParam
  616. ipadExecParams:(NSDictionary *)ipadExecParams
  617. ipadMarkParam:(NSString *)ipadMarkParam
  618. type:(SSDKContentType)type
  619. forPlatformSubType:(SSDKPlatformType)platformSubType __deprecated_msg("Discard form v4.2.0. Using 'SSDKSetupKaKaoParamsByTitle:desc:imageURL:url:templateId:templateArgs:' instead.");
  620. /**
  621. 设置KaKaoTalk分享参数,支持链接分享和本地文件分享
  622. @param url 链接地址,为本地地址时默认分享文件形式,网络链接默认分享链接形式
  623. @param templateId 模板id,需要Kakao后台配置
  624. @param templateArgs 模板参数
  625. */
  626. - (void)SSDKSetupKaKaoTalkParamsByUrl:(NSURL *)url
  627. templateId:(NSString *)templateId
  628. templateArgs:(NSDictionary *)templateArgs;
  629. /**
  630. 设置KaKaoStory分享参数,客户端分享时只支持文本链接分享,不支持图片单独分享,需要配置白名单:storylink
  631. @param content 分享内容
  632. @param title 标题,仅客户端分享链接时有效
  633. @param images 图片数据,元素类型支持:UIImage,NSData(gif或图片),SSDKImage,NSString,NSArray
  634. @param url 链接
  635. @param permission 0:全部可见 1:好友可见 2:自己可见
  636. @param sharable 是否允许共享
  637. @param androidExecParam 安卓扩展参数
  638. @param iosExecParam iOS扩展参数
  639. @param type 分享类型
  640. */
  641. - (void)SSDKSetupKakaoStoryParamsByContent:(NSString *)content
  642. title:(NSString *)title
  643. images:(id)images
  644. url:(NSURL *)url
  645. permission:(int)permission
  646. sharable:(BOOL)sharable
  647. androidExecParam:(NSDictionary *)androidExecParam
  648. iosExecParam:(NSDictionary *)iosExecParam
  649. type:(SSDKContentType)type;
  650. #pragma mark - LinkedIn
  651. /**
  652. * 设置LinkedIn分享参数
  653. *
  654. * @param text 分享文本
  655. * @param image 分享图片,只能够是网络图片,传入类型可以为NSString(图片路径), NSURL(图片路径)。
  656. * @param url 分享链接
  657. * @param title 标题
  658. * @param urlDesc 链接的相关描述
  659. * @param visibility 可见性,可以传入PUBLIC、CONNECTIONS,默认Text分享使用PUBLIC,默认WebPage分享使用CONNECTIONS
  660. * @param type 分享类型,仅支持Text和WebPage
  661. */
  662. - (void)SSDKSetupLinkedInParamsByText:(NSString *)text
  663. image:(id)image
  664. url:(NSURL *)url
  665. title:(NSString *)title
  666. urlDesc:(NSString *)urlDesc
  667. visibility:(NSString *)visibility
  668. type:(SSDKContentType)type;
  669. #pragma mark - Tumblr
  670. /**
  671. * 设置Tumblr分享参数
  672. *
  673. * @param text 分享文本
  674. * @param image 分享图片,分享图片 可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage,仅在type为Image时有效。
  675. * @param url 分享链接
  676. * @param title 标题
  677. * @param blogName 博客名称,如果为nil,则默认分享到默认博客中。
  678. * @param type 分享类型,仅支持Text和Image
  679. */
  680. - (void)SSDKSetupTumblrParamsByText:(NSString *)text
  681. image:(id)image
  682. url:(NSURL *)url
  683. title:(NSString *)title
  684. blogName:(NSString *)blogName
  685. type:(SSDKContentType)type;
  686. #pragma mark - Pocket
  687. /**
  688. * 设置Pocket分享参数
  689. *
  690. * @param url 分享链接
  691. * @param title 标题
  692. * @param tags 标签,可以为NSString或者NSArray。为NSString时,标签名称要以逗号分隔;为NSArray时,元素为NSString。
  693. * @param tweetId 关联的推文ID
  694. */
  695. - (void)SSDKSetupPocketParamsByUrl:(NSURL *)url
  696. title:(NSString *)title
  697. tags:(id)tags
  698. tweetId:(NSString *)tweetId;
  699. #pragma mark - SMS
  700. /**
  701. * 设置短信分享参数
  702. *
  703. * @param text 文本
  704. * @param title 标题
  705. * @param images 分享图片列表,传入参数可以为单张图片信息,也可以为一个NSArray,数组元素可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。如: @"http://www.mob.com/images/logo_black.png" 或 @[@"http://www.mob.com/images/logo_black.png"]
  706. * @param attachments 附件列表, 可以为单个附件也可以为一个数组,元素可以为NSData、UIImage、NSString、NSURL(文件路径)、SSDKData、SSDKImage,注:只允许指定本地资源
  707. * @param recipients 接收人信息,如:@[@"400-685-2216"]
  708. * @param type 分享类型,仅支持Text、Image video类型 video在 attachments 附件列表中设置
  709. */
  710. - (void)SSDKSetupSMSParamsByText:(NSString *)text
  711. title:(NSString *)title
  712. images:(id)images
  713. attachments:(id)attachments
  714. recipients:(NSArray *)recipients
  715. type:(SSDKContentType)type;
  716. #pragma mark - Copy
  717. /**
  718. * 设置拷贝参数
  719. *
  720. * @param text 文本,仅在type为Text时有效
  721. * @param images 分享图片列表,传入参数可以为单张图片信息,也可以为一个NSArray,数组元素可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。如: @"http://www.mob.com/images/logo_black.png" 或 @[@"http://www.mob.com/images/logo_black.png"]
  722. * @param url 链接,仅在type为WebPage时有效
  723. * @param type 分享类型,仅支持Text、Image、WebPage类型
  724. */
  725. - (void)SSDKSetupCopyParamsByText:(NSString *)text
  726. images:(id)images
  727. url:(NSURL *)url
  728. type:(SSDKContentType)type;
  729. #pragma mark - 开心网
  730. /**
  731. * 设置开心网分享参数
  732. *
  733. * @param text 文本
  734. * @param image 分享图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage,仅在type为Image时有效。
  735. * @param type 分享类型,仅支持Text、Image类型
  736. */
  737. - (void)SSDKSetupKaiXinParamsByText:(NSString *)text
  738. image:(id)image
  739. type:(SSDKContentType)type;
  740. #pragma mark - 明道
  741. /**
  742. * 设置明道分享参数
  743. *
  744. * @param text 分享文本
  745. * @param image 分享图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。分享WebPage时需要指定为网络图片
  746. * @param url 分享链接,仅在WebPage时有效。
  747. * @param title 标题,仅在WebPage时有效
  748. * @param type 分享类型,仅支持Text、Image、WebPage
  749. */
  750. - (void)SSDKSetupMingDaoParamsByText:(NSString *)text
  751. image:(id)image
  752. url:(NSURL *)url
  753. title:(NSString *)title
  754. type:(SSDKContentType)type;
  755. #pragma mark - VKontakte
  756. /**
  757. * 设置VKontakte分享参数
  758. *
  759. * @param text 分享文本
  760. * @param images 分享图片列表,传入参数可以为单张图片信息,也可以为一个NSArray,数组元素可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。如: @"http://www.mob.com/images/logo_black.png" 或 @[@"http://www.mob.com/images/logo_black.png"]
  761. * @param url 分享的链接
  762. * @param groupId 圈子标识,默认为nil,分享到share圈子
  763. * @param friendsOnly 是否为好友可见,默认为NO,表示所有人可以看到。
  764. * @param latitude 纬度
  765. * @param longitude 经度
  766. * @param type 分享类型,仅支持Text、Image、WebPage
  767. */
  768. - (void)SSDKSetupVKontakteParamsByText:(NSString *)text
  769. images:(id)images
  770. url:(NSURL *)url
  771. groupId:(NSString *)groupId
  772. friendsOnly:(BOOL)friendsOnly
  773. latitude:(double)latitude
  774. longitude:(double)longitude
  775. type:(SSDKContentType)type;
  776. #pragma mark - YouTube
  777. /**
  778. 设置 YouTube 分享参数
  779. @param video 分享视频, 可以为NSData、NSString、NSURL(文件路径)、SSDKData
  780. @param title 标题
  781. @param description 描述
  782. @param tags 标签,可以为NSString或者NSArray。为NSString时,标签名称要以逗号分隔 为NSArray时,元素为NSString。
  783. @param privacyStatus 视频的隐私权限
  784. 只支持 Video类型
  785. */
  786. - (void)SSDKSetupYouTubeParamsByVideo:(id)video
  787. title:(NSString *)title
  788. description:(NSString *)description
  789. tags:(id)tags
  790. privacyStatus:(SSDKPrivacyStatus)privacyStatus;
  791. /**
  792. 设置 YouTube 分享参数
  793. 可完全自定义 发布参数
  794. @param video video 分享视频, 可以为NSData、NSString、NSURL(文件路径)、SSDKData
  795. @param parts 多个使用逗号隔开 例如 snippet,status 参考 https://developers.google.com/youtube/v3/docs/videos/insert#part
  796. @param jsonString Video resource 的 json数据 参考 https://developers.google.com/youtube/v3/docs/videos
  797. */
  798. - (void)SSDKSetupYouTubeParamsByVideo:(id)video
  799. parts:(NSString *)parts
  800. jsonString:(NSString *)jsonString;
  801. #pragma mark - WhatsApp
  802. /**
  803. * 设置WhatsApp分享参数
  804. *
  805. * @param text 分享文本
  806. * @param image 分享图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。
  807. * @param audio 分享音频, 可以为NSData、NSString、NSURL(文件路径)、SSDKData、注:只允许指定本地资源
  808. * @param video 分享视频, 可以为NSData、NSString、NSURL(文件路径)、SSDKData、注:只允许指定本地资源
  809. * @param point 分享菜单的显示位置,仅用于iPad版
  810. * @param type 分享类型,仅支持Text、Image、Audio、Video
  811. */
  812. - (void)SSDKSetupWhatsAppParamsByText:(NSString *)text
  813. image:(id)image
  814. audio:(id)audio
  815. video:(id)video
  816. menuDisplayPoint:(CGPoint)point
  817. type:(SSDKContentType)type;
  818. /**
  819. * 设置WhatsApp分享参数
  820. *
  821. * @param text 分享文本
  822. * @param image 分享图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。
  823. * @param audio 分享音频, 可以为NSData、NSString、NSURL(文件路径)、SSDKData、注:只允许指定本地资源
  824. * @param video 分享视频, 可以为NSData、NSString、NSURL(文件路径)、SSDKData、注:只允许指定本地资源
  825. * @param point 分享菜单的显示位置,仅用于iPad版
  826. * @param useSystem 是否使用系统提供的分享模块只针对分享文本,其他类型目前只有系统提供分享
  827. * @param type 分享类型,仅支持Text、Image、Audio、Video
  828. */
  829. - (void)SSDKSetupWhatsAppParamsByText:(NSString *)text
  830. image:(id)image
  831. audio:(id)audio
  832. video:(id)video
  833. menuDisplayPoint:(CGPoint)point
  834. useSystem:(BOOL)useSystem
  835. type:(SSDKContentType)type;
  836. #pragma mark - 邮件 Mail
  837. /**
  838. * 设置邮件分享参数
  839. *
  840. * @param text 文本
  841. * @param title 标题
  842. * @param images 分享图片列表,传入参数可以为单张图片信息,也可以为一个NSArray,数组元素可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。如: @"http://www.mob.com/images/logo_black.png" 或 @[@"http://www.mob.com/images/logo_black.png"]
  843. * @param attachments 附件列表, 可以为单个附件也可以为一个数组,元素可以为NSData、UIImage、NSString、NSURL(文件路径)、SSDKData、SSDKImage,注:只允许指定本地资源
  844. * @param recipients 接收人信息,如:@["tester@163.com"]
  845. * @param ccRecipients 抄送人信息,如:@["tester2@163.com"]
  846. * @param bccRecipients 密送人信息,如:@["tester3@163.com"]
  847. * @param type 分享类型,仅支持Text、Image video类型 video在 attachments 附件列表中设置
  848. */
  849. - (void)SSDKSetupMailParamsByText:(NSString *)text
  850. title:(NSString *)title
  851. images:(id)images
  852. attachments:(id)attachments
  853. recipients:(NSArray *)recipients
  854. ccRecipients:(NSArray *)ccRecipients
  855. bccRecipients:(NSArray *)bccRecipients
  856. type:(SSDKContentType)type;
  857. #pragma mark - 有道云笔记
  858. /**
  859. * 设置有道云笔记分享参数
  860. *
  861. * @param text 分享文本
  862. * @param images 分享图片列表,传入参数可以为单张图片信息,也可以为一个NSArray,数组元素可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage,
  863. *
  864. * @param title 标题
  865. * @param source 来源
  866. * @param author 作者
  867. * @param notebook 笔记本
  868. */
  869. - (void)SSDKSetupYouDaoNoteParamsByText:(NSString *)text
  870. images:(id)images
  871. title:(NSString *)title
  872. source:(NSString *)source
  873. author:(NSString *)author
  874. notebook:(NSString *)notebook;
  875. #pragma mark - Telegram
  876. /**
  877. * 设置Telegram分享参数
  878. *
  879. * @param text 分享文本
  880. * @param image 分享图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage。
  881. * @param audio 分享音频, NSURL(文件路径)注:只允许指定本地资源
  882. * @param video 分享视频, NSURL(文件路径)注:只允许指定本地资源
  883. * @param file 分享视频, NSURL(文件路径)注:只允许指定本地资源
  884. * @param point 分享菜单的显示位置,仅用于iPad版
  885. * @param type 分享类型,仅支持Text、Image、Audio、Video、File
  886. */
  887. - (void)SSDKSetupTelegramParamsByText:(NSString *)text
  888. image:(id)image
  889. audio:(NSURL *)audio
  890. video:(NSURL *)video
  891. file:(NSURL *)file
  892. menuDisplayPoint:(CGPoint)point
  893. type:(SSDKContentType)type;
  894. #pragma mark - 抖音
  895. /**
  896. * 设置抖音分享参数
  897. *
  898. * @param assetLocalIds 分享图片/视频集合, 注:只允许为相册资源且集合传对应的资源localIdentifier,非相册路径
  899. * 如相册路径为“assets-library://asset/asset.mp4?id=E7BEC1A7-D60C-4B41-85AB-B8A1606AB338&ext=mp4”,assetLocalIds为@[@"E7BEC1A7-D60C-4B41-85AB-B8A1606AB338"]
  900. * @param type 分享类型,仅支持Image、Video
  901. * @param hashtag 唯一标识
  902. * @param extraInfo 额外的数据
  903. */
  904. - (void)SSDKSetupDouyinParamesByAssetLocalIds:(NSArray<NSString *> *)assetLocalIds
  905. hashtag:(NSString *)hashtag
  906. extraInfo:(NSDictionary *)extraInfo
  907. type:(SSDKContentType)type;
  908. /**
  909. * 设置TikTok分享参数
  910. *
  911. * @param assetLocalIds 分享图片/视频集合, 注:只允许为相册资源且集合传对应的资源localIdentifier,非相册路径
  912. * 如相册路径为“assets-library://asset/asset.mp4?id=E7BEC1A7-D60C-4B41-85AB-B8A1606AB338&ext=mp4”,assetLocalIds为@[@"E7BEC1A7-D60C-4B41-85AB-B8A1606AB338"]
  913. * @param type 分享类型,仅支持Image、Video
  914. * @param hashtag 唯一标识
  915. * @param extraInfo 额外的数据
  916. */
  917. - (void)SSDKSetupTikTokParamesByAssetLocalIds:(NSArray<NSString *> *)assetLocalIds
  918. hashtag:(NSString *)hashtag
  919. extraInfo:(NSDictionary *)extraInfo
  920. type:(SSDKContentType)type;
  921. /**
  922. * 设置企业微信分享参数
  923. *
  924. * @param text 文本
  925. * @param title 标题
  926. * @param url 分享链接
  927. * @param thumbImage 缩略图,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage
  928. * @param image 图片,可以为UIImage、NSString(图片路径)、NSURL(图片路径)、SSDKImage,如为图片路径只支持本地沙盒路径
  929. * @param fileData 文件数据,可以为NSData、UIImage、NSString、NSURL(文件路径)、SSDKData、SSDKImage,文件路径只支持本地沙盒路径
  930. * @param type 分享类型,支持SSDKContentTypeText、SSDKContentTypeImage、SSDKContentTypeWebPage、SSDKContentTypeFile和SSDKContentTypeVideo
  931. *
  932. * 分享文本时:
  933. * 设置type为SSDKContentTypeText, 并填入text参数
  934. *
  935. * 分享图片时:
  936. * 设置type为SSDKContentTypeImage, 填入title(自定义图片名称及后缀)和image参数
  937. *
  938. * 分享网页时:
  939. * 设置type为SSDKContentTypeWebPage, 并设置text、title、url以及thumbImage参数,如果尚未设置thumbImage则会从image参数中读取图片并对图片进行缩放操作。
  940. *
  941. * 分享视频时:
  942. * 设置type为SSDKContentTypeVideo,并设置title(自定义视频名称及后缀)、video参数
  943. *
  944. * 分享文件时:
  945. * 设置type为SSDKContentTypeFile, 并设置title(自定义文件名称及后缀)、fileData参数
  946. */
  947. - (void)SSDKSetupWeWorkParamsByText:(NSString *)text
  948. title:(NSString *)title
  949. url:(NSURL *)url
  950. thumbImage:(id)thumbImage
  951. image:(id)image
  952. video:(id)video
  953. fileData:(id)fileData
  954. type:(SSDKContentType)type;
  955. /** 设置绿洲分享参数
  956. * @param title 标题
  957. * @param text 内容
  958. * @param assetLocalIds 相册资源,注:只允许为相册资源且集合传对应的资源localIdentifier,非相册路径
  959. 如相册路径为“assets-library://asset/asset.mp4?id=E7BEC1A7-D60C-4B41-85AB-B8A1606AB338&ext=mp4”,assetLocalIds为@[@"E7BEC1A7-D60C-4B41-85AB-B8A1606AB338"]
  960. assetLocalIds优先级低于image和video
  961. * @param image 图片,可以为NSString、NSURL、UIImage、NSData、或着以上类型的数组,注: 图片大小限制为10M, 图片最多传12张
  962. * @param video 视频资源,可以使NSData(大小不能超过20M,需提供后缀类型), 视频最多1个,图片与视频不能混合添加
  963. * @param fileExtension data类型的标识符
  964. * @param type 分享的类型
  965. */
  966. - (void)SSDKSetupOasisParamsByTitle:(NSString *)title
  967. text:(NSString *)text
  968. assetLocalIds:(NSArray <NSString *>*)assetLocalIds
  969. image:(id)image
  970. video:(NSData *)video
  971. fileExtension:(NSString *)fileExtension
  972. type:(SSDKContentType)type;
  973. /** 设置SnapChat分享参数
  974. * @param caption 标题
  975. * @param attachmentUrl 网页链接
  976. * @param image 可以为UIImage、NSString、NSURL、SSDKImage
  977. * @param video 视频,不可与图片混合,可以为NSString、NSURL、NSData
  978. * @param sticker 贴纸,可以为UIImage、NSString、NSURL、SSDKImage
  979. * @param stickerAnimated 贴纸是否是动画
  980. * @param stickerRotation 贴纸旋转的角度
  981. * @param cameraViewState 只有在没有视频或图片时有效 0. unknow 1.Front 2.Back
  982. * @param type 分享的类型
  983. */
  984. - (void)SSDKSetupSnapChatParamsByCaption:(NSString *)caption
  985. attachmentUrl:(NSString *)attachmentUrl
  986. image:(id)image
  987. video:(id)video
  988. sticker:(id)sticker
  989. stickerAnimated:(BOOL)stickerAnimated
  990. stickerRotation:(CGFloat)stickerRotation
  991. cameraViewState:(NSInteger)cameraViewState
  992. type:(SSDKContentType)type;
  993. #pragma mark - 快手
  994. /** 设置快手分享参数
  995. * @param title 标题
  996. * @param desc 描述
  997. * @param linkURL 私信-点击的链接地址
  998. * @param thumbImage 私信-缩略图(不能超过1M)
  999. * @param openID 要查看的用户的openID,可选
  1000. * @param receiverOpenID 接收方 openid , 可选,当不填时,快手 APP 会调启选择好友界面来确定接收方
  1001. * @param localIdentifier 分享的相册图片/视频的相册标识(此参数和path互斥,如同时存在以localIdentifier为准)
  1002. * @param tags 视频分享-标签数组
  1003. * @param type 分享的类型
  1004. */
  1005. - (void)SSDKSetupKuaiShouShareParamsByTitle:(NSString *)title
  1006. desc:(NSString *)desc
  1007. linkURL:(NSString *)linkURL
  1008. thumbImage:(id)thumbImage
  1009. openID:(NSString *)openID
  1010. receiverOpenID:(NSString *)receiverOpenID
  1011. localIdentifier:(NSString *)localIdentifier
  1012. tags:(NSArray<NSString *> *)tags
  1013. extraInfo:(NSString *)extraInfo
  1014. type:(SSDKContentType)type;
  1015. #pragma mark - Deprecated
  1016. - (void)SSDKEnableUseClientShare __deprecated_msg("Discard form v4.2.0");
  1017. - (void)SSDKEnableExtensionShare __deprecated_msg("Discard form v4.2.0");
  1018. @end