您的位置：首页 > 其它

UM分享 - 详解

2015-10-22 19:17 295 查看
官网: http://dev.umeng.com
友盟现在发展的很壮大! 有熟为人知的社会化分享\统计分析\消息推送\即时通信\自动更新\多媒体服务等功能, 今天就其中第一项 分享功能, 做出分解.

1. 准备工作

1.1 注册账号, 添加App, 可以得到唯一的AppKey: 比如 562795cbe0f55a6cd7006d1a;1.2 下载最新版的SDK, 解压SDK压缩包，将形如UMSocial_Sdk_x.x.x的文件夹拖入工程目录;　　UMSocial_Sdk_x.x.x 文件夹的目录结构
文件或文件夹含义
libUMSocial_Sdk_x.x.x.a, libUMSocial_Sdk_Comment_3.0.a库文件
Header头文件
SocialSDKXibxib文件
en.lproj，zh-Hans.lproj英文和中文语言文件
frameworks使用的第三方SDK，里面的Wechat 代表微信SDK
　　UMSocial_Sdk_Extra_Frameworks 文件夹的目录结构
文件或文件夹含义
TencentOpenAPIQQ互联SDK
FacebookFacebook SDK
LaiWang来往 SDK
UMSocialYiXin.framework易信 SDK
UMSocial_ScreenShot_Sdk截屏 SDK
UMSocial_Shake_Sdk摇一摇 SDK

　　注意: 1.若你的工程设置了all_load,需要添加手机QQ SDK需要的系统framework:
Security.frameworklibiconv.dylibSystemConfiguration.frameworkCoreGraphics.frameworklibsqlite3.dylibCoreTelephony.frameworklibstdc++.dyliblibz.dylib1.3 添加SDK后需要手动添加系统库SystemConfiguration.framework

2. 配置代码

2.1 在AppDelegate内设置友盟AppKey
#import "UMSocial.h"
……
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
[UMSocialData setAppKey:@"507fcab25270157b37000010"];
}

2.2添加实现代码打开需要集成分享功能的视图源码
UIViewController.m
，把如下代码复制并粘贴到你将弹出一个分享列表的位置，例如到响应分享按钮的方法中。并且修改下面的友盟appkey，你要分享的文字、图片，你要分享到的微博平台，例如下面写的是新浪微博、腾讯微博、人人网。
#import "UMSocial.h"
……
//注意：分享到微信好友、微信朋友圈、微信收藏、QQ空间、QQ好友、来往好友、来往朋友圈、易信好友、易信朋友圈、Facebook、Twitter、Instagram等平台需要参考各自的集成方法
[UMSocialSnsService presentSnsIconSheetView:self
appKey:@"507fcab25270157b37000010"
shareText:@"你要分享的文字"
shareImage:[UIImage imageNamed:@"icon.png"]
shareToSnsNames:[NSArray arrayWithObjects:UMShareToSina,UMShareToTencent,UMShareToRenren,nil]
delegate:self];

实现回调方法（可选）:
-(void)didFinishGetUMSocialDataInViewController:(UMSocialResponseEntity *)response
{
//根据`responseCode`得到发送结果,如果分享成功
if(response.responseCode == UMSResponseCodeSuccess)
{
//得到分享到的微博平台名
NSLog(@"share to sns name is %@",[[response.data allKeys] objectAtIndex:0]);
}
}

形参名含义
controller分享列表页面所在的UIViewController对象
appKey友盟appKey，如果你在其他地方用
UMSocialData
设置了appKey，这里也可以传nil
shareText分享编辑页面的内嵌文字
shareImage分享编辑页面的内嵌图片，用户可以在编辑页面中删除。如果你不需要分享图片，可以传入
nil
shareToSnsNames定义列表出现的微博平台字符串构成的数组，字符变量名为UMShareToSina、UMShareToTencent、UMShareToWechatSession、UMShareToWechatTimeline、UMShareToQzone、UMShareToQQ、UMShareToRenren、UMShareToDouban、UMShareToEmail、UMShareToSms、UMShareToFacebook、UMShareToTwitter，分别代表新浪微博、腾讯微博、微信好友、微信朋友圈、QQ空间、手机QQ、人人网、豆瓣、电子邮箱、短信、Facebook、Twitter
delegate实现分享状态回调方法的对象，回调方法的实现可以参见分享详细说明的回调方法部分。如果你不需要回调的话，可以设为
nil

注意：
1 . 集成微信和手机QQ，请参考添加QQ及Qzone
2 . 弹出横屏页面必须要先使用如下设置屏幕方向的代码，再弹出分享列表页面：
[UMSocialConfig setSupportedInterfaceOrientations:UIInterfaceOrientationMaskLandscape];

