iOS SDK API

SDK 接口说明

JSHAREService 类,包含分享 SDK 的所有接口。
JSHARELaunchConfig 类,分享 SDK 启动配置模型。
JSHAREMessage 类,分享参数说明。
JSHARESocial 类,社交平台授权信息模型。
JSHARESocialUserInfo 类,社交平台用户信息模型,继承于 JSHARESocial。

SDK 初始化

Method - setupWithConfig

接口说明

初始化接口,建议在 application:didFinishLaunchingWithOptions 中调用。

接口定义

+(void)setupWithConfig:(JSHARELaunchConfig *)config

参数说明

config:JSHARELaunchConfig 类。

调用示例

    JSHARELaunchConfig *config = [[JSHARELaunchConfig alloc] init];
    config.appKey = @"AppKey copied from JiGuang Portal application";
    config.SinaWeiboAppKey = @"374535501";
    config.SinaWeiboAppSecret = @"baccd12c166f1df96736b51ffbf600a2";
    config.SinaRedirectUri = @"https://www.jiguang.cn";
    config.QQAppId = @"1105864531";
    config.QQAppKey = @"glFYjkHQGSOCJHMC";
    config.WeChatAppId = @"wxa2ea563906227379";
    config.WeChatAppSecret = @"bb63c0a06bf0ee7f633a5bc44304d110";
    config.FacebookAppID = @"1847959632183996";
    config.FacebookDisplayName = @"JShareDemo";
    config.TwitterConsumerKey = @"4hCeIip1cpTk9oPYeCbYKhVWi";
    config.TwitterConsumerSecret = @"DuIontT8KPSmO2Y1oAvby7tpbWHJimuakpbiAUHEKncbffekmC";
    [JSHAREService setupWithConfig:config];

处理平台回调

Method - handleOpenUrl

接口说明

处理平台回调,必要;

接口定义

+(BOOL)handleOpenUrl:(NSURL *)url;

参数说明

url:在 Appdelegate 的 application:handleOpenURL: 中调用。不调用此接口 JSHARE 将无法提供分享回调。

调用示例

    - (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url{
    [JSHAREService handleOpenUrl:url];
    return YES;
    }

发起分享

Method - share

接口说明

调用此接口发起分享

接口定义

 +(void)share:(JSHAREMessage *)message
      handler:(JSHAREStateHandler)handler

参数说明

message:JSHAREMessage 类
handler:分享结果的回调。

调用示例

    JSHAREMessage *message = [JSHAREMessage message];
    message.text = @"欢迎使用极光社会化组件 JShare,SDK 包体积小,集成简单,支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.platform = JSHAREPlatformWechatSession;
    message.mediaType = JSHAREText;
    [JSHARESdk share:message handler:^(JSHAREState state, NSError *error) {
          NSLog(@"分享回调");
    }];

各平台分享参数说明

微信(包括微信好友、朋友圈、微信收藏)

1)分享文本

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREText
text NSString 分享文本 不超过10KB
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.platform = platform;
    message.mediaType = JSHAREText;

2)分享图片

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREImage
image NSData 图片 大小不能超过 10M,
    NSString *imageURL = @"http://img2.3lian.com/2014/f5/63/d/23.jpg";
    NSData *imageData = [NSData dataWithContentsOfURL:[NSURL URLWithString:imageURL]];
    message.mediaType = JSHAREImage;
    message.platform = platform;
    message.image = imageData;

3)分享音乐

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREAudio
title NSString 音乐标题 长度不能超过 512
text NSString 音乐描述 长度不能超过 1K
mediaDataUrl NSString 音乐资源 Url 点击播放按钮可直接播放 url ,长度不能超过 10K
Url String 跳转Url 点击跳转页面 url,长度不能超过 10K
thumbnail NSDate 缩略图 大小不能超过 32K,
    message.mediaType = JSHAREAudio;
    message.url =  @"https://y.qq.com/n/yqq/song/003RCA7t0y6du5.html";
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.title = @"欢迎使用极光社会化组件JShare";

4)分享视频

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREVideo
title NSString 音乐标题 长度不能超过 512
text NSString 音乐描述 长度不能超过 1K
Url NSString 跳转Url 点击跳转页面 url,长度不能超过 10K
thumbnail NSDate 缩略图 大小不能超过 32K,
    message.mediaType = JSHAREVideo;
    message.url =@"http://v.youku.com/v_show/id_XOTQwMDE1ODAw.html?from=s1.8-1-1.2&spm=a2h0k.8191407.0.0";
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.title = @"欢迎使用极光社会化组件JShare";

