统一第三方 SDKs 的登录和分享接口。目前支持微信、 QQ 、微博。
P.S: 其中除微博支持 OAuth ,其它第三方只支持 SSO ,需安装相应的客户端才能使用。
-
通过 CocoaPods 安装。
pod 'Diplomat'
选择性安装
pod 'Diplomat/Wechat'
pod 'Diplomat/QQ'
-
导入需要使用的第三方 SDK。
#import <Diplomat/WechatProxy.h>
#import <Diplomat/QQProxy.h>
-
使用
// 在 application:didFinishLaunchingWithOptions: 添加
[[Diplomat sharedInstance] registerWithConfigurations:@{kDiplomatTypeWechat: @{kDiplomatAppIdKey: @"wxd930ea5d5a258f4f",
kDiplomatAppSecretKey: @"db426a9829e4b49a0dcac7b4162da6b6"},
kDiplomatTypeQQ: @{kDiplomatAppIdKey: @"222222"}}];
// 授权登录。
[[Diplomat sharedInstance] authWithName:thirdPartyName
completed:^(id result, NSError *error) {
// ...
}];
// 分享。
// Create DTMessage message ...
[[Diplomat sharedInstance] share:message
name:thirdPartyName
completed:^(id result, NSError *error) {
// ...
}];
userInfo 是用来携带额外的信息。
微信分享场景的选择:
DTMessage *message = DTMessage()
// ...
message.userInfo = @{kWechatSceneTypeKey: @(WXSceneTimeline)}
// WXSceneTimeline: 朋友圈(默认)、WXSceneSession: 好友、WXSceneFavorite: 收藏。
通过 Safari 分享到 QZone (感谢 @hi-guy 贡献):
DTMessage *message = DTMessage()
// ...
message.userInfo = @{kTencentQQSceneTypeKey: @(TencentSceneZone)}
// TencentSceneQQ: 通过 QQ 客户端分享(默认,包含了分享到 QZone 选项),
// TencentSceneZone: 通过 Safari 只分享到 QZone (有 QQ 客户端时不推荐使用)。
- 实现协议 DiplomatProxyProtocol 。
- 添加将 DTMessage 转换到第三方 SDK 的方法。
- 将实现的自定义扩展注册到 Diplomat 中。