1、系统方式创建分享
-
按照下图在 Info.plist 文件中将 Localization native development region 的值改为 China。如果不设置此项弹出的分享页面中显示的按钮为英文说明。
-
UIActivityViewController 方式创建
// 设置分享的内容 NSString *textToShare = @"请大家登录《iOS云端与网络通讯》服务网站。"; UIImage *imageToShare = [UIImage imageNamed:@"swift"]; NSURL *urlToShare = [NSURL URLWithString:@"http://m.baidu.com"]; // 创建分享视图控制器 /* activityItems: 分享的内容 applicationActivities: 分享的类型,默认(nil)时为 UIActivity */ NSArray *items = @[textToShare, imageToShare, urlToShare]; UIActivityViewController *activityVC = [[UIActivityViewController alloc] initWithActivityItems:items applicationActivities:nil]; // 设置不出现的分享按钮 /* Activity 类型又分为 “操作” 和 “分享” 两大类: UIActivityCategoryAction 操作: UIActivityTypeAirDrop AirDrop AirDrop UIActivityTypePrint 打印 Print UIActivityTypeSaveToCameraRoll 保存到相册 Save Image UIActivityTypeAssignToContact 添加到联系人 AssignToContact UIActivityTypeAddToReadingList 添加到 Safari 阅读列表 AddToReadingList UIActivityTypeCopyToPasteboard 复制到剪贴板 Copy UIActivityTypeOpenInIBooks 在 iBook 中打开 UIActivityCategoryShare 分享: UIActivityTypeMail 邮箱 Mail UIActivityTypeMessage 短信 Message UIActivityTypePostToTwitter 分享到 Twitter UIActivityTypePostToFacebook 分享到 Facebook UIActivityTypePostToVimeo 分享到 Vimeo(视频媒体) UIActivityTypePostToFlickr 分享到 Flickr(网络相簿) UIActivityTypePostToWeibo 分享到 新浪微博 UIActivityTypePostToTencentWeibo 分享到 腾讯微博 */ // 添加到此数组中的系统分享按钮项将不会出现在分享视图控制器中 activityVC.excludedActivityTypes = @[UIActivityTypeAssignToContact, UIActivityTypePrint]; // 显示分享视图控制器 [self presentViewController:activityVC animated:YES completion:nil]; // 分享完成 activityVC.completionWithItemsHandler = ^(NSString *activityType, BOOL completed, NSArray *returnedItems, NSError *activityError) { // 分享完成或退出分享时调用该方法 if (completed) { NSLog(@"分享完成"); } else { NSLog(@"取消分享"); } };
-
效果
2、系统方式自定义分享
-
按照下图在 Info.plist 文件中将 Localization native development region 的值改为 China。如果不设置此项弹出的分享页面中显示的按钮为英文说明。
-
自定义按钮
-
myUIActivity.h
#import <UIKit/UIKit.h> @interface myUIActivity : UIActivity <UINavigationControllerDelegate> @end
-
myUIActivity.m
#import "myUIActivity.h" /* 自定义分享按钮 */ @implementation myUIActivity // 设置分享按钮的类型 - (NSString *)activityType { // 在 completionWithItemsHandler 回调里可以用于判断,一般取当前类名 return NSStringFromClass([myUIActivity class]); } // 设置分享按钮的标题 - (NSString *)activityTitle { // 设置显示在分享框里的名称 return @"自定义分享按钮"; } // 设置分享按钮的图片 - (UIImage *)activityImage { // 图片自定变为黑白色,默认尺寸为 56 * 56 像素 return [UIImage imageNamed:@"JHQ0228"]; } // 设置是否显示分享按钮 - (BOOL)canPerformWithActivityItems:(NSArray *)activityItems { // 这里一般根据用户是否授权等来决定是否要隐藏分享按钮 return YES; } // 预处理分享数据 - (void)prepareWithActivityItems:(NSArray *)activityItems { // 解析分享数据时调用,可以进行一定的处理 NSLog(@"prepareWithActivityItems"); // 手动执行分享操作,保存到相册 UIImageWriteToSavedPhotosAlbum(activityItems[1], nil, nil, nil); } // 执行分享 - (UIViewController *)activityViewController { // 点击自定义分享按钮时调用,跳转到自定义的视图控制器 NSLog(@"activityViewController"); return nil; } // 执行分享 - (void)performActivity { // 点击自定义分享按钮时调用 NSLog(@"performActivity"); } // 完成分享 - (void)activityDidFinish:(BOOL)completed { // 分享视图控制器退出时调用 NSLog(@"activityDidFinish"); } @end
-
-
使用自定义按钮
-
ViewController.m
#import "myUIActivity.h" // 设置分享的内容 NSString *textToShare = @"请大家登录《iOS云端与网络通讯》服务网站。"; UIImage *imageToShare = [UIImage imageNamed:@"swift"]; NSURL *urlToShare = [NSURL URLWithString:@"http://m.baidu.com"]; // 设置分享的类型 myUIActivity *myActivity = [[myUIActivity alloc] init]; // 创建分享视图控制器 NSArray *items = @[textToShare, imageToShare, urlToShare]; NSArray *activities = @[myActivity]; UIActivityViewController *activityVC = [[UIActivityViewController alloc] initWithActivityItems:items applicationActivities:activities]; // 设置不出现的分享按钮 activityVC.excludedActivityTypes = @[UIActivityTypeAirDrop]; // 显示分享视图控制器 [self presentViewController:activityVC animated:YES completion:nil]; // 分享完成 activityVC.completionWithItemsHandler = ^(NSString *activityType, BOOL completed, NSArray *returnedItems, NSError *activityError) { // 分享完成或退出分享时调用该方法 if (completed) { NSLog(@"分享完成"); } else { NSLog(@"取消分享"); } };
-
-
效果
3、友盟 登录/分享 集成
U-Share 快速集成多平台分享、登录功能。帮助应用或游戏快速具备国内外多平台分享、第三方登录功能,SDK 包最小,集成成本最低,平台覆盖最全,并基于友盟+大数据,提供最为权威、实时的用户画像、分享回流等数据分析,助力产品开发与推广。
- 覆盖国内外近 30 家社交平台,支持文本、图片、音乐、视频、链接等多种内容类型的分享,并提供了主流游戏平台的 SDK。
- 国内平台:微信、朋友圈、QQ、Qzone、新浪微博、腾讯微博、人人、豆瓣、易信、短信、邮件等。
- 国外平台:Facebook、Twitter、Instagram、Google+、LINE、WhatsApp、Pinterest、Evernote、Pocket、LinkedIn、KakaoTalk 等。
U-Share 集成流程
U-Share 第三方账号申请及绑定
U-Share 快速集成文档
U-Share API 说明
U-Share SDK 下载
-
集成友盟社会化组件流程
-
1.1 注册友盟账号
-
1.2 申请第三方账号
- 参照文档:申请第三方账号
-
1.3 绑定第三方账号
- 参照文档:绑定第三方账号到友盟后台
-
1.4 下载 SDK
- 进入下载 SDK 页面,勾选自己需要的功能进行下载。
-
1.5 技术支持
官方微博: umengsocial
开发者社区:http://bbs.umeng.com/thread-5908-1-1.html?from=qianming
技术支持:联系客服
-
3.1 第三方账号申请及绑定
3.1.1 申请第三方账号
进行分享、授权操作需要在第三方平台创建应用并提交审核,友盟默认提供了大多数平台的测试账号,但如果需要将分享、授权来源、分享到 QQ、Qzone 的 icon 更改为自己 APP 的应用,就需要自己申请第三方账号。
-
新浪微博
-
登录新浪微博开放平台,填写相关应用信息并上传 icon 图片。注意修改安全域名为
sns.whalecloud.com
同时设置授权回调页为http://sns.whalecloud.com/sina2/callback
安全域名设置在应用信息 --> 基本信息,具体位置参考下 -
授权回调页、取消授权回调页设置在应用信息 --> 高级信息,具体位置参考下图
安全域名的修改需要二次审核通过才生效,授权回调页修改即时生效
-
-
微信
- 登录微信开放平台,填写相关应用信息,审核通过后获取到微信 AppID 及 AppSecret,如果需要微信登录功能,需要申请微信登录权限。
-
QQ 及 Qzone
-
QQ 及 Qzone 使用同一个 AppID 及 Appkey,登录腾讯开放平台,选择移动应用,填写相关应用信息并提交审核,未审核前通过只能使用测试账号,添加测试账号方法如下:选择用户能力 --> 进阶社交能力 --> 应用调试者,添加测试账号必须在申请者好友列表中,如下图
-
-
人人网
-
登录人人开放平台,填写相关应用信息,同时填写应用根域名为
sns.whalecloud.com
具体位置: 基本信息 --> 应用根域名 如图
-
-
豆瓣
-
登录豆瓣开放平台,创建应用并填写相关应用信息,注意权限必须选择广播,同时填写回调地址为
http://sns.whalecloud.com/douban/callback
-
3.1.2 绑定第三方账号到友盟后台
目前需要在友盟后台绑定的第三方账号为:新浪微博、腾讯微博、人人网、豆瓣、Qzone,其余平台如微信、QQ 直接在代码中设置。
-
绑定地址:http://umeng.com/apps,登录友盟网站 -> 左上角选择你们的产品 -> 组件 -> 社会化组件 -> 设置
-
短链接开关
- 短链接开关只对新浪微博、腾讯微博、人人网、豆瓣四个平台有效,开启短链接开关,分享文案中附加的链接会被转码,同时可以统计到分享回流率(点击链接的次数),关闭短链接开关则无法统计,短链接开关默认为关闭状态。
-
文字截断开关
- 文字截断开关只对新浪微博、腾讯微博、人人网、豆瓣四个平台有效,同时只对使用自定义分享编辑页或没有分享编辑页用户有效,当分享文案超出字数限制时自动截断,开关状态默认关闭。
3.2 U-Share SDK 集成
3.2.1 下载 U-Share SDK
- 通过 iOS 社会化组件下载页面选择所需的社交平台后进行下载。
3.2.2 加入 U-Share SDK
-
将 U-Share SDK 添加到工程
-
添加项目配置,在 Other Linker Flags 加入 -ObjC
-
加入依赖系统库 libsqlite3.tbd
-
添加平台相应的依赖库,根据集成的不同平台加入相关的依赖库,未列出平台则不用添加。添加方式:选中项目 Target -> Linked Frameworks and Libraries 列表中添加
- 注:Twitter 平台加入后需添加 TwitterKit.framework/Resources/TwitterKitResources.bundle。
3.3 U-Share SDK 平台配置
- 从这一步骤就开始需要第三方 appKey 和 appSecret 等信息,可参考第三方账号申请及绑定申请所需的平台账号。
3.3.1 配置各平台 URL Scheme
-
添加 URL Types
URL Scheme 是通过系统找到并跳转对应 app 的一类设置,通过向项目中的 info.plist 文件中加入 URL types 可使用第三方平台所注册的 appkey 信息向系统注册你的 app,当跳转到第三方应用授权或分享后,可直接跳转回你的 app。
-
添加 URL Types 有如下几处,都可进行设置
-
1、通过工程设置面板
-
2、通过 info.plist 文件编辑
-
3、直接编辑 info.plist 中 XML 代码
-
-
配置第三方平台 URL Scheme
-
未列出则不需设置
-
3.3.2 适配 iOS 9/10 系统
iOS9 系统后 Apple 对 HTTP 请求及访问外部应用做了更加严格的要求,包括 HTTP 白名单、跳转第三方应用白名单等,具体设置第三方平台参数请参照适配 iOS9/10 系统。
-
HTTPS 传输安全
Apple 将从 2017 年开始执行 ATS(App Transport Security),所有进行审核的应用中网络请求全部支持 HTTPS,届时以下配置将会失效,请提前做好准备。
以 iOS10 SDK 编译的工程会默认以 SSL 安全协议进行网络传输,即 HTTPS,如果依然使用 HTTP 协议请求网络会报系统异常并中断请求。目前可用如下两种方式保持用 HTTP 进行网络连接:
-
在 info.plist 中加入安全域名白名单(右键 info.plist 用 source code 打开)
<key>NSAppTransportSecurity</key> <dict> <!-- 配置允许 http 的任意网络End--> <key>NSExceptionDomains</key> <dict> <!-- 集成新浪微博对应的HTTP白名单--> <key>sina.com.cn</key> <dict> <key>NSIncludesSubdomains</key> <true/> <key>NSThirdPartyExceptionAllowsInsecureHTTPLoads</key> <true/> <key>NSThirdPartyExceptionRequiresForwardSecrecy</key> <false/> </dict> <key>sinaimg.cn</key> <dict> <key>NSIncludesSubdomains</key> <true/> <key>NSThirdPartyExceptionAllowsInsecureHTTPLoads</key> <true/> <key>NSThirdPartyExceptionRequiresForwardSecrecy</key> <false/> </dict> <key>sinajs.cn</key> <dict> <key>NSIncludesSubdomains</key> <true/> <key>NSThirdPartyExceptionAllowsInsecureHTTPLoads</key> <true/> <key>NSThirdPartyExceptionRequiresForwardSecrecy</key> <false/> </dict> <key>sina.cn</key> <dict> <!-- 适配iOS10 --> <key>NSExceptionMinimumTLSVersion</key> <string>TLSv1.0</string> <key>NSIncludesSubdomains</key> <true/> <key>NSThirdPartyExceptionRequiresForwardSecrecy</key> <false/> </dict> <key>weibo.cn</key> <dict> <!-- 适配iOS10 --> <key>NSExceptionMinimumTLSVersion</key> <string>TLSv1.0</string> <key>NSIncludesSubdomains</key> <true/> <key>NSThirdPartyExceptionRequiresForwardSecrecy</key> <false/> </dict> <key>weibo.com</key> <dict> <!-- 适配iOS10 --> <key>NSExceptionMinimumTLSVersion</key> <string>TLSv1.0</string> <key>NSIncludesSubdomains</key> <true/> <key>NSThirdPartyExceptionAllowsInsecureHTTPLoads</key> <true/> <key>NSThirdPartyExceptionRequiresForwardSecrecy</key> <false/> </dict> <!-- 新浪微博--> <!-- 集成人人授权对应的HTTP白名单--> <key>renren.com</key> <dict> <key>NSIncludesSubdomains</key> <true/> <key>NSThirdPartyExceptionAllowsInsecureHTTPLoads</key> <true/> <key>NSThirdPartyExceptionRequiresForwardSecrecy</key> <false/> </dict> <!-- 人人授权--> </dict> </dict>
若新版 Xcode 控制台输出 “[] tcp_connection_xxx“ 等内容,可以在运行按钮旁的选择 target 选项内的 Edit Scheme - Run - Arguments - Enviroment variables 中增加 OS_ACTIVITY_MODE=disable,可将相关日志关闭。
-
配置 ApplicationQueriesSchemes(应用间跳转)
-
如果你的应用使用了如 SSO 授权登录或跳转到第三方分享功能,在 iOS9/10 下就需要增加一个可跳转的白名单,即 LSApplicationQueriesSchemes,否则将在 SDK 判断是否跳转时用到的 canOpenURL 时返回 NO,进而只进行 webview 授权或授权/分享失败。 在项目中的 info.plist 中加入应用白名单,右键 info.plist 选择 source code 打开(具体设置在 Build Setting -> Packaging -> Info.plist File 可获取 plist 路径)。
<key>LSApplicationQueriesSchemes</key> <array> <!-- 微信 URL Scheme 白名单--> <string>wechat</string> <string>weixin</string> <!-- 新浪微博 URL Scheme 白名单--> <string>sinaweibohd</string> <string>sinaweibo</string> <string>sinaweibosso</string> <string>weibosdk</string> <string>weibosdk2.5</string> <!-- QQ、Qzone URL Scheme 白名单--> <string>mqqapi</string> <string>mqq</string> <string>mqqOpensdkSSoLogin</string> <string>mqqconnect</string> <string>mqqopensdkdataline</string> <string>mqqopensdkgrouptribeshare</string> <string>mqqopensdkfriend</string> <string>mqqopensdkapi</string> <string>mqqopensdkapiV2</string> <string>mqqopensdkapiV3</string> <string>mqqopensdkapiV4</string> <string>mqzoneopensdk</string> <string>wtloginmqq</string> <string>wtloginmqq2</string> <string>mqqwpa</string> <string>mqzone</string> <string>mqzonev2</string> <string>mqzoneshare</string> <string>wtloginqzone</string> <string>mqzonewx</string> <string>mqzoneopensdkapiV2</string> <string>mqzoneopensdkapi19</string> <string>mqzoneopensdkapi</string> <string>mqqbrowser</string> <string>mttbrowser</string> <!-- 支付宝 URL Scheme 白名单--> <string>alipay</string> <string>alipayshare</string> <!-- 人人 URL Scheme 白名单--> <string>renrenios</string> <string>renrenapi</string> <string>renren</string> <string>renreniphone</string> <!-- 来往 URL Scheme 白名单--> <string>laiwangsso</string> <!-- 易信 URL Scheme 白名单--> <string>yixin</string> <string>yixinopenapi</string> <!-- instagram URL Scheme 白名单--> <string>instagram</string> <!-- whatsapp URL Scheme 白名单--> <string>whatsapp</string> <!-- line URL Scheme 白名单--> <string>line</string> <!-- Facebook URL Scheme 白名单--> <string>fbapi</string> <string>fb-messenger-api</string> <string>fbauth2</string> <string>fbshareextension</string> <!-- Kakao URL Scheme 白名单--> <!-- 注:以下第一个参数需替换为自己的kakao appkey--> <!-- 格式为 kakao + "kakao appkey"--> <string>kakaofa63a0b2356e923f3edd6512d531f546</string> <string>kakaokompassauth</string> <string>storykompassauth</string> <string>kakaolink</string> <string>kakaotalk-4.5.0</string> <string>kakaostory-2.9.0</string> <!-- pinterest URL Scheme 白名单--> <string>pinterestsdk.v1</string> </array>
-
3.4 调用 U-Share SDK
3.4.1 初始化设置
-
初始化 U-Share 及第三方平台
app 启动后进行 U-Share 和第三方平台的初始化工作,以下代码将所有平台初始化示例放出,开发者根据平台需要选取相应代码,并替换为所属注册的 appKey 和 appSecret。
-
在 AppDelegate.m 中设置如下代码
#import <UMSocialCore/UMSocialCore.h> - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { // 打开调试日志 [[UMSocialManager defaultManager] openLog:YES]; // 设置友盟 appkey [[UMSocialManager defaultManager] setUmSocialAppkey:@"57b432afe0f55a9832001a0a"]; // 获取友盟 social 版本号 // NSLog(@"UMeng social version: %@", [UMSocialGlobal umSocialSDKVersion]); // 设置微信的 appKey 和 appSecret [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_WechatSession appKey:@"wxdc1e388c3822c80b" appSecret:@"3baf1193c85774b3fd9d18447d76cab0" redirectURL:@"http://mobile.umeng.com/social"]; // 设置分享到 QQ 互联的 appKey 和 appSecret // U-Share SDK 为了兼容大部分平台命名,统一用 appKey 和 appSecret 进行参数设置, // 而 QQ 平台仅需将 appID 作为 U-Share 的 appKey 参数传进即可。 [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_QQ appKey:@"100424468" appSecret:nil redirectURL:@"http://mobile.umeng.com/social"]; // 设置新浪的 appKey 和 appSecret [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_Sina appKey:@"3921700954" appSecret:@"04b48b094faeb16683c32669824ebdad" redirectURL:@"http://sns.whalecloud.com/sina2/callback"]; // 支付宝的 appKey [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_AlipaySession appKey:@"2015111700822536" appSecret:nil redirectURL:@"http://mobile.umeng.com/social"]; // 设置易信的 appKey [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_YixinSession appKey:@"yx35664bdff4db42c2b7be1e29390c1a06" appSecret:nil redirectURL:@"http://mobile.umeng.com/social"]; // 设置点点虫(原来往)的 appKey 和 appSecret [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_LaiWangSession appKey:@"8112117817424282305" appSecret:@"9996ed5039e641658de7b83345fee6c9" redirectURL:@"http://mobile.umeng.com/social"]; // 设置领英的 appKey 和 appSecret [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_Linkedin appKey:@"81t5eiem37d2sc" appSecret:@"7dgUXPLH8kA8WHMV" redirectURL:@"https://api.linkedin.com/v1/people"]; // 设置 Twitter 的 appKey 和 appSecret [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_Twitter appKey:@"fB5tvRpna1CKK97xZUslbxiet" appSecret:@"YcbSvseLIwZ4hZg9YmgJPP5uWzd4zr6BpBKGZhf07zzh3oj62K" redirectURL:nil]; // 如果不想显示平台下的某些类型,可用以下接口设置 // [[UMSocialManager defaultManager] removePlatformProviderWithPlatformTypes:@[@(UMSocialPlatformType_WechatFavorite), @(UMSocialPlatformType_YixinTimeLine), @(UMSocialPlatformType_LaiWangTimeLine), @(UMSocialPlatformType_Qzone)]]; ... return YES; }
-
设置系统回调
// 支持所有 iOS 系统 - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation { BOOL result = [[UMSocialManager defaultManager] handleOpenURL:url]; if (!result) { // 其他如支付等 SDK 的回调 } return result; }
-
注:以上为建议使用的系统 openURL 回调,且 新浪 平台仅支持以上回调。还有以下两种回调方式,如果开发者选取以下回调,也请补充相应的函数调用。
-
1、仅支持 iOS9 以上系统,iOS8 及以下系统不会回调
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options { BOOL result = [[UMSocialManager defaultManager] handleOpenURL:url]; if (!result) { // 其他如支付等 SDK 的回调 } return result; }
-
2、支持目前所有 iOS 系统
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url { BOOL result = [[UMSocialManager defaultManager] handleOpenURL:url]; if (!result) { // 其他如支付等 SDK 的回调 } return result; }
-
-
3.4.2 第三方平台登录
- 支持登录的平台:微信、QQ、新浪微博、腾讯微博、人人网、豆瓣、Facebook、Twitter、Linkedin 领英、Kakao。
支持登录并获取用户信息的平台:微信、QQ、新浪微博、Facebook、Twitter、Linkedin 领英、Kakao。
-
授权并获取用户信息
// 在需要进行获取登录信息的 UIViewController 中加入如下代码 #import <UMSocialCore/UMSocialCore.h> - (void)getUserInfoForPlatform:(UMSocialPlatformType)platformType { [[UMSocialManager defaultManager] getUserInfoWithPlatform:platformType currentViewController:self completion:^(id result, NSError *error) { UMSocialUserInfoResponse *resp = result; // 第三方登录数据(为空表示平台未提供) // 授权数据 NSLog(@" uid: %@", resp.uid); NSLog(@" openid: %@", resp.openid); NSLog(@" accessToken: %@", resp.accessToken); NSLog(@" refreshToken: %@", resp.refreshToken); NSLog(@" expiration: %@", resp.expiration); // 用户数据 NSLog(@" name: %@", resp.name); NSLog(@" iconurl: %@", resp.iconurl); NSLog(@" gender: %@", resp.gender); // 第三方平台 SDK 原始数据 NSLog(@" originalResponse: %@", resp.originalResponse); }]; }
- 注:若在 4.x 及 5.x 版本中使用微信登录,升级后需参考说明:4.x/5.x版本升级(授权信息变化)。
3.4.3 第三方平台分享
-
调用分享面板
-
在分享按钮绑定如下触发代码
#import <UShareUI/UShareUI.h> // 显示分享面板 [UMSocialUIManager showShareMenuViewInWindowWithPlatformSelectionBlock:^(UMSocialPlatformType platformType, NSDictionary *userInfo) { // 根据获取的 platformType 确定所选平台进行下一步操作 }];
-
-
定制自己的分享面板预定义平台
-
以下方法可设置平台顺序
#import <UShareUI/UShareUI.h> [UMSocialUIManager setPreDefinePlatforms:@[@(UMSocialPlatformType_Sina),@(UMSocialPlatformType_QQ),@(UMSocialPlatformType_WechatSession)]]; [UMSocialUIManager showShareMenuViewInWindowWithPlatformSelectionBlock:^(UMSocialPlatformType platformType, NSDictionary *userInfo) { // 根据获取的 platformType 确定所选平台进行下一步操作 }];
为避免应用审核被拒,仅会对有效的平台进行显示,如平台应用未安装,或平台应用不支持等会进行隐藏。由于以上原因,在模拟器上部分平台会隐藏。
如果遇到分享面板未显示,请参考分享面板无法弹出。
-
-
设置分享内容
-
分享文本
- (void)shareTextToPlatformType:(UMSocialPlatformType)platformType { // 创建分享消息对象 UMSocialMessageObject *messageObject = [UMSocialMessageObject messageObject]; // 设置文本 messageObject.text = @"社会化组件 UShare 将各大社交平台接入您的应用,快速武装 App。"; // 调用分享接口 [[UMSocialManager defaultManager] shareToPlatform:platformType messageObject:messageObject currentViewController:self completion:^(id data, NSError *error) { if (error) { NSLog(@"************ Share fail with error %@ *********", error); }else{ NSLog(@"response data is %@", data); } }]; }
- 其他分享类型示例请参考 U-Share API 文档。
-
3.5 技术支持
访问:友盟开发者社区
-
发邮件至 social-support@umeng.com。
- 为了能够尽快响应您的反馈,请提供您的 appkey 及 log 中的详细出错日志,您所提供的内容越详细越有助于我们帮您解决问题。
-
开启友盟分享调试 log 方法:
#import <UMSocialCore/UMSocialCore.h> [[UMSocialManager defaultManager] openLog:YES];
- 在 console 中查看日志。
-
效果
3.6 简单使用
-
AppDelegate.m
#import <UMSocialCore/UMSocialCore.h> - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { // 打开日志 [[UMSocialManager defaultManager] openLog:YES]; // 打开图片水印 //[UMSocialGlobal shareInstance].isUsingWaterMark = YES; // 获取友盟 social 版本号 UMSocialLogInfo(@"UMeng social version: %@", [UMSocialGlobal umSocialSDKVersion]); // 设置友盟 appkey [[UMSocialManager defaultManager] setUmSocialAppkey:@"57b432afe0f55a9832001a0a"]; // 设置微信的 appKey 和 appSecret [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_WechatSession appKey:@"wxdc1e388c3822c80b" appSecret:@"3baf1193c85774b3fd9d18447d76cab0" redirectURL:@"http://mobile.umeng.com/social"]; /* * 添加某一平台会加入平台下所有分享渠道,如微信:好友、朋友圈、收藏,QQ:QQ 和 QQ 空间 * 以下接口可移除相应平台类型的分享,如微信收藏,对应类型可在枚举中查找 */ //[[UMSocialManager defaultManager] removePlatformProviderWithPlatformTypes:@[@(UMSocialPlatformType_WechatFavorite)]]; // 设置分享到 QQ 互联的 appID // U-Share SDK为了兼容大部分平台命名,统一用 appKey 和 appSecret 进行参数设置, // 而 QQ 平台仅需将 appID 作为 U-Share 的 appKey 参数传进即可。 [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_QQ appKey:@"1105821097" /*设置 QQ 平台的 appID*/ appSecret:nil redirectURL:@"http://mobile.umeng.com/social"]; // 设置新浪的 appKey 和 appSecret [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_Sina appKey:@"3921700954" appSecret:@"04b48b094faeb16683c32669824ebdad" redirectURL:@"https://sns.whalecloud.com/sina2/callback"]; // 钉钉的 appKey [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_DingDing appKey:@"dingoalmlnohc0wggfedpk" appSecret:nil redirectURL:nil]; // 支付宝的 appKey [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_AlipaySession appKey:@"2015111700822536" appSecret:nil redirectURL:@"http://mobile.umeng.com/social"]; // 设置易信的 appKey [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_YixinSession appKey:@"yx35664bdff4db42c2b7be1e29390c1a06" appSecret:nil redirectURL:@"http://mobile.umeng.com/social"]; // 设置点点虫(原来往)的 appKey 和 appSecret [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_LaiWangSession appKey:@"8112117817424282305" appSecret:@"9996ed5039e641658de7b83345fee6c9" redirectURL:@"http://mobile.umeng.com/social"]; // 设置领英的 appKey 和 appSecret [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_Linkedin appKey:@"81t5eiem37d2sc" appSecret:@"7dgUXPLH8kA8WHMV" redirectURL:@"https://api.linkedin.com/v1/people"]; // 设置 Facebook 的 appKey 和 UrlString [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_Facebook appKey:@"506027402887373" appSecret:nil redirectURL:@"http://www.umeng.com/social"]; // 设置 Pinterest 的 appKey [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_Pinterest appKey:@"4864546872699668063" appSecret:nil redirectURL:nil]; // dropbox 的 appKey [[UMSocialManager defaultManager] setPlaform: UMSocialPlatformType_DropBox appKey:@"k4pn9gdwygpy4av" appSecret:@"td28zkbyb9p49xu" redirectURL:@"https://mobile.umeng.com/social"]; // vk 的 appkey [[UMSocialManager defaultManager] setPlaform:UMSocialPlatformType_VKontakte appKey:@"5786123" appSecret:nil redirectURL:nil]; return YES; } //#define __IPHONE_10_0 100000 #if __IPHONE_OS_VERSION_MAX_ALLOWED > 100000 - (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options { BOOL result = [[UMSocialManager defaultManager] handleOpenURL:url]; if (!result) { // 其他如支付等SDK的回调 } return result; } #endif - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation { BOOL result = [[UMSocialManager defaultManager] handleOpenURL:url]; if (!result) { // 其他如支付等SDK的回调 } return result; } - (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url { BOOL result = [[UMSocialManager defaultManager] handleOpenURL:url]; if (!result) { // 其他如支付等SDK的回调 } return result; }
-
ViewController.m
#import <UMSocialCore/UMSocialCore.h> #import <UShareUI/UShareUI.h> #pragma mark - 第三方平台登录 - (IBAction)loginButtonClick:(UIButton *)sender { [self getUserInfoForPlatform:UMSocialPlatformType_WechatSession]; } - (void)getUserInfoForPlatform:(UMSocialPlatformType)platformType { [[UMSocialManager defaultManager] getUserInfoWithPlatform:platformType currentViewController:self completion:^(id result, NSError *error) { UMSocialUserInfoResponse *resp = result; // 第三方登录数据(为空表示平台未提供) // 授权数据 NSLog(@" uid: %@", resp.uid); NSLog(@" openid: %@", resp.openid); NSLog(@" accessToken: %@", resp.accessToken); NSLog(@" refreshToken: %@", resp.refreshToken); NSLog(@" expiration: %@", resp.expiration); // 用户数据 NSLog(@" name: %@", resp.name); NSLog(@" iconurl: %@", resp.iconurl); NSLog(@" gender: %@", resp.gender); // 第三方平台 SDK 原始数据 NSLog(@" originalResponse: %@", resp.originalResponse); }]; } #pragma mark - 第三方平台分享 - (IBAction)shareButtonClick:(UIButton *)sender { [self showShareMenuView]; } - (void)showShareMenuView { // 设置平台顺序,只显示设置列表中的应用 [UMSocialUIManager setPreDefinePlatforms:@[@(UMSocialPlatformType_Sina), @(UMSocialPlatformType_QQ), @(UMSocialPlatformType_WechatSession), @(UMSocialPlatformType_AlipaySession)]]; // 设置分享面板位置,底部 默认 [UMSocialShareUIConfig shareInstance].sharePageGroupViewConfig.sharePageGroupViewPostionType = UMSocialSharePageGroupViewPositionType_Bottom; // 设置分享按钮背景形状,有图片 没有圆背景 [UMSocialShareUIConfig shareInstance].sharePageScrollViewConfig.shareScrollViewPageItemStyleType = UMSocialPlatformItemViewBackgroudType_None; // 添加自定义分享按钮 [UMSocialUIManager addCustomPlatformWithoutFilted:UMSocialPlatformType_UserDefine_Begin+2 withPlatformIcon:[UIImage imageNamed:@"icon_circle"] withPlatformName:@"演示 icon"]; // 显示分享面板 [UMSocialUIManager showShareMenuViewInWindowWithPlatformSelectionBlock:^(UMSocialPlatformType platformType, NSDictionary *userInfo) { // 根据获取的 platformType 确定所选平台进行下一步操作 [self shareTextToPlatformType:platformType]; // 在回调里面获得点击的 if (platformType == UMSocialPlatformType_UserDefine_Begin+2) { NSLog(@"点击演示添加 Icon 后该做的操作"); dispatch_async(dispatch_get_main_queue(), ^{ UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"添加自定义 icon" message:@"具体操作方法请参考 UShareUI 内接口文档" delegate:nil cancelButtonTitle:NSLocalizedString(@"确定", nil) otherButtonTitles:nil]; [alert show]; }); } else { } }]; } // 设置分享内容 - (void)shareTextToPlatformType:(UMSocialPlatformType)platformType { // 创建分享消息对象 UMSocialMessageObject *messageObject = [UMSocialMessageObject messageObject]; // 设置文本 messageObject.text = @"社会化组件 UShare 将各大社交平台接入您的应用,快速武装 App。"; // 调用分享接口,进行分享 [[UMSocialManager defaultManager] shareToPlatform:platformType messageObject:messageObject currentViewController:self completion:^(id data, NSError *error) { if (error) { NSLog(@"************ Share fail with error %@ *********",error); }else{ NSLog(@"response data is %@",data); } }]; }