uexSina查看3.0文档

接入指引部分:

1、简介

新浪分享插件

1.1、说明

调用新浪分享文字,图片.

iOS 9 以后,为了预防APP通过非正常渠道获取用户的某些隐私信息,Apple启用了URLScheme白名单机制.

  • 为了正常使用插件的所有功能还需要配置URLScheme白名单(什么是URLScheme白名单)
  • 配置白名单方法请参考这里
  • uexSina需要进白名单添加的URLScheme如下
<string>sinaweibohd</string>
<string>sinaweibo</string>
<string>sinaweibosso</string>
<string>sinaweibohdsso</string>
<string>weibosdk</string>
<string>weibosdk2.5</string>
  • iOS App用过uexSina插件打开新浪客户端进行授权、分享过程完成后,新浪客户端通过应用自定义的UrlScheme返回到本App,并传回授权、分享结果时,需要配置UrlScheme值.通过config.xml配置插件的方法如下
<config desc="uexSina" type="URLSCHEME">
    <urlScheme name="uexSina" schemes="['wb407216840']"/>
</config>

其中'wb407216840'的'407216840'改成您自己申请到的新浪appkey,需要是wb+appkey的形式

1.2、UI展示

1.3、开源源码

插件测试用例与源码下载:点击 插件中心至插件详情页 (插件测试用例与插件源码已经提供)

1.4、术语表

Path Types

协议头 Android对应路径 (其中"/sdcard/"等 同于"/storage/emulated/0/") iOS对应路径
res:// widget/wgtRes/ widget/wgtRes
wgts:// /storage/emulated/0/widgetone/apps/ xxx(widgetAppId)/ /Documents/apps/xxx(widgetAppId)/
wgts:// /storage/emulated/0/widgetone/widgets/ /Documents/widgets/
file:///sdcard/ /storage/emulated/0/
1.5、平台版本支持

本插件的所有API默认支持Android4.0+iOS7.0+操作系统. 有特殊版本要求的API会在文档中额外说明.

1.6、接口有效性

本插件所有API默认在插件版本4.0.0+可用. 在后续版本中新添加的接口会在文档中额外说明.

2、API概览

2.1、方法
login //登录

uexSina.login(appKey,registerUrl, callbackFunction);

说明:

用户登录, 支持SSO登录.如果手机上端有微博客户端,会直接调用客户端进行登录授权.如果没有,则开启网页让用户登录授权.

参数:

参数名称 参数类型 是否必选 说明
appKey String 通过开放平台注册的appKey,appKey申请点击跳转
registerURL String 通过开放平台注册的registerURL
callbackFunction Function 回调函数,用来获取相关业务数据

回调参数:

var callbackFunction = function(error, data){}
参数名称 类型 说明
error Number 0表示获取成功,非0表示获取失败
data Object error非0返回NULL;error为0,其数据格式如下:
var data = {
    "uid": "1820127523",
    "expires_in": 1465844397060,
    "access_token": "2.00X_ELzBXB6a8E0b24b217d5CYmpKE",
    "refresh_token": "2.00X_ELzBXB6a8Ef59d49d381oDgtuC"
}

示例:

var appKey = "4072168403";
var registerUrl = "http://www.dotlink.com";
uexSina.login(appKey,registerUrl,function(error,data){
     if(!error){
     alert(JSON.stringify(data));
     }
});
getUserInfo //获取用户基本信息

uexSina.getUserInfo(callbackFunction);

说明:

返回该用户的新浪微博相关信息,如用户名,姓别,所在地等.

参数:

参数名称 参数类型 是否必选 说明
callbackFunction Function 回调函数,用来获取相关业务数据

回调参数:

var callbackFunction = function(data){}
参数名称 类型 说明
data Object 包含用户的基本信息,信息中包含字段请参考新浪官方文档

示例:

var commonCallback = function(data) {
    alert("commonCallback:" + JSON.stringify(data));
}
uexSina.getUserInfo(commonCallback);
logout //退出

uexSina.logout(callbackFunction);

说明:

注销该新浪微博帐号

参数:

参数名称 参数类型 是否必选 说明
callbackFunction Function 回调函数,返回退出是否成功的状态

回调参数:

var callbackFunction = function(data){}
参数名称 类型 说明
data Number 退出是否成功,0-成功,1-失败

示例:

uexSina.logout(function(data) {
    alert(data); 
});
sendTextContent //分享文字

uexSina.sendTextContent(txt, callbackFunction)

说明:

分享文字

参数:

参数名称 参数类型 是否必选 说明
txt String 文本内容
callbackFunction Function 回调函数,返回分享是否成功的状态

