操作栏 集成指南

1 产品概述

通过社会化操作栏,您可以快速整合评论,分享,喜欢,登录等组件。社会化操作栏会增强用户和应用的交互频率,提高用户的活跃率和留存率。

2 下载并安装SDK

Step1

下载 最新版SDK

Step2

确认你使用的XCode版本在4.4以上,工程的Base SDK和iOS Deployment Target在iOS4.3以上

Step3

解压SDK压缩包,将其中形如UMSocial_Sdk_x.x.x的文件夹拖入工程目录:

alt text

Step4

确认勾选了“Copy items to destination's group folder”选项,并选择你要添加到的Target:

alt text

现在应该是这样的效果:

alt text

3 集成代码

设置友盟Appkey

#import "UMSocial.h"
……
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    [UMSocialData setAppKey:@"507fcab25270157b37000010"];
}

社会化操作栏

使用社会化操作栏非常简单——实例化一个“社会化操作服务”,并将其“社会化操作栏”变量添加到您的视图控制器中即可。代码如下:

  - (void)viewDidLoad{
    [super viewDidLoad];
    //设置分享内容,例如一本书的标题、一首歌的歌名
    UMSocialData *socialData = [[UMSocialData alloc] initWithIdentifier:@"title"];    
    UMSocialBar  *socialBar = [[UMSocialBar alloc] initWithUMSocialData:socialData withViewController:self];
    socialBar.center = CGPointMake(160, 390);
    [self.view addSubview:socialBar];
}  

socialbar

这是个放置在APP底部的通用工具栏,它为用户提供了针对特定内容页的一站式社会化功能(评论、喜欢、分享、个人中心4个功能)。

4 常见错误代码含义

错误码 错误原因
500 给定uid的用户并不存在
501 绑定账户失败
502 解绑定失败
503 评论失败
504 获取评论失败
505 用户被加入黑名单
506 获取好友失败
507 获取授权url失败
508 解除授权失败
510 分享失败
511 获取bar失败
512 从平台获取用户信息失败
513 url跳转失败
514 从social获取用户信息失败
515 请求的参数错误
516 请求喜欢失败
517 版本号错误

分享错误代码

错误码 错误原因
5001 错误的友盟appkey,或者此appkey没有绑定任何平台.如果开发者绑定了,依然出现这个问题,让开发者再试一下,可能是刚绑定马上就测试的原因,最好等2分钟。
5002 这个友盟appkey已经被禁止
5003 请求的参数中没有uid
5004 未知的错误,具体的错误信息会在log的输出中
5005 访问频率超限,可一会儿再试
5006 请求参数中没有content字段
5007 请求参数中content字段的内容为空
5008 没有上传图片
5009 此友盟的appkey没有绑定对应平台的appkey和appsecret
5010 userid无效,这个用户并没有进行授权
5013 请求的参数中没有appkey这个字段
5014 没有对此用户进行授权
5024 获取access token失败,具体看log输出
5025 获取request token失败,具体看log输出
5027 授权已经过期