微博WP7平台SDK使用说明.docVIP

WP7平台新浪微博SDK使用说明书 编号：WEIBO_WP7_SDK 版本：WEIBO_WP7_SDK V1.0.1 修订记录 时间 文档版本 修订人 备注 2011/8/03 1.0.0 李楠(@预备影帝) 第一版 2011/12/12 1.0.1 李楠 第二版 WP7平台新浪微博SDK使用说明书 1 概述 3 授权模式 3 SDK使用说明 3 1. 环境安装 3 2. 引入所需SDK类库 3 接口说明 6 1. OAuth1.0 授权页方式 6 2. OAuth1.0用户名密码方式(XAuth) 6 3. OAuth2.0 授权页方式 7 4. Oauth2.0 用户名密码方式 7 5. 刷新access_token(Oauth2.0) 7 6. 微博数据请求 7 7. 调用发送微博界面 8 8. 调用分享微博界面 8 SDK实例使用说明 9 1. 设置SDK所需参数 9 2. Oauth授权页 9 3. OAuth用户名密码方式认证 10 4. 发送微博 11 5. 分享微博 13 6. 微博数据请求 14 返回数据处理及错误处理 15 注意 17 ×请求类型× 18 问题反馈 19 【更新日志】 19 概述 新浪微博Windows Phone 7平台官方SDK包提供给第三方开发者OAuth和XAuth两种登录方式、默认的发送/分享微博界面及其它Open API的URL请求，大大简化了第三方集成微博相关服务的难度。当前微博SDK开发包仅支持WP7芒果版Beta2 Refresh SDK开发环境。集成的OPEN API版本为V3版，支持XML和JSON两种数据交换格式，以后会随着OPEN API的版本升级而提高更新的微博SDK包。 授权模式 OAUTH授权：oauth是一种常见的授权模式，用户可以更安全放心的使用用户身份，而不必把用户名和密码透露给第三方。见实例分析中登录分析。 【Sdk支持OAuth1.0、和OAuth2.0鉴权方式（OAuth2.0中的Password方式近似于XAuth授权，需权限申请）】 XAUTH授权：xauth授权方式是oauth1.0授权的简化版，目的是对移动客户端有更好的用户体验。见API分析中xauth接口说明。 Notice : xauth授权需要特殊权限的consumer key和secret，具体规则可参考：/wiki/授权机制说明 环境安装 安装Windows Phone 7相关开发环境 引入所需SDK类库 (1)直接引入dll: 按默认的开发向导新建自己的开发工程，找到SinaBase.dll、WeiboService.dll、WeiboSdk.dll并引用。 以WindowsPhoneApplication和WindowsPhoneGame模板为基础，在这两个项目中分别添加了对SinaBase.dll, WeiboService.dll,WeibSDK.DLL的引用，使您可以直接建立支持微博服务应用的项目。 步骤1：安装 点击下图所示两个文件，将此插件安装到您的Visual 点击*.vsix文件后出现如下对话框： 点击安装，安装完毕后出现如下对话框 点选关闭，重启或进入您的Visual Studio 2010中，依次选取工具(扩展管理工具，出现如下对话框： 步骤2：使用在新建项目时，会在已安装模板C#条目下出现两个新的模板，如： SinaBase, WeiboService,WeiboSDK的引用，为大家开发微博应用提供方便，如下图所示： 接口说明 OAuth1.0 授权页方式 考虑到用户安全，微博SDK提供跳转到网页形式的OAuth登录。对于网页形式的登陆正确使用WeiboSdk中的”OAuthControl“控件即可。（在模拟器中该控件使用的WebBrowser可能偶尔会有一些问题，建议用真机进行调试）。关于该控件的详细使用见“SDK实例使用说明---OAuth登录” OAuth1.0用户名密码方式(XAuth) XAuth登录 接口名称 void XAuthLogin(string userName, string passWord, bool ifSave = false, LoginBack callBack = null) 参数名称 作用 userName 微博账户名 passWord 微博账户密码 ifSave 是否由 callBack 登录成功/失败的回调 “OAuth2_0Control” 控件, 用法同OAuth1.0 授权页方式. Oauth2.0 用户名密码方式 OAuth2.0 password方式登录 接口名称 void GetA