回调参数:

var callbackFunction = function(data){}
参数名称 类型 说明
data Number 分享是否成功,0-成功,1-失败

示例:

var txt = "中国最大的移动中间平台AppCan对新浪微博分享支持测试";
uexSina.sendTextContent(txt, function(data) {
    alert(data); // data: 0 成功, 1 失败
});
sendImageContent //分享图片

uexSina.sendImageContent(imagePath,txt, callbackFunction)

说明:

如果要分享网络图片需要申请新浪微博高级权限

参数:

参数名称 参数类型 是否必选 说明
imagePath String 图片路径,路径协议详见CONSTANT中PathTypes.
txt String 文本内容
callbackFunction Function 回调函数,返回分享是否成功的状态

回调参数:

var callbackFunction = function(data){}
参数名称 类型 说明
data Number 分享是否成功,0-成功,1-失败

示例:

var content = "中国最大的移动中间平台AppCan对新浪微博分享的图片支持测试";
var realImgPath = "res://sotower.png";
uexSina.sendImageContent(realImgPath, content,function(data) {
    alert(data); 
});

3、更新历史

iOS

API版本: uexSina-4.0.0

最近更新时间:2016-06-06

历史发布版本 更新内容
Android

API版本: uexSina-4.0.0

最近更新时间:2016-06-06

历史发布版本 更新内容

开发者在使用AppCan平台提供的新浪微博插件时,需要配置相关的包名,AppKey和签名。具体步骤如下(以大众版打包为例):

4、准备工作

4.1获取apk包名
4.1.1 AppCan平台默认包名

AppCan平台默认包名为:org.zywx.wbpalmstar.widgetone.uex加上应用id,如下:

    则默认的包名为:org.zywx.wbpalmstar.widgetone.uex11370920。
4.1.2 自定义包名

AppCan大众版打包时,在"云端打包"项中可以自定义包名,如下:

例如包名为org.zywx.wbpalmstar.widgetone.uexsina,若该处不填,则为默认包名。

4.2获取apk签名
4.2.1 AppCan平台默认签名

“云端打包”中“选择证书”一项选择AppCan证书,打包出来的apk的签名即为默认签名,默认为:d382d671c6672cba4b87980992cd9d77

4.2.2 自定义签名

在AppCan大众版打包时,在“证书管理”项中可以上传应用打包所需的自定义签名文件,并在"云端打包"时,“选择证书”一项选择自定义证书。该证书打出来的包签名应该在生成此证书时可以得到。

4.3获取iphone应用Bundle ID

如果你的苹果应用使用的是苹果证书,上传的是299$企业证书还是99$发布证书,Bundle ID即是AppCan官网上传证书时自动获取的App IDs; 如果你的苹果应用使用的是AppCan默认的越狱证书,没有上传任何证书。Bundle ID即是com.zywx.appcan1111111,111111是对应的应用id(AppCan创建应用时给你分配的那个应用ID)。

5、 通过包名和签名申请接入AppKey

5.1 注册账号

在微博开放平台http://open.weibo.com/ 注册开发者账号。

5.2 创建应用

注册成功并登陆之后选择“移动应用”,如下:

进入如下界面:

点击“创建应用”,填写对应信息,在应用基本信息栏中填入获取的包名和签名,如下:

信息填完之后还需要完成身份认证,然后再提交审核。审核通过之后可以在应用详情界面获得AppKey和AppSecret。

6、插件接口调用

在使用uexSina插件时,调用uexSina.registerApp(appKey,appSecret,registerUrl),传入申请的AppKey和AppSecret,registerUrl默认为"https://api.weibo.com/oauth2/default.html", 即可注册成功。之后可调用分享的相关接口。

7、常见问题

7.1 授权出错
  • Q:21338 sso package or sign error
  • A:平台设置和项目设置的Bundle id不一致导致的,必须保证字符完全匹配。

  • Q:iOSWeiboSDK授权后为什么没有返回应用?

  • A:检查配置,config.xml里设置的Scheme是否正确,需要是wb+appkey的形式,详见文档

  • Q:弹出授权窗口后瞬间消失

  • A:可能bundle id不一致导致
7.2 registerApp接口调用之后打开的页面显示异常

如下:

该问题的原因是该apk中包名、签名和AppKey不配套,需仔细检查在新浪微博开放平台创建应用时填写的包名、签名是不是和在AppCan平台打包时的包名、签名一致。或者是创建的应用未审核通过。

还需要帮助吗? 联系我们
最新更新 10th Dec 2016