前言
最近項目中又一次需要集成友盟的三方登錄與分享,之前沒有記錄過,所以這次來寫一下…
準備工作
1.註冊友盟賬號創建應用,獲取key:申請地址http://www.umeng.com
2.對對應的平臺(騰訊、微信、新浪等等)申請第三方賬號,獲取key和密碼
集成步驟
因爲shareSDK分享與第三方登錄集成方式類似(共用jar包),所以我就一起說了。
1.下載shareSDK分享的SDK
下載地址:https://developer.umeng.com/sdk
2.導入jar與res
打開開發文檔並下載對應的SDK以及demo,下載SDK時要選擇你需要的功能
下載完的文件對應的功能如下圖所示:
導入到Android studio中並添加依賴
3.配置Android Manifest XML
sdk中需要的Activity
- 新浪
<activity
android:name="com.umeng.socialize.media.WBShareCallBackActivity"
android:configChanges="keyboardHidden|orientation"
android:theme="@android:style/Theme.Translucent.NoTitleBar"
android:exported="false"
>
</activity>
<activity android:name="com.sina.weibo.sdk.web.WeiboSdkWebActivity"
android:configChanges="keyboardHidden|orientation"
android:exported="false"
android:windowSoftInputMode="adjustResize"
>
</activity>
<activity
android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"
android:launchMode="singleTask"
android:name="com.sina.weibo.sdk.share.WbShareTransActivity">
<intent-filter>
<action android:name="com.sina.weibo.sdk.action.ACTION_SDK_REQ_ACTIVITY" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
- 微信
<activity
android:name=".wxapi.WXEntryActivity"
android:configChanges="keyboardHidden|orientation|screenSize"
android:exported="true"
android:theme="@android:style/Theme.Translucent.NoTitleBar" />
<activity
android:name="com.tencent.tauth.AuthActivity"
android:launchMode="singleTask"
android:noHistory="true" >
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="tencent100424468" />
</intent-filter>
</activity>
<activity
android:name="com.tencent.connect.common.AssistActivity"
android:theme="@android:style/Theme.Translucent.NoTitleBar"
android:configChanges="orientation|keyboardHidden|screenSize"/>
添加權限:
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
適配
Android6.0權限適配
if(Build.VERSION.SDK_INT>=23){
String[] mPermissionList = new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE,Manifest.permission.ACCESS_FINE_LOCATION,Manifest.permission.CALL_PHONE,Manifest.permission.READ_LOGS,Manifest.permission.READ_PHONE_STATE, Manifest.permission.READ_EXTERNAL_STORAGE,Manifest.permission.SET_DEBUG_APP,Manifest.permission.SYSTEM_ALERT_WINDOW,Manifest.permission.GET_ACCOUNTS,Manifest.permission.WRITE_APN_SETTINGS};
ActivityCompat.requestPermissions(this,mPermissionList,123);
}
其中123是requestcode,可以根據這個code判斷,用戶是否同意了授權。如果沒有同意,可以根據回調進行相應處理:
@Override
public void onRequestPermissionsResult(int requestCode,
String permissions[], int[] grantResults) {
}
初始化設置
@Override
public void onCreate() {
super.onCreate();
UMConfigure.init(this,"5a12384aa40fa3551f0001d1"
,"umeng",UMConfigure.DEVICE_TYPE_PHONE,"");//58edcfeb310c93091c000be2 5965ee00734be40b580001a0
}
接下來需要設置各個平臺的appkey:
PlatformConfig.setWeixin("wxdc1e388c3822c80b", "3baf1193c85774b3fd9d18447d76cab0");
//豆瓣RENREN平臺目前只能在服務器端配置
PlatformConfig.setSinaWeibo("3921700954", "04b48b094faeb16683c32669824ebdad","http://sns.whalecloud.com");
PlatformConfig.setYixin("yxc0614e80c9304c11b0391514d09f13bf");
PlatformConfig.setQQZone("100424468", "c7394704798a158208a74ab60104f0ba");
PlatformConfig.setTwitter("3aIN7fuF685MuZ7jtXkQxalyi", "MK6FEYG63eWcpDFgRYw4w9puJhzDl0tyuqWjZ3M7XJuuG7mMbO");
PlatformConfig.setAlipay("2015111700822536");
PlatformConfig.setLaiwang("laiwangd497e70d4", "d497e70d4c3e4efeab1381476bac4c5e");
PlatformConfig.setPinterest("1439206");
PlatformConfig.setKakao("e4f60e065048eb031e235c806b31c70f");
PlatformConfig.setDing("dingoalmlnohc0wggfedpk");
PlatformConfig.setVKontakte("5764965","5My6SNliAaLxEm3Lyd9J");
PlatformConfig.setDropbox("oz8v5apet3arcdy","h7p2pjbzkkxt02a");
PlatformConfig.setYnote("9c82bf470cba7bd2f1819b0ee26f86c6ce670e9b");
#####簽名
必須用keystore簽名後的apk來測試,簽名文件如果不加,部分平臺的授權會受到影響。
使用步驟
一.分享
友盟分享分爲兩種形式:
使用分享面板的分享,用戶可以調用我們的打開分享面板的方法,點擊分享面板的對應平臺進行分享。
不使用分享面板的分享,用戶可以自己寫分享按鈕,或者觸發事件,然後調用我們的分享方法,進行分享。簡而言之,直接分享就是在用戶自己的界面組件中插入分享行爲,分享面板是打開我們寫好的一個界面組件,根據點擊事件進行分享。
打開分享面板的代碼如下:
new ShareAction(MainActivity.this)
.setPlatform(SHARE_MEDIA.QQ)//傳入平臺
.withText("hello")//分享內容
.setCallback(umShareListener)//回調監聽器
.share();
分享的類型有多種,具體可以看友盟開發者文檔,這裏以連接爲例:
分享鏈接可以使用UMWeb進行分享:
UMWeb web = new UMWeb(Defaultcontent.url);
web.setTitle("This is music title");//標題
web.setThumb(thumb); //縮略圖
web.setDescription("my description");//描述
然後調用將這個參數設置到ShareAction中:
new ShareAction(ShareActivity.this)
.withMedia(web)
.share();
二.第三方登錄
第三方登錄包含兩種使用場景:
獲取用戶資料的授權接口,使用該接口可以獲取該三方平臺返回的所有資料(包括姓名,性別,頭像等)目前支持第三方登錄的平臺包括:
國內平臺(微信、新浪微博、QQ、豆瓣、人人)
國外平臺(Facebook、Twitter、linkedIn、kakao、VKontakte、Dropbox)
這裏推薦直接使用第一種方式實現,因爲本質上三方登錄最終都需要拉取三方平臺的用戶資料,從這點來說,直接調用SDK和通過後臺服務器請求,安全性是一樣的
第三方登錄包含兩種使用場景:
獲取用戶資料的授權接口,使用該接口可以獲取該三方平臺返回的所有資料(包括姓名,性別,頭像等)目前支持第三方登錄的平臺包括:
國內平臺(微信、新浪微博、QQ、豆瓣、人人)
國外平臺(Facebook、Twitter、linkedIn、kakao、VKontakte、Dropbox)
這裏推薦直接使用第一種方式實現,因爲本質上三方登錄最終都需要拉取三方平臺的用戶資料,從這點來說,直接調用SDK和通過後臺服務器請求,安全性是一樣的
獲取用戶資料
獲取用戶資料可以使用如下接口:
mShareAPI.getPlatformInfo(UserinfoActivity.this, SHARE_MEDIA.SINA, umAuthListener);
其中umAuthListener爲授權回調,構建如下:
UMAuthListener authListener = new UMAuthListener() {
/**
* @desc 授權開始的回調
* @param platform 平臺名稱
*/
@Override
public void onStart(SHARE_MEDIA platform) {
}
/**
* @desc 授權成功的回調
* @param platform 平臺名稱
* @param action 行爲序號,開發者用不上
* @param data 用戶資料返回
*/
@Override
public void onComplete(SHARE_MEDIA platform, int action, Map<String, String> data) {
Toast.makeText(mContext, "成功了", Toast.LENGTH_LONG).show();
}
/**
* @desc 授權失敗的回調
* @param platform 平臺名稱
* @param action 行爲序號,開發者用不上
* @param t 錯誤原因
*/
@Override
public void onError(SHARE_MEDIA platform, int action, Throwable t) {
Toast.makeText(mContext, "失敗:" + t.getMessage(), Toast.LENGTH_LONG).show();
}
/**
* @desc 授權取消的回調
* @param platform 平臺名稱
* @param action 行爲序號,開發者用不上
*/
@Override
public void onCancel(SHARE_MEDIA platform, int action) {
Toast.makeText(mContext, "取消了", Toast.LENGTH_LONG).show();
}
};
登錄成功後,第三方平臺會將用戶資料傳回, 全部會在Map data中返回。
還有一些其他的功能大家可以查看友盟開發文檔,地址:
https://developer.umeng.com/docs/66632/detail/66639
大家可以關注我的微信公衆號:「秦子帥」一個有質量、有態度的公衆號!