weiboplus

来自于:官方立即使用

shareText shareImage shareVideo shareWebPage auth cancelAuth getUserInfo isInstalled shareMulitImage shareStory

论坛示例

为帮助用户更好更快的使用模块,论坛维护了一个示例,示例中包含示例代码、知识点讲解、注意事项等,供您参考。

概述

微博是一个由新浪网推出,提供微型博客服务类的社交网站。用户可以通过网页、WAP页面、手机客户端、手机短信、彩信发布消息或上传图片。新浪可以把微博理解为“微型博客”或者“一句话博客”。用户可以将看到的、听到的、想到的事情写成一句话,或发一张图片,通过电脑或者手机随时随地分享给朋友,一起分享、讨论;还可以关注朋友,即时看到朋友们发布的信息。

模块概述

weiboPlus 封装了新浪微博开放平台的移动端 SDK,使用此模块可实现新浪微博授权登录,获取用户信息,分享文本、图片、音频、视频、网页等信息到微博移动客户端的功能。登陆授权时,模块内部会先判断当前设备是否安装微博客户端,若没安装则弹出网页版登陆页面,若已安装则跳转到微博客户端提示用户登陆授权。

开发者使用本模块之前须从新浪微博开放平台申请微博开发者账号,微博开发者账号申请成功后需要填写相应信息创建一个app应用,从而获取 App Key。注意:新浪微博服务器不允许在短时间内连续发布两条相同内容的微博,测试时如果连续发送两条内容相同的微博,后者可能不显示。weiboPlus 模块是 weibo 模块的升级版。

模块使用攻略

使用此模块之前建议先配置 config.xml 文件,配置完毕,需通过云端编译生效,配置方法如下:

  • 名称:weiboPlus
  • 参数:urlScheme、apiKey、registUrl
  • 配置示例:
  1. <feature name="weiboPlus">
  2. <param name="urlScheme" value="wb1132217156" />
  3. <param name="apiKey" value="1132217156" />
  4. <param name="registUrl" value="http://www.apicloud.com" />
  5. </feature>
  • 字段描述:

    urlScheme:(必须配置)用于实现应用间跳转及数据交换,本应用可以启动新浪微博客户端,也可以从新浪微博客户端跳回本应用。urlScheme 的 value 值是从新浪微博开放平台获取到的 App Key 拼接前缀 wb 而成的。

    apiKey:从新浪微博开放平台获取的 App Key。

    registUrl:在新浪微博开放平台创建应用时(应用信息 -> 高级信息 -> 授权设置)自定义填写的回调 url。

针对 iOS 平台配置:

iOS 平台上添加白名单,如下:

  1. <preference name="querySchemes" value="sinaweibohd,sinaweibo,weibosdk,weibosdk2.5" />

微博 apiKey 申请参考微博平台接入指南 weiboplus - 图1 weiboplus - 图2

模块接口

shareText

分享文本内容

shareText({params}, callback(ret, err))

params

apiKey:

  • 类型:字符串
  • 描述:(可选项)从新浪开放平台申请的 App Key ,若不传则从当前 widget 的 config.xml 文件读取

text:

  • 类型:字符串
  • 描述:分享的文本,长度小于140个汉字

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. code: 1 //数字类型;
  3. //错误码:
  4. //-1 (apiKey值非法)
  5. //1 (用户取消)
  6. //2 (发送失败)
  7. //3 (授权失败)
  8. //4 (不支持的请求)
  9. //5 (未知错误)
  10. }

