本篇在基於之前封裝的SocialSDK的專案上增加了微信SDK的登入授權和分享。簡單介紹了微信登入分享的接入和使用注意
具體程式碼專案Github地址:github.com/tsy12321/So…
0 系列文章
系列一 Android SDK的二次封裝和使用
系列二 原始碼解析
系列三 微信SDK接入
系列四 QQ SDK接入
系列五 新浪微博 SDK接入
1 官方文件
微信的官方接入文件:
open.weixin.qq.com/cgi-bin/sho…
2 登入授權
微信的登入授權是基於OAuth2.0標準。
一整套的授權流程官方文件很清晰:
open.weixin.qq.com/cgi-bin/sho…
這裡面著重理解幾個概念:
- code 調出微信授權確定後會返回的code,需要用這個code去換取access_token
- access_token 授權成功後都是微信提供的介面都是通過access_token去獲取的。由於access_token是code+appid+secret請求後獲取的,所以建議客戶端獲得到code後,該介面放在服務端進行。(這邊封裝的sdk secret是放在本地,呼叫比較方便,如果是對安全性要求較高的建議將這個步驟放到服務端進行,客戶端不要存放secret)
- refresh_token access_token具有時效性。當access_token失效後可以通過refresh_token獲取一個新的access_token。但是如果refresh_token過期後,只能再次呼叫客戶端進行授權。
2.1 Android 接入授權程式碼
先初始化wxapi並註冊:
this.mWXApi = WXAPIFactory.createWXAPI(context.getApplicationContext(), this.mConfig.appId);
this.mWXApi.registerApp(this.mConfig.appId);複製程式碼
授權登入時呼叫:
SendAuth.Req req1 = new SendAuth.Req();
req1.scope = sScope;
req1.state = "snsapi_userinfo,snsapi_friend,snsapi_message";
if(!this.mWXApi.sendReq(req1)) {
this.mAuthListener.onError(this.mConfig.getName(), "sendReq fail");
LogUtils.e("wxapi sendReq fail");
}複製程式碼
回撥結果:
回撥處理統一見後面解釋。
3 分享
微信對應5種分享,2個渠道(微信會話、朋友圈)
so!根據分享的媒介型別呼叫微信不同的api。
@Override
public void share(IShareMedia shareMedia, ShareListener shareListener) {
this.mShareListener = shareListener;
WXMediaMessage msg = new WXMediaMessage();
String type = "";
if(shareMedia instanceof ShareWebMedia) { //網頁分享
ShareWebMedia shareWebMedia = (ShareWebMedia) shareMedia;
type = "webpage";
//web object
WXWebpageObject webpageObject = new WXWebpageObject();
webpageObject.webpageUrl = shareWebMedia.getWebPageUrl();
msg.mediaObject = webpageObject;
msg.title = shareWebMedia.getTitle();
msg.description = shareWebMedia.getDescription();
msg.thumbData = BitmapUtils.bitmap2Bytes(shareWebMedia.getThumb());
} else if(shareMedia instanceof ShareTextMedia) { //文字分享
ShareTextMedia shareTextMedia = (ShareTextMedia) shareMedia;
type = "text";
//text object
WXTextObject textObject = new WXTextObject();
textObject.text = shareTextMedia.getText();
msg.mediaObject = textObject;
msg.description = shareTextMedia.getText();
} else if(shareMedia instanceof ShareImageMedia) { //圖片分享
ShareImageMedia shareImageMedia = (ShareImageMedia) shareMedia;
type = "image";
//image object
WXImageObject imageObject = new WXImageObject();
//image限制10M
imageObject.imageData = BitmapUtils.compressBitmap(BitmapUtils.bitmap2Bytes(shareImageMedia.getImage()), 10 * 1024 * 1024);
msg.mediaObject = imageObject;
//直接縮放圖片
Bitmap thumb = Bitmap.createScaledBitmap(shareImageMedia.getImage(), 200, 200, true);
msg.thumbData = BitmapUtils.bitmap2Bytes(thumb);
thumb.recycle();
} else if(shareMedia instanceof ShareMusicMedia) { //音樂分享
ShareMusicMedia shareMusicMedia = (ShareMusicMedia) shareMedia;
type = "music";
WXMusicObject musicObject = new WXMusicObject();
musicObject.musicUrl = shareMusicMedia.getMusicUrl();
msg.mediaObject = musicObject;
msg.title = shareMusicMedia.getTitle();
msg.description = shareMusicMedia.getDescription();
msg.thumbData = BitmapUtils.bitmap2Bytes(shareMusicMedia.getThumb());
} else if(shareMedia instanceof ShareVideoMedia) { //視訊分享
ShareVideoMedia shareVideoMedia = (ShareVideoMedia) shareMedia;
type = "video";
WXVideoObject videoObject = new WXVideoObject();
videoObject.videoUrl = shareVideoMedia.getVideoUrl();
msg.mediaObject = videoObject;
msg.title = shareVideoMedia.getTitle();
msg.description = shareVideoMedia.getDescription();
msg.thumbData = BitmapUtils.bitmap2Bytes(shareVideoMedia.getThumb());
} else {
if(this.mShareListener != null) {
this.mShareListener.onError(this.mConfig.getName(), "shareMedia error");
}
return ;
}
//壓縮縮圖到32kb
if(msg.thumbData != null && msg.thumbData.length > '耀') { //微信sdk裡面判斷的大小
msg.thumbData = BitmapUtils.compressBitmap(msg.thumbData, '耀');
}
//發起request
SendMessageToWX.Req req = new SendMessageToWX.Req();
req.message = msg;
req.transaction = buildTransaction(type);
if(this.mConfig.getName() == PlatformType.WEIXIN) { //分享好友
req.scene = SendMessageToWX.Req.WXSceneSession;
} else if(this.mConfig.getName() == PlatformType.WEIXIN_CIRCLE) { //分享朋友圈
req.scene = SendMessageToWX.Req.WXSceneTimeline;
}
if(!this.mWXApi.sendReq(req)) {
if(this.mShareListener != null) {
this.mShareListener.onError(this.mConfig.getName(), "sendReq fail");
}
LogUtils.e("wxapi sendReq fail");
}
}複製程式碼
分享中注意幾點:
- 圖片分享的圖片大小在10M內
- 所有的縮圖要控制在32KB
然後還有一些其他引數限制可以參考微信sdk資源下載下來的本地Api文件。
如果引數錯誤sendReq會返回false,無法分享。
4 微信結果回撥
微信要求專案中定死 wxapi.WXEntryActivity這個檔案,回撥會呼叫這個檔案。所以我們自定義了一個WXCallbackActivity,將所有內容寫在這個檔案中,然後具體專案中的WXEntryActivity只需要繼承該Activity即可。
WXCallbackActivity見下:
public abstract class WXCallbackActivity extends Activity implements IWXAPIEventHandler {
protected WXHandler mWXHandler = null;
public WXCallbackActivity() {
}
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
SocialApi api = SocialApi.get(this.getApplicationContext());
this.mWXHandler = (WXHandler)api.getSSOHandler(PlatformType.WEIXIN);
this.mWXHandler.onCreate(this.getApplicationContext(), PlatformConfig.getPlatformConfig(PlatformType.WEIXIN));
this.mWXHandler.getWXApi().handleIntent(this.getIntent(), this);
}
protected final void onNewIntent(Intent paramIntent) {
super.onNewIntent(paramIntent);
SocialApi api = SocialApi.get(this.getApplicationContext());
this.mWXHandler = (WXHandler)api.getSSOHandler(PlatformType.WEIXIN);
this.mWXHandler.onCreate(this.getApplicationContext(), PlatformConfig.getPlatformConfig(PlatformType.WEIXIN));
this.mWXHandler.getWXApi().handleIntent(this.getIntent(), this);
}
public void onResp(BaseResp resp) {
if(this.mWXHandler != null && resp != null) {
try {
this.mWXHandler.getWXEventHandler().onResp(resp);
} catch (Exception var3) {
;
}
}
this.finish();
}
public void onReq(BaseReq req) {
if(this.mWXHandler != null) {
this.mWXHandler.getWXEventHandler().onReq(req);
}
this.finish();
}
}複製程式碼
其中發現回撥的資料主要是在onResp中處理,然後在WXCallbackActivity中又將最終處理放在了WXHandler中。
WXHandler的回撥處理:
public WXHandler() {
this.mEventHandler = new IWXAPIEventHandler() {
public void onResp(BaseResp resp) {
int type = resp.getType();
switch(type) {
case ConstantsAPI.COMMAND_SENDAUTH: //授權返回
WXHandler.this.onAuthCallback((SendAuth.Resp)resp);
break;
case ConstantsAPI.COMMAND_SENDMESSAGE_TO_WX: //分享返回
WXHandler.this.onShareCallback((SendMessageToWX.Resp)resp);
break;
}
}
public void onReq(BaseReq req) {
}
};
}
//驗證回撥
protected void onAuthCallback(SendAuth.Resp resp) {
switch (resp.errCode) {
case BaseResp.ErrCode.ERR_OK: //授權成功
getAuthWithCode(resp.code);
break;
case BaseResp.ErrCode.ERR_USER_CANCEL: //授權取消
if(this.mAuthListener != null) {
this.mAuthListener.onCancel(PlatformType.WEIXIN);
}
break;
default: //授權失敗
CharSequence err = TextUtils.concat(new CharSequence[]{"weixin auth error (", String.valueOf(resp.errCode), "):", resp.errStr});
if(mAuthListener != null) {
mAuthListener.onError(PlatformType.WEIXIN, err.toString());
}
break;
}
}複製程式碼
注意,在回撥的一些常量定義中(ConstantsAPI.COMMAND_SENDAUTH、BaseResp.ErrCode.ERR_OK等)都在本地的API中有定義。所以,如果有問題,多看看微信提供的API文件。
結尾
以上即實現了微信平臺的接入,當接入方需要接入微信部分時,只需要同時將social_sdk.jar和微信的sdk包同時引用進專案,即可呼叫微信相關的登入和分享。
本篇結束,後面還會繼續接入其他平臺。。。