在 App 裡放一顆「用 QQ 登入」或「用微博登入」,已經是幾乎每個新產品的標配。它大幅降低了使用者的註冊門檻,也順帶打開了分享與拉新的通路。登入成功後拿到的唯一 ID,只要後端把它綁定到自家帳號體系,效果就等同於完成註冊。
不過真正接起來會發現,兩家 SDK 的設計風格差異不小,文件品質也參差不齊。以下依序說明通用流程,再分別拆解兩邊的實作細節與我踩到的坑。
依文件導入 SDK,把 App Key 寫進 URL Schemes,格式為 tencent 加上 App ID,例如 tencent1101737816。
以下兩個方法功能重疊,擇一實作即可,別忘了引入相關頭檔。它們負責在授權完成後把流程交還給 App:
- (BOOL)application:(UIApplication *)application
openURL:(NSURL *)url
sourceApplication:(NSString *)sourceApplication
annotation:(id)annotation {
return [TencentOAuth HandleOpenURL:url];
}
- (BOOL)application:(UIApplication *)application
handleOpenURL:(NSURL *)url {
return [TencentOAuth HandleOpenURL:url];
}
_tencentOAuth = [[TencentOAuth alloc] initWithAppId:kQQ_KEY andDelegate:self];
NSArray *_permissions = [NSArray arrayWithObjects:
kOPEN_PERMISSION_GET_INFO,
kOPEN_PERMISSION_GET_USER_INFO,
kOPEN_PERMISSION_GET_SIMPLE_USER_INFO, nil];
[_tencentOAuth authorize:_permissions inSafari:NO];
雷點:官方文件裡寫的授權碼是 @[@"get_user_info", @"add_t"] 這種寫法,但照抄之後會發現怎樣都登不進去,一律提示權限不足。正確做法是用上面那組 kOPEN_PERMISSION_* 常數,這一點文件確實有誤導性。
讓類別遵循 TencentSessionDelegate 協議,並實作以下方法:
- (void)tencentDidLogin {
_labelTitle.text = @"登錄完成";
if (_tencentOAuth.accessToken && 0 != [_tencentOAuth.accessToken length]) {
// 記錄使用者的 OpenID、Token 與過期時間
_labelAccessToken.text = _tencentOAuth.accessToken;
} else {
_labelAccessToken.text = @"登錄不成功,沒有獲取 accessToken";
}
}
- (void)tencentDidNotLogin:(BOOL)cancelled {
if (cancelled) {
_labelTitle.text = @"用戶取消登錄";
} else {
_labelTitle.text = @"登錄失敗";
}
}
- (void)tencentDidNotNetWork {
_labelTitle.text = @"無網絡連接,請設置網絡";
}
能走到 tencentDidLogin 且拿到 accessToken,代表授權流程已完成,接著只要抓使用者資料即可。文件提供的方法如下:
[_tencentOAuth getUserInfo];
它的回傳型別是 BOOL,難怪很多人看了會一頭霧水。實際上這是「非同步觸發」的設計:呼叫成功後,結果會透過 TencentSessionDelegate 的另一個回呼方法送回:
- (void)getUserInfoResponse:(APIResponse *)response {
// NSLog(@"respons:%@", response.jsonResponse);
self.name.text = [response.jsonResponse objectForKey:@"nickname"];
}
這樣就拿到暱稱等資訊了。剩下的就是把這些資料拋給自家後端,並妥善保存 token,細節可參考官方文件。
格式同樣是前綴加 App Key,例如 wb2045436852,然後依文件導入 SDK。
若同時整合了 QQ 與微博,兩個判斷可以用 || 串在一起:
- (BOOL)application:(UIApplication *)application
openURL:(NSURL *)url
sourceApplication:(NSString *)sourceApplication
annotation:(id)annotation {
return [TencentOAuth HandleOpenURL:url] || [WeiboSDK handleOpenURL:url delegate:self];
}
- (BOOL)application:(UIApplication *)application
handleOpenURL:(NSURL *)url {
return [TencentOAuth HandleOpenURL:url] || [WeiboSDK handleOpenURL:url delegate:self];
}
微博的登入結果回呼寫在類別本身,因為這裡傳入的是 self;若想在別的類別接收,把 delegate 換掉即可。
[WeiboSDK handleOpenURL:url delegate:self];
對應的協議是 WeiboSDKDelegate:
- (void)didReceiveWeiboResponse:(WBBaseResponse *)response {
if ([response isKindOfClass:WBAuthorizeResponse.class]) {
if ((int)response.statusCode == 0) {
NSDictionary *dic = @{
@"userID" : [(WBAuthorizeResponse *)response userID],
@"accessToken" : [(WBAuthorizeResponse *)response accessToken]
};
}
}
}
拿到 userID 與 accessToken,就代表登入成功。
- (IBAction)sinaLogin:(id)sender {
[WeiboSDK enableDebugMode:YES];
[WeiboSDK registerApp:kSINA_KEY];
WBAuthorizeRequest *request = [WBAuthorizeRequest request];
request.redirectURI = kRedirectURI;
request.scope = @"all";
request.userInfo = @{@"myKey": @"myValue"};
[WeiboSDK sendRequest:request];
}
這段同時完成了 SDK 註冊、開啟除錯日誌、設定回呼網址與自訂參數。若授權後能正確回呼 AppDelegate 的接收方法,微博登入就算通了。
Bundle Identifier 的坑:微博 SDK 會把 Bundle Identifier 綁進授權流程。若你的 Bundle ID 與申請 Key 時填的不一致,授權就會失敗。除錯階段的解法是暫時把 Bundle ID 改成微博官方 demo 的那一組,搭配官方 Key 測試,等自己的申請通過後再換回來。
功能面兩邊都很完整,但開發體驗差異明顯:
如果不想分別維護兩套 SDK,也可以考慮用聚合型的登入服務(例如百度開發平台提供的登入 SDK),它已經封裝了 QQ、新浪微博、人人網等主流平台。
下圖為授權成功後的畫面:

後記:這篇整理的是我在實作過程中實際遇到的問題,若需要 QQ 與新浪微博授權登入的 demo 程式碼,可來信索取(mmw05@163.com)進一步交流。