示例代码

  1. var weiboPlus= api.require('weiboPlus');
  2. weiboPlus.shareText({
  3. text: '这里是测试的内容',
  4. }, function(ret, err) {
  5. if (ret.status) {
  6. alert('分享文本内容成功');
  7. }
  8. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

shareImage

分享图片内容

shareImage({params}, callback(ret, err))

params

apiKey:

  • 类型:字符串
  • 描述:(可选项)从新浪开放平台申请的 App Key ,若不传则从当前 widget 的 config.xml 文件读取

text:

  • 类型:字符串
  • 描述:(可选项)分享的文本,长度小于140个汉字

imageUrl:

  • 类型:字符串
  • 描述:分享的图片路径,要求本地路径(fs://、widget://),大小不能超过10M

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. code: 1 //数字类型;
  3. //错误码:
  4. //-2 (imageUrl图片资源未找到)
  5. //-1 (apiKey值非法)
  6. //1 (用户取消)
  7. //2 (发送失败)
  8. //3 (授权失败)
  9. //4 (不支持的请求)
  10. //5 (未知错误)
  11. }

示例代码

  1. var weiboPlus= api.require('weiboPlus');
  2. weiboPlus.shareImage({
  3. text: '这里是测试的内容',
  4. imageUrl: 'widget://image/xxx.png'
  5. }, function(ret, err) {
  6. if (ret.status) {
  7. alert('分享图片内容成功');
  8. }
  9. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

shareVideo

分享本地视频资源(需要微博7.8.0 以及以后客户端支持)

shareVideo({params}, callback(ret, err))

params

apiKey:

  • 类型:字符串
  • 描述:(可选项)从新浪开放平台申请的 App Key ,若不传则从当前 widget 的 config.xml 文件读取

text:

  • 类型:字符串
  • 描述:分享的文本,长度小于140个汉字

contentUrl:

  • 类型:字符串
  • 描述:分享本地视频的本地路径(fs://、widget://)

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. code: 1 //数字类型;
  3. //错误码:
  4. //-1 ( apiKey 值非法)
  5. //1 (用户取消)
  6. //2 (发送失败)
  7. //3 (授权失败)
  8. //4 (不支持的请求)
  9. //5 (未知错误)
  10. }

示例代码

  1. var weiboPlus= api.require('weiboPlus');
  2. weiboPlus.shareVideo({
  3. text: '这里是测试的内容',
  4. contentUrl: 'widget://res/apicloud.mp4'
  5. }, function(ret, err) {
  6. if (ret.status) {
  7. alert('分享成功');
  8. }
  9. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

shareWebPage

分享网页

shareWebPage({params}, callback(ret, err))

params

apiKey:

  • 类型:字符串
  • 描述:(可选项)从新浪开放平台申请的 App Key ,若不传则从当前 widget 的 config.xml 文件读取

text:

  • 类型:字符串
  • 描述:(可选项)分享的文本,长度小于140个汉字

title:

  • 类型:字符串
  • 描述:分享网页的标题,不能为空且长度小于1k

description:

  • 类型:字符串
  • 描述:(可选项)分享网页的描述,长度小于1k

thumb:

  • 类型:字符串
  • 描述:分享网页的缩略图地址,要求本地路径(fs://、widget://),大小小于32k

contentUrl:

  • 类型:字符串
  • 描述:分享网页的 url 地址,不能为空且长度不能超过255

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. code: 1 //数字类型;
  3. //错误码:
  4. //-1 ( apiKey 值非法)
  5. //1 (用户取消)
  6. //2 (发送失败)
  7. //3 (授权失败)
  8. //4 (不支持的请求)
  9. //5 (未知错误)
  10. }

示例代码

  1. var weiboPlus= api.require('weiboPlus');
  2. weiboPlus.shareWebPage({
  3. text: '这里是测试的内容',
  4. title: '测试标题',
  5. description: '分享内容的描述',
  6. thumb: 'widget://a.jpg',
  7. contentUrl: 'http://apicloud.com'
  8. }, function(ret, err) {
  9. if (ret.status) {
  10. alert('分享成功');
  11. }
  12. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

auth

授权登录(用于实现第三方登录

auth({params}, callback(ret, err))

params

apiKey:

  • 类型:字符串
  • 描述:(可选项)从新浪微博开放平台申请的 App Key,若不传则从当前 widget 的 config.xml 中读取,不传或传入错误的 apiKey,则无法打开新浪微博进行登录。

registUrl:

  • 类型:字符串
  • 描述:(可选项)在新浪微博开放平台创建应用时(应用信息 -> 高级信息 -> 授权设置)自定义填写的回调 url,若为空则从当前 widget 的 config.xml 中读取

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true, //布尔型;true||false
  3. token: '', //字符串类型;从新浪微博服务器获取的 accessToken,接口调用凭证,传给 getUserInfo 接口获取用户信息
  4. expire: '', //字符串类型:token 有效期(时间戳)
  5. userId: '' //字符串类型;从新浪微博服务器获取的 userId,新浪微博分配的用户id,传给 getUserInfo 接口获取用户信息
  6. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. code: 1 //数字类型;错误码
  3. //取值范围:
  4. //-1(apiKey 或 registUrl 值非法)
  5. //1(用户取消)
  6. //2 (发送失败)
  7. //3 (授权失败)
  8. //4 (不支持的请求)
  9. //5 (未知错误)
  10. }

示例代码

  1. var weiboPlus= api.require('weiboPlus');
  2. weiboPlus.auth(function(ret, err) {
  3. if (ret.status) {
  4. alert(JSON.stringify(ret));
  5. }
  6. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

cancelAuth

取消授权,退出登录状态

cancelAuth(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. code: 1 //数字类型;错误码
  3. //取值范围:
  4. //1(尚未登录)
  5. }

示例代码

  1. var weiboPlus= api.require('weiboPlus');
  2. weiboPlus.cancelAuth(function(ret, err) {
  3. if (ret.status) {
  4. api.alert({ msg: '登出成功' });
  5. }
  6. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getUserInfo

获取用户账户信息,调用本接口前,需要先调用 auth 接口授权

getUserInfo({params}, callback(ret, err))

params

token:

  • 类型:字符串
  • 描述:(可选项)登录账号获取的token值
  • 默认值:当前已登录账号的 token

userId:

  • 类型:字符串
  • 描述:(可选项)登录账号获取的 userId
  • 默认值:当前已登录账号的 userId

callback(ret, err)

ret:

  1. {
  2. status: true, //布尔型;true||false
  3. userInfo: {} //JSON对象;获取的用户信息(微博返回)
  4. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. code: 1 //数字类型:错误码
  3. //取值范围:
  4. //-1 (token 或 userId 非法)
  5. //1 (网络超时)
  6. }

示例代码

  1. var weiboPlus= api.require('weiboPlus');
  2. weiboPlus.getUserInfo({
  3. token: '',
  4. userId: ''
  5. }, function(ret, err) {
  6. if (ret.status) {
  7. alert(JSON.stringify(ret.userInfo));
  8. }
  9. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

isInstalled

判断是否已安装新浪微博客户端

isInstalled({params}, callback(ret, err))

params

apiKey:

  • 类型:字符串
  • 描述:(可选项)从新浪微博开放平台申请的 App Key,若不传则从当前 widget 的 config.xml 中读取,不传或传入错误的 apiKey,则无法判断是否已安装新浪微博客户端。

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:

    1. {
    2. status: true, //布尔型;true||false
    3. }

示例代码

  1. var weiboPlus= api.require('weiboPlus');
  2. weiboPlus.isInstalled(
  3. function(ret) {
  4. if (ret.status) {
  5. alert('已安装新浪微博客户端');
  6. } else {
  7. alert('未安装新浪微博客户端');
  8. }
  9. }
  10. );

可用性

Android系统,iOS系统

可提供的1.0.0及更高版本

shareMulitImage

分享多图

shareMulitImage({params}, callback(ret, err))

params

apiKey:

  • 类型:字符串
  • 描述:(可选项)从新浪开放平台申请的 App Key ,若不传则从当前 widget 的 config.xml 文件读取

text:

  • 类型:字符串
  • 描述:(可选项)分享的文本,长度小于140个汉字

mulitImage:

  • 类型:字符数组
  • 描述:图片本地地址集合,只能分享本地图片,支持widget路径、fs路径

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. code: 1 //数字类型;
  3. //错误码:
  4. //-2 (图片资源未找到)(iOS支持)
  5. //-1 ( apiKey 值非法)
  6. //1 (用户取消)
  7. //2 (发送失败)
  8. //3 (授权失败)(iOS支持)
  9. //4 (不支持的请求)(iOS支持)
  10. //5 (未知错误)
  11. }

示例代码

  1. var weiboPlus= api.require('weiboPlus');
  2. weiboPlus.shareMulitImage({
  3. text: 'shareMulitImageText',
  4. multiImage:['widget://image/api1.png','widget://image/api2.png','widget://image/api3.png','widget://image/api4.png','widget://image/api6.png']
  5. }, function(ret, err) {
  6. if (ret.status) {
  7. alert('分享成功');
  8. }
  9. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

shareStory

分享微博故事

shareStory({params}, callback(ret, err))

params

apiKey:

  • 类型:字符串
  • 描述:(可选项)从新浪开放平台申请的 App Key ,若不传则从当前 widget 的 config.xml 文件读取

image:

  • 类型:字符串
  • 描述:分享图片地址,要求本地路径(fs://、widget://)(与video 二选一,都存在优先image)

video:

  • 类型:字符串
  • 描述:分享视频的地址,要求本地路径(fs://、widget://)(与image 二选一,都存在优先image)

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. code: 1 //数字类型;
  3. //错误码:
  4. //-2 (图片或视频资源未找到)(iOS支持)
  5. //-1 ( apiKey 值非法)
  6. //1 (用户取消)
  7. //2 (发送失败)
  8. //3 (授权失败)(iOS支持)
  9. //4 (不支持的请求)(iOS支持)
  10. //5 (未知错误)
  11. }

示例代码

  1. var weiboPlus= api.require('weiboPlus');
  2. weiboPlus.shareStory({
  3. video:'widget://res/apicloud.mp4'
  4. }, function(ret, err) {
  5. if (ret.status) {
  6. alert('分享成功');
  7. }
  8. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

论坛示例

为帮助用户更好更快的使用模块,论坛维护了一个示例,示例中包含示例代码、知识点讲解、注意事项等,供您参考。