5)分享网页

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHARELink
title NSString 标题 长度不能超过 512
text NSString 描述 长度不能超过 1K
Url NSString 跳转Url 点击跳转页面 url,长度不能超过 10K
thumbnail NSDate 缩略图 不超过32K,当分享JSHARELink类型时没有提供缩略图时,若image参数不为空,JSHARE将会裁剪此参数提供的图片去适配缩略图。
    message.mediaType = JSHARELink;
    message.url = @"https://www.jiguang.cn/";
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.title = @"欢迎使用极光社会化组件JShare";
    message.platform = platform;
    NSString *imageURL = @"http://img2.3lian.com/2014/f5/63/d/23.jpg";
    NSData *imageData = [NSData dataWithContentsOfURL:[NSURL URLWithString:imageURL]];

    message.image = imageData;

6)分享Emoji表情(朋友圈、微信收藏不支持)

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREEmoticon
emoticonData NSData 表情 大小不能超过 10M,
    message.mediaType = JSHAREEmoticon;
    NSString *filePath = [[NSBundle mainBundle] pathForResource:@"res6" ofType:@"gif"];
    NSData *emoticonData = [NSData dataWithContentsOfFile:filePath];
    message.emoticonData = emoticonData;

7)分享文件(朋友圈不支持)

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREFile
fileData NSData 文件的数据 大小不能超过10M
fileExt NSString 文件后缀名 最大 64 字符
    message.mediaType = JSHAREFile;
    NSString *filePath = [[NSBundle mainBundle] pathForResource:@"jiguang" ofType:@"mp4"];
    NSData *fileData = [NSData dataWithContentsOfFile:filePath];
    message.fileData = fileData;
    message.fileExt = @"mp4";
    message.platform = platform;
    message.title = @"jiguang.mp4";

8)分享app(微信收藏不支持)

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREApp
title NSString 标题 长度不能超过 512
text NSString 描述 长度不能超过 1K
Url NSString 跳转Url 点击跳转页面 url,长度不能超过 10K
extInfo NSString 第三方程序自定义的简单数据。
fileData NSData 对应APP的数据 大小不能超过10M
    message.mediaType = JSHAREApp;
    message.url =@"https://www.jiguang.cn/";
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.title = @"欢迎使用极光社会化组件JShare";
    message.extInfo = @"<xml>extend info</xml>";
    message.fileData = data;
    message.platform = platform;

QQ

1)分享文本

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREText
text NSString 分享文本 最大 1536 字符
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.platform = platform;
    message.mediaType = JSHAREText;

2)分享图片

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREImage
image NSData 图片 大小不能超过 5 M,
text NSString 分享内容的描述 最大 512 字符
    NSString *imageURL = @"http://img2.3lian.com/2014/f5/63/d/23.jpg";
    NSData *imageData = [NSData dataWithContentsOfURL:[NSURL URLWithString:imageURL]];

    message.mediaType = JSHAREImage;
    message.platform = platform;
    message.image = imageData;

3)分享链接

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHARELink
title NSString 标题 长度不能超过 128
text NSString 描述 长度不能超过 512
Url NSString 跳转Url 点击跳转页面 url,长度不能超过 512
thumbnail NSDate 缩略图 不超过1M,当分享时没有提供缩略图时,若image参数不为空,JSHARE将会裁剪此参数提供的图片去适配缩略图。
     message.mediaType = JSHARELink;
    message.url = @"https://www.jiguang.cn/";
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.title = @"欢迎使用极光社会化组件JShare";
    message.platform = platform;
    NSString *imageURL = @"http://img2.3lian.com/2014/f5/63/d/23.jpg";
    NSData *imageData = [NSData dataWithContentsOfURL:[NSURL URLWithString:imageURL]];

    message.image = imageData;

4)分享音乐

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREAudio
title NSString 标题 长度不能超过 128
text NSString 描述 长度不能超过 512
Url NSString 跳转Url 点击跳转页面 url,长度不能超过 512
thumbnail NSDate 缩略图 不超过1M,当分享时没有提供缩略图时,若image参数不为空,JSHARE将会裁剪此参数提供的图片去适配缩略图。
mediaDataUrl NSString 音乐资源 Url 点击播放按钮可直接播放 url
    message.mediaType = JSHAREAudio;
    message.url =  @"https://y.qq.com/n/yqq/song/003RCA7t0y6du5.html";
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.title = @"欢迎使用极光社会化组件JShare";

