Android平台微博SDK说明文档

北京新潮讯捷信息技术有限公司微博Android平台SDK文档北京新潮讯捷信息技术有限公司编号：WEIBO_ANDROID_SDK版本：WEIBO_ANDROID_SDKV2.0.0修订记录时间文档版本修订人备注2012/7/202.0.0罗棚初稿2012/8/022.0.0张晓伟北京新潮讯捷信息技术有限公司目录微博Android平台SDK文档.......................................................................................................1概述..................................................................................................................................................................3主要类说明：..................................................................................................................................................3主要接口说明..................................................................................................................................................31.获取Weibo对象....................................................................................................32.获取Oauth2AccessToken对象...........................................................................53.分享到微博...............................................................................................................54.SSO支持..................................................................................................................6实例分析..........................................................................................................................................................61.通过Oauth2.0授权获得AccessToken..............................................................72.发送微博...................................................................................................................8SSO介绍.........................................................................................................................................................101.SSO功能使用方式................................................................................................102.SSO授权功能介绍................................................................................................103.SSO授权优势........................................................................................................104.SSO授权流程示例................................................................................................10SDK使用说明...............................................................................................................................................121.使用weibo.sdk.android（不包含sso功能）.................................................122.使用weibo.sdk.android.sso..............................................................................153.SDK使用及修改必须遵守微博开发者协议，以及开源软件协议。................18北京新潮讯捷信息技术有限公司概述微博Android平台SDK为第三方微博应用提供了文档易用的微博API调用服务，使第三方客户端无需了解复杂的验证，API调用过程。并可以实现分享到微博的功能，可以分享文字，或者多媒体信息到内置的分享页面，并发送到微博。主要类说明：1.Weibo:微博API接口类，对外提供weiboapi的调用，包括登录，API调用，微博分享等功能。2.Oauth2AccessToken：封装了“access_token”，“expires_in”，refresh_token，并提供了他们的管理功能3.Utility：工具类，提供了url的encode，decode方法。4.AsyncWeiboRunner：微博api异步执行类，封装了回调接口，通过创建线程来调用Weibo中的接口方法。5.HttpManager:负责与服务器进行通讯的类，封装了GET、POST请求方式，并对外提供图片上传等功能6.WeiboAPI:该类及其子类封装了新浪微博对外提供的api接口方法。7.WeiboException：微博异常封装类，封装了微博的各个异常。8.SsoHandler:单点登录认证类，对外提供了sso登录认证的方法。主要接口说明1.获取Weibo对象获取weibo对象接口名称com.weibo.sdk.android.Weibo.getInstance(StringappKey,StringredirectUrl)参数名称作用appKey第三方应用的appkey（在新浪微博开放平台上创建应用时自动分配），redirectUrl第三方应用的回调页返回结果Weibo实例对象北京新潮讯捷信息技术有限公司北京新潮讯捷信息技术有限公司授权认证2.获取Oauth2AccessToken对象获取Oauth2AccessToken对象接口名称com.weibo.sdk.android.Oauth2AccessToken(StringaccessToken,Stringexpires_in)参数名称作用accessToken通过认证后从服务器获取到的访问令牌expires_in认证有效期返回结果Oauth2AccessToken实例对象3.分享到微博StatusesAPI构造函数接口名称com.weibo.sdk.android.api.StatusesAPI(Oauth2AccessTokenaccesssToken)参数名称作用accesssTokenOauth2AccessToken对象分享文字到微博接口名称com.weibo.sdk.android.api.StatusesAPI.update(Stringcontent,Stringlat,Stringlon,RequestListenerlistener)参数名称作用content要分享的微博内容，限140个字Lat、lon经纬度，格式为：ddd.ddddd°【度.度】格式listener用于异步返回服务器的返回结果分享文字和图片到微博接口名称com.weibo.sdk.android.api.StatusesAPI.upload(Stringcontent,Stringfile,Stringlat,Stringlon,RequestListenerlistener)参数名称作用content要分享的微博内容，限140个字file要上传的照片本地所在路径授权认证接口名称com.weibo.sdk.android.Weibo.authorize(Contextcontext,WeiboAuthListenerlistener)参数名称作用context当前activity对象，用于获取当前网络状态，弹出对话框等。listener授权对话框回调接口。处理授权完成、授权失败、授权取消等事件北京新潮讯捷信息技术有限公司Lat、lon经纬度，格式为：ddd.ddddd°【度.度】格式listener用于异步返回服务器的返回结果4.SSO支持SSOHandler构造函数接口名称voidSSOHandler(Activityactivity,Weiboweibo)参数名称作用activity发起认证的Activityweiboweibo对象SSO回调接口名称voidauthorizeCallBack(intrequestCode,intresultCode,Intentdata)使用说明在AuthorizeActivity里覆写onActivityResult(intrequestCode,intresultCode,Intentdata),在方法中使用SSOHandler对象调用authorizeCallBack(intrequestCode,intresultCode,Intentdata)SSO认证接口名称voidauthorize(WeiboAuthListenerlistenerweiboAuthListener)使用说明发起sso认证时调用此方法参数名称作用weiboAuthListener用于异步返回服务器的返回结果实例分析以下代码的具体信息请参考weibo.sdk.android.sso.demo工程。svn地址为：北京新潮讯捷信息技术有限公司1.通过Oauth2.0授权获得AccessToken第一步InMainActivity：通过Weibo的构造函数设置应用回调页和appkey。对于Mobile客户端应用来说，是不存在Server的，故此处的应用回调页地址只要与新浪微博开放平台-我的应用-应用信息-高级应用-授权设置-应用回调页中的url地址保持一致就可以了，如图所示：第二步InMainActivity：实现WeiboD