社會化登入分享-微信SDK接入

Tsy遠發表於2017-09-22

本篇在基於之前封裝的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…

這裡面著重理解幾個概念:

  1. code 調出微信授權確定後會返回的code,需要用這個code去換取access_token
  2. access_token 授權成功後都是微信提供的介面都是通過access_token去獲取的。由於access_token是code+appid+secret請求後獲取的,所以建議客戶端獲得到code後,該介面放在服務端進行。(這邊封裝的sdk secret是放在本地,呼叫比較方便,如果是對安全性要求較高的建議將這個步驟放到服務端進行,客戶端不要存放secret)
  3. 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");
        }
    }複製程式碼

分享中注意幾點:

  1. 圖片分享的圖片大小在10M內
  2. 所有的縮圖要控制在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文件。

微信本地API文件
微信本地API文件

結尾

以上即實現了微信平臺的接入,當接入方需要接入微信部分時,只需要同時將social_sdk.jar和微信的sdk包同時引用進專案,即可呼叫微信相關的登入和分享。

本篇結束,後面還會繼續接入其他平臺。。。

相關文章