ShareSDK.h
4.72 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
//
// ShareSDK.h
// ShareSDK
//
// Created by 冯 鸿杰 on 15/2/5.
// Copyright (c) 2015年 掌淘科技. All rights reserved.
//
#import <Foundation/Foundation.h>
#import "NSMutableDictionary+SSDKInit.h"
#import "NSMutableDictionary+SSDKShare.h"
#import "SSDKTypeDefine.h"
#import "SSDKUserQueryConditional.h"
#import "SSDKContentEntity.h"
#import "SSDKUser.h"
#import "SSDKCredential.h"
#import "SSDKAuthViewStyle.h"
/**
* ShareSDK APIs
*/
@interface ShareSDK : NSObject
#pragma mark - 初始化
/**
* 初始化ShareSDK应用
*
* @param appKey ShareSDK应用标识，可在http://mob.com中登录并创建App后获得。
* @param activePlatforms 使用的分享平台集合，如:@[@(SSDKPlatformTypeSinaWeibo), @(SSDKPlatformTypeTencentWeibo)];
* @param connectHandler 导入回调处理，当某个平台的功能需要依赖原平台提供的SDK支持时，需要在此方法中对原平台SDK进行导入操作。具体的导入方式可以参考ShareSDKConnector.framework中所提供的方法。
* @param configurationHandler 配置回调处理，在此方法中根据设置的platformType来填充应用配置信息
*/
+ (void)registerApp:(NSString *)appKey
activePlatforms:(NSArray *)activePlatforms
onImport:(SSDKImportHandler)importHandler
onConfiguration:(SSDKConfigurationHandler)configurationHandler;
#pragma mark - 授权
/**
* 分享平台授权
*
* @param platformType 平台类型
* @param @param settings 授权设置,目前只接受SSDKAuthSettingKeyScopes属性设置，如新浪微博关注官方微博：@{SSDKAuthSettingKeyScopes : @[@"follow_app_official_microblog"]}，类似“follow_app_official_microblog”这些字段是各个社交平台提供的。
* @param stateChangeHandler 授权状态变更回调处理
*/
+ (void)authorize:(SSDKPlatformType)platformType
settings:(NSDictionary *)settings
onStateChanged:(SSDKAuthorizeStateChangedHandler)stateChangedHandler;
/**
* 判断分享平台是否授权
*
* @param platformType 平台类型
* @return YES 表示已授权，NO 表示尚未授权
*/
+ (BOOL)hasAuthorized:(SSDKPlatformType)platformTypem;
/**
* 取消分享平台授权
*
* @param platformType 平台类型
*/
+ (void)cancelAuthorize:(SSDKPlatformType)platformType;
#pragma mark - 用户
/**
* 获取授权用户信息
*
* @param platformType 平台类型
* @param stateChangeHandler 状态变更回调处理
*/
+ (void)getUserInfo:(SSDKPlatformType)platformType
onStateChanged:(SSDKGetUserStateChangedHandler)stateChangedHandler;
/**
* 获取用户信息
*
* @param platformType 平台类型
* @param conditional 查询条件，如果为nil则获取当前授权用户信息
* @param stateChangeHandler 状态变更回调处理
*/
+ (void)getUserInfo:(SSDKPlatformType)platformType
conditional:(SSDKUserQueryConditional *)conditional
onStateChanged:(SSDKGetUserStateChangedHandler)stateChangedHandler;
/**
* 添加/关注好友
*
* @param platformType 平台类型
* @param user 添加/关注用户信息，注：用户信息中的Id或者name项必须有一项填写（不同平台要求不一样），其他字段可选填
* @param stateChangedHandler 状态变更回调处理
*/
+ (void)addFriend:(SSDKPlatformType)platformType
user:(SSDKUser *)user
onStateChanged:(SSDKAddFriendStateChangedHandler)stateChangedHandler;
/**
* 获取好友列表
*
* @param platformType 平台类型
* @param cursor 分页游标
* @param size 分页大小
* @param stateChangeHandler 状态变更回调处理
*/
+ (void)getFriends:(SSDKPlatformType)platformType
cursor:(NSUInteger)cursor
size:(NSUInteger)size
onStateChanged:(SSDKGetFriendsStateChangedHandler)stateChangedHandler;
#pragma mark - 分享
/**
* 分享内容
*
* @param platformType 平台类型
* @param parameters 分享参数
* @param stateChangeHandler 状态变更回调处理
*/
+ (void)share:(SSDKPlatformType)platformType
parameters:(NSMutableDictionary *)parameters
onStateChanged:(SSDKShareStateChangedHandler)stateChangedHandler;
/**
* 使用配置文件的方式分享
*
* @param contentName ShareContent.xml内<Content>标签name属性的值
* @param platformType 平台类型
* @param customFields 自定义字段
* @param stateChangedHandler 状态变更回调处理
*/
+ (void)shareWithContentName:(NSString *)contentName
platform:(SSDKPlatformType)platformType
customFields:(NSDictionary *)customFields
onStateChanged:(SSDKShareStateChangedHandler)stateChangedHandler;
@end