社会化登录 Android 组件 用户手册 (1.1 版 ) 发布日期 : 2013 年 7 月 3 日 百度开发者中心 ( 版权所有, 翻版必究 )
目录 第 1 章 概述... 3 第 2 章 运行环境... 3 第 3 章 使用说明... 3 3.1 新建工程... 3 3.2 引入社会化登录 JAR 包... 4 3.3 配置 ANDROIDMANIFEST.XML... 4 3.4 配置支持平台类型... 5 3.5 新浪微博 SSO 支持... 5 3.6 腾讯 SSO 支持... 6 第 4 章 接口说明... 6 第 5 章 代码示例... 6 5.1 初始化社交分享组件... 6 5.2 用户授权... 6 5.3 为第三方平台用户和自有用户建立绑定关系的接口... 7 5.4 解除第三方平台用户和自有平台用户的绑定关系... 7 5.5 查询第三方平台用户和自有用户的绑定关系... 7 第 6 章 文档变更说明... 7 百度开发者中心 2
第 1 章概述 社会化登录 Android 组件封装了新浪微博 开心网 腾讯微博 人人网 百度和 QQ 空间等平台的登 录授权功能, 该组件集成简便, 可以轻松实现多平台登录 下载解压组件 SDK 包, 文件目录结构如下 : lib doc demo 名称 说明百度社会化登录 android 组件包以及相关平台 SSO 支持包百度社会化登录组件接口说明文档百度社会化登录组件 Demo 工程 用户手册 百度社会化登录组件用户手册 第 2 章运行环境 适用于 Android 2.2 及以上的系统版本 第 3 章使用说明 3.1 新建工程 创建一个工程名为 Sample 的 android 工程 为方便起见, 创建项目时全部使用默认设置 百度开发者中心 3
3.2 引入社会化登录 jar 包 将 lib\ 下的 Baidu-SocialLogin-SDK-Android-L1-1.1.0.jar 和 libammsdk.jar 包复制到 Sample 的 libs 目录下 注 : 如需要支持微信分享需要把 libammsdk.jar 包复制到项目的 libs 目录下 3.3 配置 AndroidManifest.xml /> <uses-permission android:name="android.permission.internet" /> <uses-permission android:name="android.permission.access_wifi_state" /> <uses-permission android:name="android.permission.access_network_state" /> <uses-permission android:name="android.permission.write_external_storage" 说明 : 这些权限包括允许您的项目和 Social Share SDK 获取连接网络的权限 获取您的设备 网络状态的权限 实现 https 安全连接的权限和本地数据卡的写权限 一般应用都会 自己设置好这些权限 百度开发者中心 4
3.4 配置支持平台类型 用户可按照个人需求配置 sample 应用所支持的平台类型 1. 首先编辑文件 platforms.xml: <?xml version="1.0" encoding="utf-8"?> <SupportPlatforms> <platform id="1">sinaweibo</platform> <platform id="2">qqweibo</platform> <platform id="3">renren</platform> <platform id="4">qqdenglu</platform> <platform id="5">kaixin</platform> <platform id="6">baidu</platform> </SupportPlatforms> 说明 : 上述配置表示应用可以支持分享到新浪微博 QQ 微博 开心网 QQ 社区 (QZone) 人人网和 baidu 等平台 用户可根据需要做个性化裁剪 2. 保存文件后并将它放置到 sample 工程的 asserts 目录下 : 3.5 新浪微博 SSO 支持 首先手机中必须安装新浪微博 3..0 以上版本才能够支持新浪微博单点登录 1. 在 androidmanifest.xml 中添加如下配置 : 2. 在程序中必须显式调用支持新浪 SSO 代码 3. 代码中需要传入在新浪开放平台申请应用的的 app key 这个新浪应用必须已经托管在百度开放平 台注册移动应用下面 百度开发者中心 5
3.6 腾讯 SSO 支持 首先手机中必须安装腾讯手机 QQ 4.1.0 以上版本才能够支持腾讯单点登录 1. 在 androidmanifest.xml 中添加如下配置 : 2. 3. 在程序中必须显式调用支持 QQ SSO 代码 4. 代码中需要传入在腾讯开放平台申请应用的的 app key 这个腾讯应用必须已经托管在百度开放平 台注册移动应用下面 第 4 章接口说明 详细说明请参考下载包中 doc 目录下的接口说明文档 第 5 章代码示例 5.1 初始化社交分享组件 开发者需要在 baidu 开发者中心注册应用, 获取 app_key 后做为参数传入 : // 实例化 baidu 社会化登录, 传入 appkey sociallogin = BaiduSocialLogin.getInstance(this, appkey); 5.2 用户授权 用户需要调用下面接口完成相关平台的授权工作 sociallogin.authorize(mainactivity.this, Utility.SHARE_TYPE_SINA_WEIBO, new UserInfoListener()); class UserInfoListener implements BaiduSocialListener { 百度开发者中心 6
@Override public void onauthcomplete(bundle values) { @Override public void onapicomplete(string responses) { @Override public void onerror(baidusocialexception e) { 5.3 为第三方平台用户和自有用户建立绑定关系的接口 sociallogin.bind(mainactivity.this,utility.share_type_sina_weibo,1000, 阿三, new BaiduSocialListener (){ ) 5.4 解除第三方平台用户和自有平台用户的绑定关系 sociallogin.unbind(mainactivity.this,utility.share_type_sina_weibo,new BaiduSocialListener (){ ) 5.5 查询第三方平台用户和自有用户的绑定关系 sociallogin.getuserbindstatus (MainActivity.this,Utility.SHARE_TYPE_SINA_WEIBO,1000,new BaiduSocialListener (){ ) 第 6 章文档变更说明 序号版本号变更内容说明变更日期 1 V1.0.0 初稿 2013/06/24 2 V1.1.0 增加了人人网 baidu 登录修改了 HTTPS 的请求方法, 解决了在某些 android 版本上的 BUG 2013/07/3 百度开发者中心 7