5)分享视频

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREVideo
title NSString 标题 长度不能超过 128
text NSString 描述 长度不能超过 512
Url NSString 跳转Url 点击跳转页面 url,长度不能超过 512
thumbnail NSDate 缩略图 不超过1M,当分享时没有提供缩略图时,若image参数不为空,JSHARE将会裁剪此参数提供的图片去适配缩略图。
    message.mediaType = JSHAREVideo;
    message.url =@"http://v.youku.com/v_show/id_XOTQwMDE1ODAw.html?from=s1.8-1-1.2&spm=a2h0k.8191407.0.0";
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.title = @"欢迎使用极光社会化组件JShare";

QQ空间

1)分享文本

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREText
text NSString 分享文本 最大 1536 字符
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.platform = platform;
    message.mediaType = JSHAREText;

2)分享图片

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREImage
image NSData 图片 大小不能超过 5 M,
images NSArray 图片 分享到 QQ 空间支持多张图片,图片数组的元素需要为 NSData 类型,图片数量限制为20张。若只分享单张图片至 QQ 空间使用 image 字段即可。,
    NSString *imageURL = @"http://img2.3lian.com/2014/f5/63/d/23.jpg";
    NSData *imageData = [NSData dataWithContentsOfURL:[NSURL URLWithString:imageURL]];

    message.mediaType = JSHAREImage;
    message.platform = platform;
    message.image = imageData;

3)分享链接

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHARELink
title NSString 标题 长度不能超过 128
text NSString 描述 长度不能超过 512
Url NSString 跳转Url 点击跳转页面 url,长度不能超过 512
thumbnail NSDate 缩略图 不超过1M,当分享没有提供缩略图时,若image参数不为空,JSHARE将会裁剪此参数提供的图片去适配缩略图。
     message.mediaType = JSHARELink;
    message.url = @"https://www.jiguang.cn/";
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.title = @"欢迎使用极光社会化组件JShare";
    message.platform = platform;
    NSString *imageURL = @"http://img2.3lian.com/2014/f5/63/d/23.jpg";
    NSData *imageData = [NSData dataWithContentsOfURL:[NSURL URLWithString:imageURL]];

    message.image = imageData;

4)分享音乐

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREAudio
title NSString 标题 长度不能超过 128
text NSString 描述 长度不能超过 512
Url NSString 跳转Url 点击跳转页面 url,长度不能超过 512
mediaDataUrl NSString 音乐数据url地址 长度不能超过 512
thumbnail NSDate 缩略图 不超过1M,当分享时没有提供缩略图时,若image参数不为空,JSHARE将会裁剪此参数提供的图片去适配缩略图。
    message.mediaType = JSHAREAudio;
    message.url =  @"https://y.qq.com/n/yqq/song/003RCA7t0y6du5.html";
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.title = @"欢迎使用极光社会化组件JShare";

5)分享视频

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREVideo
title NSString 标题 长度不能超过 128
text NSString 描述 长度不能超过 512
Url NSString 跳转Url 点击跳转页面 url,长度不能超过 512
thumbnail NSDate 缩略图 不超过1M,当分享时没有提供缩略图时,若image参数不为空,JSHARE将会裁剪此参数提供的图片去适配缩略图。
    message.mediaType = JSHAREVideo;
    message.url =@"http://v.youku.com/v_show/id_XOTQwMDE1ODAw.html?from=s1.8-1-1.2&spm=a2h0k.8191407.0.0";
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.title = @"欢迎使用极光社会化组件JShare";

6)分享本地视频

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREVideo
title NSString 标题 长度不能超过 128
text NSString 描述 长度不能超过 512
videoAssetURL NSString 本地视频AssetURL 分享本地视频到 QQ 空间的必填参数,可传ALAsset的ALAssetPropertyAssetURL,或者PHAsset的localIdentifier。
    message.mediaType = JSHAREVideo;
    message.text = @"欢迎使用极光社会化组件JShare,SDK包体积小,集成简单,支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.title = @"欢迎使用极光社会化组件JShare";
    message.videoAssetURL = assetURL.absoluteString;
    message.platform = JSHAREPlatformQzone;

新浪微博

1)分享文本

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREText
text NSString 分享文本 不超过140
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.platform = platform;
    message.mediaType = JSHAREText;

