百度xx SDK用户手册

Size: px

Start display at page:

Download "百度xx SDK用户手册"

随堰凤
5 years ago
Views:

2 目录第 1 章概述... 3 第 2 章运行环境... 3 第 3 章使用说明新建工程引入社会化分享 JAR 包配置 ANDROIDMANIFEST.XML 配置支持平台类型关于微信分享的问题新浪微博 SSO 支持腾讯 SSO 支持... 6 第 4 章接口说明... 7 第 5 章代码示例初始化社交分享组件用户授权单平台分享显示分享菜单页面定制化 UI 分享到微信... 9 第 6 章显示效果截图... 9 第 7 章文档变更说明百度开发者中心 2

第 1 章概述社会化分享 Android 组件基于百度社会化分享服务, 封装了新浪微博开心网腾讯微博和 QQ 空间等平台的授权及分享功能, 同时提供了 API 接口调用及本地操作界面支持该组件集成简便, 可以轻松实现多平台分享功能下载解压组件 SDK 包, 文件目录结构如下 : lib doc demo 名称说明百度社会化分享 android

3 第 1 章概述社会化分享 Android 组件基于百度社会化分享服务, 封装了新浪微博开心网腾讯微博和 QQ 空间等平台的授权及分享功能, 同时提供了 API 接口调用及本地操作界面支持该组件集成简便, 可以轻松实现多平台分享功能下载解压组件 SDK 包, 文件目录结构如下 : lib doc demo 名称说明百度社会化分享 android 组件包以及相关平台 ( 微信 ) 分享支持包百度社会化分享组件接口说明文档百度社会化分享组件 Demo 工程用户手册百度社会化分享组件用户手册第 2 章运行环境适用于 Android 2.2 及以上的系统版本第 3 章使用说明 3.1 新建工程创建一个工程名为 Sample 的 android 工程为方便起见, 创建项目时全部使用默认设置百度开发者中心 3

$3.2 引入社会化分享 jar 包将 lib\ 下的 BaiduSocialShare.jar 包复制到 Sample 的 libs 目录下注 : 如需要支持微信分享需要把 libammsdk.jar 包复制到项目的 libs 目录下 3.3 配置 AndroidManifest.xml /> <uses-permission$

4 3.2 引入社会化分享 jar 包将 lib\ 下的 BaiduSocialShare.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 安全连接的权限和本地数据卡的写权限一般应用都会自己设置好这些权限 3.4 配置支持平台类型用户可按照个人需求配置 sample 应用所支持的平台类型百度开发者中心 4

