ShareSDK.h
4.3 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
//
// ShareSDK.h
// ShareSDK
//
// Created by 冯 鸿杰 on 15/2/5.
// Copyright (c) 2015年 掌淘科技. All rights reserved.
//
#import <Foundation/Foundation.h>
#import "SSDKRegister.h"
#import "NSMutableDictionary+SSDKShare.h"
#import "SSDKDataModel.h"
#import "SSDKUser.h"
#import "SSDKCredential.h"
#import "SSDKSession.h"
#import "SSDKImage.h"
#import "SSDKContentEntity.h"
#import "SSDKAuthViewStyle.h"
#import "NSMutableDictionary+SSDKInit.h" //Deprecated
#import "SSDKShareVideoModel.h"
/**
错误码
- 200000: 未知错误
- 200010: 网络不可用
- 200100: 未初始化平台
- 200101: 参数错误
- 200102: 不支持的分享类型
- 200103: 尚未设置URL Scheme
- 200104: 尚未安装客户端
- 200105: 不支持的功能
- 200201: SDK集成错误，缺少必要文件
- 200204: 授权Token过期
- 200205: 用户尚未授权
- 200300: 第三方SDK Api返回错误
- 200301: 第三方SDK 回调错误
- 200302: API请求失败
- 200303: try块捕捉到异常
- 200500: 权限拒绝
- 200501: 隐私协议未同意
*/
/**
* ShareSDK APIs
*/
@interface ShareSDK : NSObject
#pragma mark - 初始化
/**
ShareSDK 平台注册方法
@param importHandler 用于设置各平台注册信息，也可在mob管理后台进行注册
*/
+ (void)registPlatforms:(void(^)(SSDKRegister *platformsRegister))importHandler;
#pragma mark - 授权
/**
授权
@param platformType 平台类型
@param settings 授权设置,接受scopes属性设置，如新浪微博关注官方微博：@{@"scopes" : @[@"follow_app_official_microblog"]}，类似“follow_app_official_microblog”这些字段是各个社交平台提供的。QQ平台如设置二维码授权,添加字段为QQAuthType：@{@"QQAuthType":@1}, 0为网页账号密码登录授权
@param stateChangedHandler 授权状态变更回调处理
@return 会话id
*/
+ (SSDKSession *)authorize:(SSDKPlatformType)platformType
settings:(NSDictionary *)settings
onStateChanged:(SSDKAuthorizeStateChangedHandler)stateChangedHandler;
/**
* 判断分享平台是否授权
*
* @param platformTypem 平台类型
* @return YES 表示已授权，NO 表示尚未授权
*/
+ (BOOL)hasAuthorized:(SSDKPlatformType)platformTypem;
/**
* 取消分享平台授权
*
* @param platformType 平台类型
*/
+ (void)cancelAuthorize:(SSDKPlatformType)platformType result:(void(^)(NSError *error))result;
#pragma mark - 用户
/**
获取授权用户信息
@param platformType 平台类型
@param stateChangedHandler 状态变更回调处理
*/
+ (SSDKSession *)getUserInfo:(SSDKPlatformType)platformType
onStateChanged:(SSDKGetUserStateChangedHandler)stateChangedHandler;
#pragma mark - 分享
/**
分享内容
@param platformType 平台类型
@param parameters 分享参数
@param stateChangedHandler 状态变更回调处理
@return 会话
*/
+ (SSDKSession *)share:(SSDKPlatformType)platformType
parameters:(NSMutableDictionary *)parameters
onStateChanged:(SSDKShareStateChangedHandler)stateChangedHandler;
/**
以系统分享的样式分享内容(目前该方法为了解决Twitter分享时的授权权限问题，目前该方法支持 纯文字 链接 单图 多图 图文（注：单图 多图 图文，图片不能超过四张）视频（注：仅支持本地视频））)
@param platformType 平台类型
@param parameters 分享参数
@param stateChangedHandler 状态变更回调处理
@return 会话
*/
+ (SSDKSession *)shareByActivityViewController:(SSDKPlatformType)platformType
parameters:(NSMutableDictionary *)parameters
onStateChanged:(SSDKShareStateChangedHandler)stateChangedHandler;
#pragma mark - Deprecated
typedef void(^SSDKImportHandler) (SSDKPlatformType platformType) __deprecated_msg("Discard form v4.2.0");
typedef void(^SSDKConfigurationHandler) (SSDKPlatformType platformType, NSMutableDictionary *appInfo) __deprecated_msg("Discard form v4.2.0");
+ (void)registerActivePlatforms:(NSArray *)activePlatforms
onImport:(SSDKImportHandler)importHandler
onConfiguration:(SSDKConfigurationHandler)configurationHandler __deprecated_msg("Discard form v4.2.0. Use 'registPlatforms:' instead.");
+ (void)cancelAuthorize:(SSDKPlatformType)platformType __deprecated_msg("Discard form v4.2.0. Use 'cancelAuthorize:result:' instead.");
@end