2)分享图片

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREImage
image NSData 图片 大小不能超过 10 M,
text NSString 分享内容的描述 不超过140
    NSString *imageURL = @"http://img2.3lian.com/2014/f5/63/d/23.jpg";
    NSData *imageData = [NSData dataWithContentsOfURL:[NSURL URLWithString:imageURL]];

    message.mediaType = JSHAREImage;
    message.platform = platform;
    message.image = imageData;

3)分享链接

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHARELink
title NSString 标题 长度不能超过 1 K
text NSString 描述 长度不能超过 140
Url NSString 跳转Url 最大 512 字符。
thumbnail NSDate 缩略图 大小小于32k,当分享没有提供缩略图时,若image参数不为空,JSHARE将会裁剪此参数提供的图片去适配缩略图。
     message.mediaType = JSHARELink;
    message.url = @"https://www.jiguang.cn/";
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.title = @"欢迎使用极光社会化组件JShare";
    message.platform = platform;
    NSString *imageURL = @"http://img2.3lian.com/2014/f5/63/d/23.jpg";
    NSData *imageData = [NSData dataWithContentsOfURL:[NSURL URLWithString:imageURL]];

    message.image = imageData;

新浪微博私信

1)分享链接

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHARELink
title NSString 标题 长度不能超过 1 K,且不为空
text NSString 描述 长度不能超过 1 K
Url NSString 跳转Url 最大 512 字符。
thumbnail NSDate 缩略图 大小小于32k,当分享没有提供缩略图时,若image参数不为空,JSHARE将会裁剪此参数提供的图片去适配缩略图。
    message.mediaType = JSHARELink;
    message.url = @"https://www.jiguang.cn/";
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.title = @"欢迎使用极光社会化组件JShare";
    message.platform = JSHAREPlatformSinaWeiboContact;
    NSString *imageURL = @"http://img2.3lian.com/2014/f5/63/d/23.jpg";
    NSData *imageData = [NSData dataWithContentsOfURL:[NSURL URLWithString:imageURL]];

    message.image = imageData;

Facebook, Facebook Messenger

1)分享文本 (Messenger 不支持)

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREText
text NSString 分享文本
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.platform = platform;
    message.mediaType = JSHAREText;

2)分享图片

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREImage
images NSArray 图片 图片数量限制为6张。如果分享单张图片,图片大小建议不要超过12M;如果分享多张图片,每张图片大小建议不要超过700K,
text NSString 文本
    message.text = [NSString stringWithFormat:@"时间:%@ JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!",[self localizedStringTime]];
    NSData *imageData = [NSData dataWithContentsOfURL:[NSURL URLWithString:imageURL]];
    message.images = @[imageData,imageData];
    message.mediaType = JSHAREImage;
    message.platform = platform;

3)分享视频

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREVideo
text NSString 文本
videoAssetURL NSString 视频参数 分享到视频类型至 facebook 、facebookMessenger 只能识别 ALAsset 的ALAssetPropertyAssetURL。
    message.mediaType = JSHAREVideo;
    message.text = @"欢迎使用极光社会化组件JShare,SDK包体积小,集成简单,支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.videoAssetURL = assetURL.absoluteString;
    message.platform = platform;

4)分享链接

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHARELink
text NSString 描述
Url NSString 跳转Url 分享点击跳转的 url
    message.mediaType = JSHARELink;
    message.url = @"https://www.jiguang.cn/";
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.platform = platform;

Twitter

1)分享文本

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREText
text NSString 分享文本
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.platform = platform;
    message.mediaType = JSHAREText;

2)分享图片

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREImage
image NSData 图片 单张图片大小不能超过 5 M,
images NSArray 图片 分享多张图片用images ,图片数组的元素需要为 NSData 类型,图片数量限制为4张。
text NSString 文本 最大 140 个汉字
    NSString *imageURL = @"http://img2.3lian.com/2014/f5/63/d/23.jpg";
    NSData *imageData = [NSData dataWithContentsOfURL:[NSURL URLWithString:imageURL]];
    message.image = imageData;
    message.mediaType = JSHAREImage;
    message.platform = platform;

3)分享视频

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHAREVideo
text NSString 文本 最大 140 个汉字
videoData NSData 视频参数 分享到 twitter 的视频,大小不应超过15 mb , 时间应该在0.5秒到30秒之间,尺寸应该在32x32和1280x1024之间 , 长宽比应在1:3和3:1之间
    message.mediaType = JSHAREVideo;
    message.text = [NSString stringWithFormat:@"时间:%@ JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!",
    NSString *path = [[NSBundle mainBundle] pathForResource:@"jiguangVideoForTwitter" ofType:@"mp4"];
    NSData *data = [NSData dataWithContentsOfFile:path];
    message.videoData = data;
    message.platform = JSHAREPlatformTwitter;

4)分享链接

