前幾天剛試完服務端接入微信公眾平台,接著又把 App 端接入開放平台的流程走了一遍,這裡把兩者的關係、串接方式與背後原理整理成筆記。
公眾平台面向的是公眾帳號,除了後台管理功能,也開放了一批接口,讓微信伺服器能與開發者自己的系統對接。開放平台則是微信整體的接入方案,涵蓋範圍更廣,除了訂閱號與服務號,行動 App 與 Web 應用同樣可以透過它與微信互通。可以說,公眾平台的那組 API 只是開放平台的一個子集。
大體上,開放平台分為三塊:行動 App、Web 應用、公眾帳號。
行動 App 完成接入後,主要可以取得這幾項能力:
1、向微信好友發送訊息
2、分享內容到朋友圈
3、收藏內容到「我的收藏」
4、以微信帳號登入 App 並取得帳號資訊
5、支援微信支付
你在朋友圈看到「來自 XXX」這樣的標註,就是該應用完成開放平台接入後才有的效果。
流程與程式碼都不複雜,官方網站已有完整說明,這裡只提醒一個常被漏掉的步驟:必須在 Xcode 中設定自己 App 的 URL Type,URL Schemes 要填寫開放平台配發的那個 app id。少了這一步,訊息依然能發出去,但發完之後微信無法再跳回你的 App —— 因為微信客戶端正是透過 openURL 回跳,需要你的 App 自己先註冊好 URL Scheme。
有個關鍵前提要先理解:App 並不能透過微信 SDK 直接把訊息送到微信伺服器。真實流程是你的 App 打開微信、由微信把訊息發出、再跳回你的 App。也就是說,App 與微信之間的互動,本質上是「應用間跳轉」,核心仍是 iOS 的這兩個方法:
- (BOOL)openURL:(NSURL *)url;
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
發送訊息的那行程式碼是:
[WXApi sendReq:req];
微信 SDK 並未開源,所以從這行看不出細節,但不難推測它做的事相當於:
NSString *weixinURL = @"weixin_schema://app_id?title=xxx&content=xxx"; [[UIApplication sharedApplication] openURL:[NSURL URLWithString:weixinURL]];
透過 weixin_schema 喚起裝置上的微信,並在 URL 後方帶上參數,微信解析後處理,把訊息發送出去,接著再呼叫 openURL 回到開發者的 App,回跳的 URL 形如:
wx_xxxxxxxxxxx://platformId=wechat
這個 URL 會被 AppDelegate 中的方法攔截:
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
return [WXApi handleOpenURL:url delegate:self];
}
而 handleOpenURL 之後會走到回調:
- (void)onResp:(BaseResp *)resp {
NSString *strTitle = [NSString stringWithFormat:@"發送消息結果"];
NSString *strMsg = [NSString stringWithFormat:@"errcode: %d", resp.errCode];
UIAlertView *alert = [[UIAlertView alloc] initWithTitle:strTitle message:strMsg delegate:nil cancelButtonTitle:@"OK" otherButtonTitles:nil];
[alert show];
}
歸納起來,實作上主要是兩條流程:
1、應用主動發訊息給微信:呼叫 sendReq,並在 onResp 中處理微信的響應。
2、微信發訊息給應用:在 onReq 中處理微信的請求,再呼叫 sendResp 回應。
這兩條流程中用到的參數,都是 SDK 已封裝好的類別,例如 SendMessageToWXReq、WXMediaMessage 等。
正因為 SDK 沒有提供「直接對微信伺服器發請求」的能力,只能帶參數跳轉到微信 App,接入的限制就相當明顯:
使用者的裝置必須安裝微信,而且處於登入狀態。這讓許多面向 iPad 的應用很難接入 —— 會在 iPad 上裝微信的人畢竟是少數。
你也無法在自己的 App 內直接挑選聯絡人,只能編輯好內容後跳到微信,再在微信通訊錄裡選好友;同樣無法依手機號碼直接向某個微信帳號發送加好友申請。
即便如此,接入微信對 App 的社交傳播仍有相當高的價值,這也是為什麼現在市面上的 App 幾乎都具備微信分享能力。