5 1. 首先编辑文件 platforms.xml: <?xml version="1.0" encoding="utf-8"?> <SupportPlatforms> <platform id="1">sinaweibo</platform> <platform id="2">qqweibo</platform> <platform id="3">kaixin</platform> <platform id="4">qqdenglu</platform> <platform id="5">weixin_session</platform> <platform id="6">weixin_timeline</platform> </SupportPlatforms> 说明 : 上述配置表示应用可以支持分享到新浪微博 QQ 微博开心网 QQ 社区 (QZone) 微信和微信朋友圈这六个平台用户可根据需要做个性化裁剪 2. 保存文件后并将它放置到 sample 工程的 asserts 目录下 : 3.5 关于微信分享的问题开发者需要到微信的开放平台 (open.weixin.qq.com), 注册 apk 的 package-name 和 package-sign, 其中 package-sign 是 apk 包签名的 MD5 值, 生成签名的具体方法, 可以参考微信开放平台的 FAQ( 1. 在代码中的包名目录下, 添加如下代码 : 2. 在 WXEntryActivity 中添加如下代码 : 百度开发者中心 5

6 3. 在 AndroidManifest.xml 中配置如下 activity 3.6 新浪微博 SSO 支持首先手机中必须安装新浪微博 3..0 以上版本才能够支持新浪微博单点登录 1. 在 androidmanifest.xml 中添加如下配置 : 2. 在程序中必须显式调用支持新浪 SSO 代码代码中需要传入在新浪开放平台申请应用的的 app key 这个新浪应用必须已经托管在百度开放平台注册移动应用下面 3.7 腾讯 SSO 支持首先手机中必须安装腾讯手机 QQ 以上版本才能够支持腾讯单点登录 1. 在 androidmanifest.xml 中添加如下配置 : 2. 在程序中必须显式调用支持新浪 SSO 代码百度开发者中心 6

7 代码中需要传入在腾讯开放平台申请应用的的 app key 这个腾讯应用必须已经托管在百度开放平台注册移动应用下面第 4 章接口说明详细说明请参考下载包中 doc 目录下的接口说明文档第 5 章代码示例 5.1 初始化社交分享组件开发者需要在 baidu 开发者中心注册应用, 获取 app_key 后做为参数传入 : ); socialshare = BaiduSocialShare.getInstance(this, APP_KEY); socialshareuiinstance = socialshare.getsocialshareuserinterfaceinstance( 5.2 用户授权用户需要调用下面接口完成相关平台的授权工作 socialshare.authorize(this, Utility. ShareTypeSinaWeibo, new ShareListener() { public void onauthcomplete(bundle values) {} public void onapicomplete(string responses) {} public void onerror(baidushareexception e) {} }) 5.3 单平台分享 // 构造分享实体对象 ShareContent content = new ShareContent(); content.setcontent( CONTENT");// 分享的文字内容 content.seturl( URL );// 分享的 url content.setimageurl( imageurl );// 分享的图片 url // 调用分享接口 socialshare.share(// 比如说分享到 sina 微博 this, Utility.ShareTypeSinaWeibo, content, new SycShareListener()); // 回调接口的实现如果要更新当前的 UI 页面, 需要使用 Handler class SycShareListener implements ShareListener { 百度开发者中心 7

8 final Handler handler = new Handler(Looper.getMainLooper()); public void onauthcomplete(bundle values) { // TODO Auto-generated method stubis } public void onapicomplete(string responses) { // TODO Auto-generated method stub final String responsestr = responses; handler.post(new Runnable() { public void run() { Utility.showAlert(this, " 提示 ", responsestr); } }); } } public void onerror(baidushareexception e) { // TODO Auto-generated method stub } 5.4 显示分享菜单页面 { // 构造分享实体对象 ShareContent content = new ShareContent(); content.setcontent( CONTENT");// 分享的文字内容 content.seturl( URL );// 分享的 url content.setimageurl( imageurl );// 分享的图片 url socialshareuiinstance.showsharemenu(this, content, Utility. SHARE_BOX_STYLE, new ShareListener() public void onauthcomplete(bundle values) {} public void onapicomplete(string responses) {} public void onerror(baidushareexception e) {} }); 5.5 定制化 UI 用户可以通过一下示例代码个性化定制社会化分享组件的页面上某个空间的显示样式 : ShareUIConfiguration uiconfig = ShareUIConfiguration.getInstance(); // 定制主题风格的分享菜单页 ShareUIPage menupage = new ShareUIPage( ShareUIPage.PAGE_INDEX_MENU_DIALOG); // 设置上面按钮的样式 : 白色的字体使用 icon_share.png 图片作为背景图片 ShareUIElement btnelement = new ShareUIElement( ShareUIElement.ELEMENT_TYPE_BUTTON); btnelement.settextcolor(color.white); btnelement.setbackgrounddrawable(drawableutils.getdrawable(this, 百度开发者中心 8

9 "icon_share")); menupage.adduielement(btnelement); uiconfig.addconfigpage(menupage); 5.1 分享到微信如果想使用此功能, 开发者需要到微信开放平台申请应用, 并注册对应 apk 的 package name 和 package sign 示例程序中我们已经完成了注册, 对应的相关应用信息如下 : appid package-name package-sign wxfc87c64e5e4fcc66 com.share.baidudemo 1f3c0c3113a6457a906012f807297ebd 在 demo 工程中提供了生成好的 debug.keystore 文件, 用户如果想直接使用 demo 程序进行分享到微信的操作, 在打包生成 apk 的时候需要在 eclipse 里面特别指定 debug.keystore 文件的路径 : 第 6 章显示效果截图 1. 主题风格的分享菜单百度开发者中心 9

10 2. 简洁风格分享菜单 : 3. 类 ios 系统风格分享菜单 : 百度开发者中心 10

11 4. 分享编辑页面 : 5. 平台授权页面 : 百度开发者中心 11

12 第 7 章文档变更说明序号版本号变更内容说明变更日期 1 V1.0.0 初稿 2013/04/07 2 V1.1.0 添加微信分享平台配置和 UI 个性化设置相关说明 2013/05/10 2 V1.2.0 添加腾讯微博和新浪 SSO 的支持说明 2013/05/24 百度开发者中心 12

百度xx SDK用户手册

百度xx SDK用户手册社会化分享 Android 组件用户手册 (1.1.0 版 ) 发布日期 : 2013 年 5 月 10 日百度开发者中心 ( 版权所有, 翻版必究 ) 目录第 1 章概述... 3 第 2 章运行环境... 3 第 3 章使用说明... 3 3.1 新建工程... 3 3.2 引入社会化分享 JAR 包... 4 3.3 配置 ANDROIDMANIFEST.XML... 4 3.4