// -------------------------- -------------------------- -------------------------- -------------------------- -------------------------- --------------------------完成以上两步, 就能实现基本的分享功能了,(新浪微博 - UMShareToSina, 腾讯微博 - UMShareToTencent,人人网 - UMShareToRenren, 豆瓣网 - UMShareToDouban,邮箱 - UMShareToEmail, 短信 - UMShareToSms,UMShareToFacebook,UMShareToTwitter,)[注意]: UMShareToFacebook,UMShareToTwitter - 预先需要登录账号, 才能完成分享.如果需要实现分享到其他平台的功能, 需要对对应的平台专门设置.

3. 集成 分享到微信

(微信好友列表 - UMShareToWechatSession, 微信朋友圈 - UMShareToWechatTimeline, 微信收藏 - UMShareToWechatFavorite)3.1 登录微信开发者, 注册 App (https://open.weixin.qq.com)　　注册App -- 审核成功后, 会生成 AppID , AppSecret, App Bundle Identifier;3.2 在系统中, 添加微信SDK库文件,( 
UMSocial_Sdk_Extra_Frameworks
目录下, 
Wechat
文件夹) 并手动添加依赖的系统库
SystemConfiguration.framework;
3.2 代码设置　　在你的程序APPdelegate入口方法添加下面的代码
#import "UMSocialWechatHandler.h"
//设置微信AppId、appSecret，分享url
[UMSocialWechatHandler setWXAppId:@"wxd930ea5d5a258f4f" appSecret:@"db426a9829e4b49a0dcac7b4162da6b6" url:@"http://www.umeng.com/social"];

[/code]如果不添加上面的代码，则分享列表中不会出现微信及朋友圈图标URL必须为http链接，如果设置为nil则默认为友盟官网链接3.3 Scheme URL配置　　在你的工程设置项,targets 一栏下,选中自己的 target,在 Info->URL Types 中添加 URL Schemes,添加xcode的url scheme为微信应用appId，例如“wxd9a39c7122aa6516”3.4 添加回调在APPdelegate中实现下面两个系统回调方法：
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url
{
return  [UMSocialSnsService handleOpenURL:url];
}
- (BOOL)application:(UIApplication *)application
openURL:(NSURL *)url
sourceApplication:(NSString *)sourceApplication
annotation:(id)annotation
{
return  [UMSocialSnsService handleOpenURL:url];
}

[注意]: 如果出现 LLVM - linker command error ; 请核查库文件意义 library search path 和 header search path;// ------------------ ------------------ ------------------ ------------------ ------------------ ------------------ ------------------ ------------------ ------------------

4. 分享到新浪微博