参数 是否必须 参数类型 参数说明 备注
mediaType NS_ENUM 分享类型 JSHARELink
text NSString 描述 url 和 text 的总长度不能超过280个字节。
Url NSString 跳转Url url 和 text 的总长度不能超过280个字节,可以带有图片或视频,但是不能同时带图片和视频。
videoData NSData 视频参数 分享到 twitter 的视频,大小不应超过15 mb。
image NSData 图片 单张图片大小不能超过 5 M,
images NSArray 图片 分享多张图片用images ,图片数组的元素需要为 NSData 类型,图片数量限制为4张。
    message.mediaType = JSHARELink;
    message.url = @"https://www.jiguang.cn/";
    message.text = @"JShare SDK支持主流社交平台、帮助开发者轻松实现社会化功能!";
    message.platform = platform;
    NSString *imageURL = @"http://img2.3lian.com/2014/f5/63/d/23.jpg";
    NSData *imageData = [NSData dataWithContentsOfURL:[NSURL URLWithString:imageURL]];
    message.image = imageData;

参数的具体使用可参考Demo。

检查不存在新浪客户端情况的网页端是否登陆

+(BOOL)isSinaWeiboWebLogined

登出新浪网页端最新帐号

+(BOOL)sinaWeiboWebLogOut

检查是否存在微信客户端

+(BOOL)isWeChatInstalled

检查是否存在 QQ 客户端

+(BOOL)isQQInstalled

检查是否存在新浪微博客户端

+(BOOL)isSinaWeiBoInstalled

检查是否存在 Facebook 客户端

+(BOOL)isFacebookInstalled

检查是否存在 Messenger 客户端

+(BOOL)isFacebookMessengerInstalled

检查是否存在 Twitter 客户端

+(BOOL)isTwitterInstalled

获取社交平台用户信息

method - getSocialUserInfo

接口定义

+(void)getSocialUserInfo:(JSHAREPlatform)platform handler:(JSHARESocialHandler)handler

接口说明

通过调用获取用户信息接口,获取用户在第三方平台的用户 ID、头像等资料完成账号体系的构建。

参数说明

  • platform : JSHAREPlatform 枚举类型
  • handler : JSHARESocialHandler 获取用户信息的回调

调用实例

[JSHAREService getSocialUserInfo:platfrom handler:^(JSHARESocialUserInfo *userInfo, NSError *error) {
        NSString *alertMessage;
        NSString *title;
        if (error) {
            title = @"失败";
            alertMessage = @"无法获取到用户信息";
        }else{
            title = userInfo.name;
            alertMessage = [NSString stringWithFormat:@"昵称: %@\n 头像链接: %@\n 性别: %@\n",userInfo.name,userInfo.iconurl,userInfo.gender == 1? @"男" : @"女"];
        }
        UIAlertView *Alert = [[UIAlertView alloc] initWithTitle:title message:alertMessage delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil];
        dispatch_async(dispatch_get_main_queue(), ^{
            [Alert show];
        });


    }];

method - isPlatformAuth

接口定义

+(BOOL)isPlatformAuth:(JSHAREPlatform)platform

接口说明

检查用户授权之后信息是否过期。注意:仅仅检验本地 token 是否在有效期内,假如对应的社交平台用户在社交平台手动取消了授权,即使本地 token 还在有效期内,但是还是失效的。

参数说明

  • platform: 社交平台枚举

调用实例

BOOL isOauth = [JSHAREService isPlatformAuth:JSHAREPlatformQQ];

method - cancelAuthWithPlatform

接口定义

+(BOOL)cancelAuthWithPlatform:(JSHAREPlatform)platfrom

接口说明

删除用户授权之后的储存在本地的授权信息。

参数说明

  • platform: 社交平台枚举

调用实例

BOOL cancelOauth = [JSHAREService cancelAuthWithPlatform:JSHAREPlatformQQ];
;

日志等级设置

Method - setDebug

接口说明

设置是否打印 sdk 产生的 Debug 级 log 信息, 默认为 NO (不打印 Debug 级 log)

接口定义

+(void)setDebug:(BOOL)enable

参数说明

enable:设置为 YES 开启,设置为 NO 关闭

调用示例

[JSHAREService setDebug:YES];

Copyright 2011-2017, jiguang.cn, All Rights Reserved.
粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

Documentation built with MkDocs.