插件封装了百度OAuth相关SDK,OAuth2.0(开放授权)是一个开放标准,用户授权后,第三方应用无需获取用户的用户名和密码就可以访问该用户在某一网站上存储的私密的资源(如照片,视频,联系人列表)。
Access Token:用户身份验证和授权的凭证。第三方应用在调用百度开放API之前,首先需要获取Access Token。
使用本插件前需要先到百度开发者中心注册账号并创建应用。
android注意项
为确保验证授权过程的安全,开发者必须在开发者中心预先注册应用所在的域名或URL,参考链接
初始化Baidu SDK
initBaiduLogin({param})
apiKey:
appId:
var demo = api.require('bLogin');
demo.initBaiduLogin({
apiKey : '7TjGqkwAU5rQPcC6LKGMjpKd',
appId : '2014185'
});
使用此插件,必须先用initBaiduLogin初始化
iOS系统,android系统
可提供的1.0.0及更高版本
判断用户的授权状态
isUserTokenValid(callback(ret))
ret:
{
valid : true //布尔类型;是否有效
}
var demo = api.require('bLogin');
demo.isUserTokenValid(function(ret) {
if (ret) {
api.alert({msg: JSON.stringify(ret)});
}
});
iOS系统,android系统
可提供的1.0.0及更高版本
用户登录,进行授权
authorize(callback(ret))
ret:
{
state : 'success' //字符串类型;授权是否成功
// 取值范围:
// 'success' : 授权成功
// 'cancel' : 授权取消(由于百度SDK的限制,android不支持此字段,会以Toast形式弹出)
// 'error' : 发生错误
accessToken : '' //字符串类型;令牌,当state为 success时返回此字段
errorDesc : '' //字符串类型;错误描述,当state为 error时返回此字段
}
var demo = api.require('bLogin');
demo.authorize(function(ret) {
if (ret) {
api.alert({msg: JSON.stringify(ret)});
}
});
iOS系统,android系统
可提供的1.0.0及更高版本
用户短信授权
smsAuthorize(callback(ret))
ret:
{
state : 'success' //字符串类型;授权是否成功
// 取值范围:
// 'success' : 授权成功
// 'cancel' : 授权取消
// 'error' : 发生错误
accessToken : '' //字符串类型;令牌,当state为 success时返回此字段
errorDesc : '' //字符串类型;错误描述,当state为 error时返回此字段
}
var demo = api.require('bLogin');
demo.smsAuthorize(function(ret) {
if (ret) {
api.alert({msg: JSON.stringify(ret)});
}
});
iOS系统
可提供的1.0.0及更高版本
用户注册
userRegister()
var demo = api.require('bLogin');
demo.userRegister();
iOS系统
可提供的1.0.0及更高版本
调用Open API方法
apiRequest({param},callback(ret))
url:
httpMethod:
params:
ret:
{
state : 'success' //字符串类型;请求是否成功
// 取值范围:
// 'success' : 请求成功
// 'error' : 发生错误
results : [{},{},...] //数组类型;请求结果,当state为 success时返回此字段(android不是数组,就是一个JSON字符串)
errorDesc : '' //字符串类型;错误描述,当state为 error时返回此字段
}
var demo = api.require('bLogin');
demo.apiRequest({
url : 'https://openapi.baidu.com/rest/2.0/passport/users/getLoggedInUser',
},function(ret) {
if (ret) {
api.alert({msg: JSON.stringify(ret)});
}
});
iOS系统,android系统
可提供的1.0.0及更高版本
用户登出
currentUserLogout()
var demo = api.require('bLogin');
demo.currentUserLogout();
iOS系统,android系统
可提供的1.0.0及更高版本