SSO授权, 在安装App的情况下, 不需要输入账号密码去申请授权.4.1 登录网站, 创建 App (http://open.weibo.com/development/mobile), App信息参考 (http://dev.umeng.com/social/ios/operation#2_2)　　生成: AppKey, AppSecret.　　[注意]: 安全域名设置必须为sns.whalecloud.com ; 回调地址在App设置中与代码中设置必须一致.4.2 添加相关库文件（使用微博原生SDK）-- 将
SinaSSO
文件夹添加到工程。设置: 在other linker flags增加 "-ObjC" 选项，并添加系统支持库: 
ImageIO.framework
4.3 配置URL schemes（使用微博原生SDK）　　在你的工程设置项,targets 一栏下,选中自己的 target,在 Info->URL Types 中添加 URL Schemes,格式为“wb”+新浪appkey，例如“wb126663232”4.4 添加SSO授权开关（使用微博原生SDK）　　在APPDelegate中集成新浪微博开关
#import "UMSocialSinaSSOHandler.h"
//打开新浪微博的SSO开关，设置新浪微博回调地址，这里必须要和你在新浪微博后台设置的回调地址一致。若在新浪后台设置我们的回调地址，“http://sns.whalecloud.com/sina2/callback”，这里可以传nil
[UMSocialSinaSSOHandler openNewSinaSSOWithRedirectURL:@"http://sns.whalecloud.com/sina2/callback"];
　[注意]: 回调URL必须和后台保持一致，否则会报错redirect URL mismatch

4.5 添加系统回调 （使用微博原生SDK）　　在APPdelegate中实现下面的回调方法
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url
{
return  [UMSocialSnsService handleOpenURL:url];
}
- (BOOL)application:(UIApplication *)application
openURL:(NSURL *)url
sourceApplication:(NSString *)sourceApplication
annotation:(id)annotation
{
return  [UMSocialSnsService handleOpenURL:url];
}

4.6 使用默认分享界面 设置分享使用友盟默认提供的分享面板，调用下面的代码
[UMSocialSnsService presentSnsIconSheetView:self
appKey:你的友盟应用Appkey
shareText:@"友盟社会化分享让您快速实现分享等社会化功能，http://umeng.com/social"
shareImage:[UIImage imageNamed:@"icon.png"]
shareToSnsNames:@[UMShareToSina]
delegate:self];
//实现回调方法（可选）：
-(void)didFinishGetUMSocialDataInViewController:(UMSocialResponseEntity *)response
{
//根据`responseCode`得到发送结果,如果分享成功
if(response.responseCode == UMSResponseCodeSuccess)
{
//得到分享到的微博平台名
NSLog(@"share to sns name is %@",[[response.data allKeys] objectAtIndex:0]);
}
}

// ----------------------- ----------------------- ----------------------- ----------------------- ----------------------- ----------------------- -----------------------5. 集成 QQ / QQZone5.1 注册应用　　使用QQ及Qzone分享首先在腾讯开放平台注册应用，地址：http://open.qq.com 按照要求填写，审核通过前需要添加测试账号，否则会报错110406或1104045.2 添加相关文件　　在
UMSocial_Sdk_Extra_Frameworks
目录下的，添加
TencentOpenAPI
文件夹到工程 添加下面几个系统framework　　　　在Xcode中打开工程配置文件，选择“summary”一栏。在“summary”中选择“Linked Frameworks and Libraries”一栏，点击“+”图标添加下面八个库文件，分别是Security.frameworklibiconv.dylibSystemConfiguration.frameworkCoreGraphics.Frameworklibsqlite3.dylibCoreTelephony.frameworklibstdc++.dyliblibz.dylib
5.3
添加QQ及Qzone到分享列表　　在AppDelegate应用入口方法打开集成手机QQ、Qzone开关
//设置分享到QQ/Qzone的应用Id，和分享url 链接
#import "UMSocialQQHandler.h"
[UMSocialQQHandler setQQWithAppId:@"100424468" appKey:@"c7394704798a158208a74ab60104f0ba" url:@"http://www.umeng.com/social"];

[/code]如果不添加上面的代码，则分享列表中不会出现QQ及Qzone图标URL必须为http链接，如果设置为nil则默认为友盟官网链接5.3 配置URL schemes在你的工程设置项,targets 一栏下,选中自己的 target,在 Info->URL Types 中添加 URL Schemes,设置Xcode的url scheme格式为“QQ”+腾讯QQ互联应用appId转换成十六进制（不足8位前面补0），例如“QQ05FC5B14”。并在QQ互联后台的URL schema中填入此字符串保持一致。 额外设置 url schemes 的格式为"tencent"+腾讯QQ互联应用appId,例如“tencent100424468”如果 URL schemes 配置错误，则分享完成后无法返回应用[注意]: 在Xcode 6.0创建工程时，默认可能没有单独设置Bundle display name属性值。但是因为SDK需要用到Bundle display name的值，所以务必请检查确保这个属性存在，如果没有请添加上。5.4 添加系统回调　　在APPdelegate中实现下面的方法
- (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url
{
return  [UMSocialSnsService handleOpenURL:url];
}
- (BOOL)application:(UIApplication *)application
openURL:(NSURL *)url
sourceApplication:(NSString *)sourceApplication
annotation:(id)annotation
{
return  [UMSocialSnsService handleOpenURL:url];
}

5.5 设置分享内容默认分享样式 - 使用友盟默认分UI界面，添加下面代码
    [UMSocialSnsService presentSnsIconSheetView:self
appKey:你的友盟应用Appkey
shareText:@"友盟社会化分享让您快速实现分享等社会化功能，www.umeng.com/social"
shareImage:[UIImage imageNamed:@"icon.png"]
shareToSnsNames:@[UMShareToQQ,UMShareToQzone]
delegate:self];
//实现回调方法（可选）：
-(void)didFinishGetUMSocialDataInViewController:(UMSocialResponseEntity *)response
{
//根据`responseCode`得到发送结果,如果分享成功
if(response.responseCode == UMSResponseCodeSuccess)
{
//得到分享到的微博平台名
NSLog(@"share to sns name is %@",[[response.data allKeys] objectAtIndex:0]);
}
}[注意]: Qzone分享文字与图片缺一不可，否则会出现错误码10001//// /////////////////////////  ----  就到这里

 http://dev.umeng.com/social/ios/feature 
                                            

                                        

                        
                        内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 点击这里给我发消息 
                    

                    

                    

                        

                         标签： 
                                                

                        

                    


                

            


            

                
相关文章推荐

                

                
            

        

        

            

            
            

                

                    
新的分享

                    

                        
                    

                

            


            

                

                    
章节导航