宜信同城网交流论坛技术专版技术专区OAuth模块管理客户端的用户登录鉴权功能，允许应用访问第三方平台的资源 ...OAuth接口支持开发者调用当前环境中安装的三方客户端App（如微信、微博等）的授权登录页面进行 ...

admin 发表于 2023-2-16 18:54:49

OAuth模块管理客户端的用户登录鉴权功能，允许应用访问第三方平台的资源 ...

<div id="article_content" class="article_content clearfix">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/kdoc_html_views-1a98987dfd.css">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/ck_htmledit_views-6e43165c0a.css">
 <div id="content_views" class="htmledit_views">
 <div id="content" style="margin-left:auto;">
OAuth接口支持开发者调用当前环境中安装的三方客户端App（如微信、微博等）的授权登录页面进行鉴权操作。若终端安装了对应的客户端App，则调用客户端的授权登录页面，否则调用WAP页面进行授权登录。
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.getServices">getServices</a>: 获取登录鉴权列表</li></ul>
<h2 style="margin-left:.8em;">对象：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AuthService">AuthService</a>: 登录鉴权服务对象</li><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.AppleInfo">AppleInfo</a>: 苹果登录认证信息</li><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.AuthOptions">AuthOptions</a>: JSON对象，授权认证参数选项</li><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.AuthInfo">AuthInfo</a>: 登录授权认证信息</li><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.UserInfo">UserInfo</a>: 登录授权用户信息</li><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.UniverifyStyles">UniverifyStyles</a>: 一键登录授权界面样式参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.UniverifyIconStyles">UniverifyIconStyles</a>: 一键登录授权界面图标样式参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.UniverifyPhoneNumStyles">UniverifyPhoneNumStyles</a>: 一键登录授权界面电话号码文本样式参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.UniverifySloganStyles">UniverifySloganStyles</a>: 一键登录授权界面服务说明文字样式参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.UniverifyAuthButtonStyles">UniverifyAuthButtonStyles</a>: 一键登录授权界面登录按钮样式参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.UniverifyOtherButtonStyles">UniverifyOtherButtonStyles</a>: 一键登录授权界面其它按钮样式参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.UniverifyPrivacyTermsStyles">UniverifyPrivacyTermsStyles</a>: 一键登录服务协议样式参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.UniverifyPrivacyItemStyles">UniverifyPrivacyItemStyles</a>: 自定义服务协议链接样式参数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.UniVerifyButtonsStyles">UniVerifyButtonsStyles</a>: 自定义登录按钮列表样式</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.UniVerifyButtonStyles">UniVerifyButtonStyles</a>: 自定义登录按钮样式</li></ul>
<h2 style="margin-left:.8em;">回调方法：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.ServicesSuccessCallback">ServicesSuccessCallback</a>: 获取登录授权认证服务成功回调</li><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.AuthorizeSuccessCallback">AuthorizeSuccessCallback</a>: 授权认证成功回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.LogoutSuccessCallback">LogoutSuccessCallback</a>: 注销登录授权认证操作成功回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.SuccessCallback">SuccessCallback</a>: 登录授权认证服务操作成功回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.ErrorCallback">ErrorCallback</a>: 登录授权认证服务操作失败回调函数</li></ul>
<h2 style="margin-left:.8em;">权限：</h2>
permissions
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
{
// ...
"permissions":{
// ...
"OAuth": {
"description": "登录鉴权"
}
}
}
</code></code></pre>
<h1 style="margin-left:0;">getServices</h1>
获取登录鉴权列表
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.oauth.getServices( successCB, errorCB );
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
获取终端支持的权登录认证服务列表，可用于提示用户进行登录平台的选择。获取登录鉴权成功后通过successCB回调返回支持的所有服务列表，获取服务失败则通过errorCB回调返回失败信息。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.ServicesSuccessCallback">ServicesSuccessCallback</a> ) 必选 获取登录鉴权服务成功回调函数 获取登录鉴权服务列表成功时触发回调，并返回当前环境支持的登录鉴权服务列表。 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.ErrorCallback">ErrorCallback</a> ) 可选 获取登录鉴权服务失败回调函数 获取登录鉴权服务列表失败时触发回调，并返回错误信息。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 微信登录鉴权服务
var aweixin=null;
// 当前环境支持的所有登录鉴权服务
var auths = {};

// 获取登录鉴权服务列表，单独保存微信登录鉴权服务对象
// 5+APP在plusready事件中调用，uni-app在vue页面的onLoad中调用
function getService(){
plus.oauth.getServices(function(services){
for(var i in services){
auths[service.id]=service;
}
aweixin = auths['weixin'];
}, function(e){
plus.nativeUI.alert("获取登录鉴权服务列表失败："+JSON.stringify(e));
} );
}

</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">AuthService</h1>
登录鉴权服务对象
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.oauth.AuthService {
// Attributes
attribute String id;
attribute String description;
attribute Boolean nativeClient;

attribute AppleInfo appleInfo;
attribute AuthInfo authResult;
attribute UserInfo userInfo;
attribute JSON extra;

// Methods 
function void authorize(successCallback, errorCallback, options);
function void closeAuthView();
function void login(successCallback, errorCallback, options);
function void logout(successCallback, errorCallback);
function void getUserInfo(successCallback, errorCallback);
function void preLogin(successCallback, errorCallback);
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
AuthService对象用于表示登录鉴权服务，在JS中为对象，用于发起登录授权认证操作。
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AuthService.id">id</a>: 登录鉴权服务标识</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AuthService.description">description</a>: 登录鉴权服务描述</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AuthService.nativeClient">nativeClient</a>: 授权登录依赖的客户端App是否已安装</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AuthService.appleInfo">appleInfo</a>: 苹果登录认证数据</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AuthService.authResult">authResult</a>: 登录认证数据</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AuthService.userInfo">userInfo</a>: 登录用户信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AuthService.extra">extra</a>: 登录授权认证扩展信息</li></ul>
<h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AuthService.authorize">authorize</a>: 请求授权认证</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AuthService.closeAuthView">closeAuthView</a>: 关闭授权登录界面</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AuthService.login">login</a>: 请求登录认证</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AuthService.logout">logout</a>: 注销登录认证</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AuthService.getUserInfo">getUserInfo</a>: 获取用户信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AuthService.preLogin">preLogin</a>: 预登录</li></ul>
<h1 style="margin-left:0;">id</h1>
登录鉴权服务标识
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性
用于表示登录鉴权服务标识：
<ul><li>"weixin" - 表示微信登录鉴权</li><li>"qq" - 表示QQ登录鉴权</li><li>"sinaweibo" - 表示新浪微博登录鉴权</li><li>"xiaomi" - 表示小米登录鉴权</li><li>"apple" - 表示苹果登录（仅iOS13+系统支持）</li><li>"univerify" - 表示一键登录（HBuilderX3.0.0+版本支持），详情参考<ahref="https://ask.dcloud.net.cn/article/38009">一键登录使用指南</a></li><li>"google" - 表示Google登录（HBuilderX3.2.7+版本支持）</li><li>"facebook" - 表示Facebook登录（HBuilderX3.2.7+版本支持）</li></ul>

<h1 style="margin-left:0;">description</h1>
登录鉴权服务描述
<h2 style="margin-left:.8em;">说明：</h2>
String 类型只读属性可选属性
用于描述登录鉴权服务的信息：
<ul><li>"微信" - 表示微信登录鉴权；</li><li>"QQ" - 表示QQ登录鉴权；</li><li>"新浪微博" - 表示新浪微博登录鉴权；</li><li>"小米" - 表示小米登录鉴权；</li><li>"Apple" - 表示苹果登录；</li><li>"一键登录" - 表示一键登录（HBuilderX3.0.0+版本支持），详情参考<ahref="https://ask.dcloud.net.cn/article/38009">一键登录使用指南</a></li><li>"Google" - 表示Google登录（HBuilderX3.2.7+版本支持）</li><li>"Facebook" - 表示Facebook登录（HBuilderX3.2.7+版本支持）</li></ul>

<h1 style="margin-left:0;">nativeClient</h1>
授权登录依赖的客户端App是否已安装
<h2 style="margin-left:.8em;">说明：</h2>
Boolean 类型只读属性
对于某些登录鉴权服务，必须依赖相应客户端App才能实现授权操作；有些登录鉴权服务则无需客户端App，或者依赖的客户端App不存在时调用WAP页面进行授权操作。 具体情况如下：
<ul><li>微信 - 依赖微信客户端App</li><li>QQ - 依赖QQ客户端App</li><li>新浪微博 - 不依赖微博客户端App，不存在是调用WAP页面登录授权操作</li><li>小米登录 - 无需客户端App</li><li>苹果登录 - 无需客户端App</li><li>一键登录 - 无需客户端App</li><li>Google登录 - 无需客户端App</li><li>Facebook登录 - 无需客户端App</li></ul>
注意：提交AppStore审核时没有安装相应的客户端App可能导致无法通过审核，此时需要判断相应的客户端App是否安装，如果没有安装则不显示对应的登录入口。 HBuilderX3.1.19及以上版本支持。

<h1 style="margin-left:0;">appleInfo</h1>
苹果登录认证数据
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AppleInfo">AppleInfo</a> 类型只读属性可选属性
调用login登录认证成功后保存的苹果认证信息。
<h1 style="margin-left:0;">authResult</h1>
登录认证数据
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AuthInfo">AuthInfo</a> 类型只读属性可选属性
调用login登录认证成功后保存的认证信息。如果值为"undefined"则表示未进行登录认证或者登录认证失败。
<h1 style="margin-left:0;">userInfo</h1>
登录用户信息
<h2 style="margin-left:.8em;">说明：</h2>
<ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.UserInfo">UserInfo</a> 类型只读属性可选属性
调用用于保存登录授权认证获取的用户信息，如果值为"undefined"则表示未获取过用户信息。
<h1 style="margin-left:0;">extra</h1>
登录授权认证扩展信息
<h2 style="margin-left:.8em;">说明：</h2>
JSON 类型只读属性可选属性
用于保存登录鉴权服务返回的扩展信息，具体内容由各登录平台决定，如果没有扩展信息则为undefined。例如“微信”，则可保存以下数据： state - 用于保持请求和回调的状态参数。
<h1 style="margin-left:0;">authorize</h1>
请求授权认证
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>

void obj.authorize(successCallback, errorCallback, options);

</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
向开放平台请求进行授权认证，需提供授权域（scope），用户在终端确认后通过成功回调返回授权临时票据（code）。开发者可以将授权临时票据（code）提交到业务服务器，由业务服务器从微信开放平台获取授权登录等相关信息，避免将appsecret等信息保存在客户端可能引起泄露的问题。注意：目前仅微信平台支持请求授权认证，其它平台调用此方法将返回错误回调。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCallback: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AuthorizeSuccessCallback">AuthorizeSuccessCallback</a> ) 必选 成功回调函数 授权认证操作成功时触发，并返回授权票据（code）。 </li><li>errorCallback: ( <ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.ErrorCallback">ErrorCallback</a> ) 可选 错误回调函数 授权认证操作失败时触发，并返回错误信息（code&message）. </li><li>options: ( <ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.AuthOptions">AuthOptions</a> ) 可选 授权认证的参数 授权认证平台支持的参数，微信开放平台支持： scope - 申请的权限作用范围； state - 自定义数据，成功回调时返回； appid - 开放平台申请的应用标识，如果不配置，则使用应用打包时配置的appid。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 微信授权登录对象
var aweixin=null; // 调用plus.oauth.getServices获取保存

// 获取微信登录授权对象后可进行授权操作
function authorize(){
if(!aweixin){
plus.nativeUI.alert("当前环境不支持微信登录");
return;
}
aweixin.authorize(function(e){
plus.nativeUI.alert("授权成功："+JSON.stringify(e));
}, function(e){
plus.nativeUI.alert("授权失败："+JSON.stringify(e));
}, {scope:'snsapi_userinfo',state:'authorize test',appid:'WX**********'});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">closeAuthView</h1>
关闭授权登录界面
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>

void obj.closeAuthView();

</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
仅一键登录支持，请求登录认证操作完成后，不管成功或失败都不会关闭一键登录界面，需要主动调用此方法关闭。客户端登录认证完成只是说明获取 access_token 成功，需要将此数据提交到服务器获取手机号码，完成业务服务登录逻辑后通知客户端关闭登录界面。详情参考<ahref="https://uniapp.dcloud.io/univerify">uni-app官网</a>
<h2 style="margin-left:.8em;">参数：</h2>
无
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">login</h1>
请求登录认证
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>

void obj.login(successCallback, errorCallback, options);

</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
在登录前可通过对象的authResult属性判断是否已经登录认证过，通常只需对没有登录认证过的服务进行此操作。登录后可获取应用的基础信息（如用户昵称等）保存在authResult属性中。登录操作成功后通过successCallback回调函数通知，失败则通过errorCallback回调函数通知。 注意，由于业务需求的差异，不同授权登录平台返回数据的处理逻辑可能不同：
<ul><li>微信登录 - 在客户端配置appSecret可能存在参数泄露的隐患，可以在客户端获取授权临时票据（code）后提交到业务服务器，有业务服务器向微信开放平台获取详细信息，详情参考<ahref="https://ask.dcloud.net.cn/article/192#secret">https://ask.dcloud.net.cn/article/192</a></li><li>一键登录 - 授权登录在客户端仅可以openid和access_token，需要将此数据提交业务服务器换手机号码，详情参考<ahref="https://uniapp.dcloud.io/univerify">uni-app官网</a></li></ul>

<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCallback: ( <ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.SuccessCallback">SuccessCallback</a> ) 必选 登录认证成功回调函数 登录认证操作成功时触发，并返回登录认证成功信息。 </li><li>errorCallback: ( <ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.ErrorCallback">ErrorCallback</a> ) 可选 登录认证失败回调函数 登录认证操作失败时触发，并返回错误信息。 </li><li>options: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.AuthOptions">AuthOptions</a> ) 可选 登录认证参数 登录认证使用的额外参数。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 微信授权登录对象
var aweixin=null; // 调用plus.oauth.getServices获取保存

// 通常登录前需要先调用authorize方法进行授权

// 获取微信登录授权对象后可进行登录认证操作
function authLogin(){
if(!aweixin){
plus.nativeUI.alert("当前环境不支持微信登录");
return;
}
if(!aweixin.authResult){
aweixin.login(function(e){
plus.nativeUI.alert("登录认证成功!");
}, function(e){
plus.nativeUI.alert("登录认证失败: "+JSON.stringify(e));
} );
}else{
plus.nativeUI.alert("已经登录认证!");
}
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">logout</h1>
注销登录认证
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void obj.logout(successCallback, errorCallback);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
注销登录认证后，再次获取用户信息时需重新进行授权登录认证操作。如果第三方平台不需要注销登录操作，则清空保存的登录认证等信息。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCallback: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.LogoutSuccessCallback">LogoutSuccessCallback</a> ) 必选 注销登录认证成功回调函数 注销登录认证操作成功时触发。 </li><li>errorCallback: ( <ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.ErrorCallback">ErrorCallback</a> ) 可选 注销登录认证失败回调函数 注销登录认证操作失败时触发，并返回错误信息。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 微信授权登录对象
var aweixin=null; // 调用plus.oauth.getServices获取保存

// 调用authorize、login先授权登录认证

// 注销登录认证
function authLogout(){
if(!aweixin){
plus.nativeUI.alert("当前环境不支持微信登录");
return;
}
aweixin.logout(function(e){
plus.nativeUI.alert("注销登录认证成功!");
}, function(e){
plus.nativeUI.alert("注销登录认证失败: "+JSON.stringify(e));
});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">getUserInfo</h1>
获取用户信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void obj.getUserInfo(successCallback, errorCallback);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
在获取用户信息前可通过对象的userInfo属性判断是否已经获取过，通常只需对没有获取过用户信息的服务进行此操作。获取用户信息成功后通过successCallback回调函数通知，失败则通过errorCallback回调函数通知。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCallback: ( <ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.SuccessCallback">SuccessCallback</a> ) 必选 获取登录授权用户信息成功回调函数 获取登录认证用户信息操作成功时触发，并返回用户的信息。 </li><li>errorCallback: ( <ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.ErrorCallback">ErrorCallback</a> ) 可选 获取登录授权用户信息失败回调函数 获取登录认证用户信息操作失败时触发，并返回错误信息。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 微信鉴权服务对象
var aweixin=null; // 调用plus.oauth.getServices获取保存

// 通常登录前需要先调用authorize方法进行授权，调用login方法进行登录认证

// 获取微信登录授权对象后获取用户信息操作
function authUserInfo(){
if(!aweixin){
plus.nativeUI.alert("当前环境不支持微信登录");
return;
}
if(aweixin.authResult){
aweixin.getUserInfo( function(e){
plus.nativeUI.alert("获取用户信息成功："+JSON.stringify(aweixin.userInfo));
}, function(e){
plus.nativeUI.alert("获取用户信息失败： "+JSON.stringify(e));
} );
}else{
plus.nativeUI.alert("未登录认证!");
}
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">preLogin</h1>
预登录
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>

void obj.preLogin(successCallback, errorCallback);

</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
仅一键登录支持，在登录授权认证前调用，可以判断当前设备环境是否支持一键登录，如果能支持一键登录，此时可以显示一键登录选项，同时预登录会准备好相关环境，显著提升一键登录授权认证的操作速度。如果预登录失败，表示当前设备环境可能不支持一键登录，此时应该显示其他登录选项。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCallback: ( <ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.SuccessCallback">SuccessCallback</a> ) 必选 预登录成功回调函数 预登录操作成功时触发。 </li><li>errorCallback: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.ErrorCallback">ErrorCallback</a> ) 可选 预登录失败回调函数 预登录操作失败时触发，并返回错误信息。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">AppleInfo</h1>
苹果登录认证信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.oauth.AppleInfo {
attribute String user;
attribute String state;
attribute String email:
attribute JSON fullName;
attribute String authorizationCode;
attribute String identityToken;
attribute Number realUserStatus;
attribute String scope;
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
此对象仅在使用苹果登录时有效，用于保存苹果登录返回的数据。
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>user: (String 类型 )苹果用户唯一标识符</li><li>state: (String 类型 )验证信息状态</li><li>email: (String 类型 )用户共享的可选电子邮件</li><li>fullName: (JSON 类型 )用户共享的可选全名 可能包括以下属性： namePrefix - String类型，名字前缀，头衔、敬称； givenName - String类型，名字； middleName - String类型，中间名； familyName - String类型，姓； nameSuffix - String类型，名字后缀，学位、荣誉； nickName - String类型，昵称。 </li><li>authorizationCode: (String 类型 )验证数据</li><li>identityToken: (String 类型 )Web令牌(JWT)</li><li>realUserStatus: (Number 类型 )标识用户是否为真实的人 0 - 当前平台不支持，忽略该值； 1 - 无法确认； 2 - 用户真实性非常高。 </li></ul>
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - ALL (不支持)</li><li>iOS - 13+ (支持) : HBuilderX2.3.7+版本支持苹果登录。 </li></ul>
<h1 style="margin-left:0;">AuthOptions</h1>
JSON对象，授权认证参数选项
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.oauth.AuthOptions {
attribute String scope;
attribute String state;
attribute String appid;
attribute String appkey;
attribute String appsecret;
attribute String redirect_uri;
attribute UniverifyStyles univerifyStyle;
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
此对象支持的属性值由登录授权认证服务定义。例如“微信”，则可配置以下参数： scope - 应用授权作用域； state - 用于保持请求和回调的状态参数。
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>scope: (String 类型 )申请的权限作用范围 如果存在多个权限，则以","符号分割。 </li><li>state: (String 类型 )客户端的当前状态，可以指定任意值，登录认证后原封不动的返回保存到AuthService对象的extra中</li><li>appid: (String 类型 )登录授权认证服务平台申请的appid 动态设置登录授权服务中需要使用的appid，仅需要此参数的登录授权服务（如“微信登录”、“QQ登录”）支持。如果未设置则使用运行环境中内置的appid值（如在HBuilder中可在manifest.json的SDK配置项中进行设置）。 </li><li>appkey: (String 类型 )登录授权认证服务平台申请的appkey 动态设置登录授权服务中需要使用的appkey，仅需要此参数的登录授权服务（如“新浪微博登录”）支持。如果未设置则使用运行环境中内置的appkey值（如在HBuilder中可在manifest.json的SDK配置项中进行设置）。 </li><li>appsecret: (String 类型 )登录授权认证服务平台申请的appsecret 动态设置登录授权服务中需要使用的appsecret，仅需要此参数的登录授权服务（如“微信登录”、“新浪微博登录”）支持。如果未设置则使用运行环境中内置的appkey值（如在HBuilder中可在manifest.json的SDK配置项中进行设置）； 当开放平台申请的appsecret值涉及到安全问题时，可在应用运行时从服务器获取，然后通过此api动态设置。 </li><li>redirect_url: (String 类型 )登录授权认证服务平台申请的redirect_url 动态设置登录授权服务中需要使用的redirect_url，仅需要此参数的登录授权服务（如“新浪微博登录”）支持。如果未设置则使用运行环境中内置的redirect_url值（如在HBuilder中可在manifest.json的SDK配置项中进行设置）。 </li><li>univerifyStyle: (<ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.UniverifyStyles">UniverifyStyles</a> 类型 )一键登录授权界面自定义样式 HBuilderX3.0.0+支持一键登录，此参数用于设置一键登录的授权界面样式，参考UniverifyStyles </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
// 微信授权登录对象
var aweixin=null; // 调用plus.oauth.getServices获取保存

// 获取微信登录授权对象后可进行授权操作
function authorize(){
if(!aweixin){
plus.nativeUI.alert("当前环境不支持微信登录");
return;
}
aweixin.authorize(function(e){
plus.nativeUI.alert("授权成功："+JSON.stringify(e));
}, function(e){
plus.nativeUI.alert("授权失败："+JSON.stringify(e));
}, {scope:'snsapi_userinfo',appid:'WX**********'});
}
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">AuthInfo</h1>
登录授权认证信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.oauth.AuthInfo {
attribute String access_token;
attribute String openid;
attribute String expires_in:
attribute String refresh_token;
attribute String scope;
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
此对象仅定义标准属性，登录授权认证服务可扩展自定义数据。例如“微信”登录授权服务，则包括以下数据： unionid - 用户统一标识，针对一个微信开放平台帐号下的应用，同一用户的unionid是唯一的。
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>access_token: (String 类型 )登录授权的访问令牌 如果登录授权服务不支持此属性，则返回"undefined"。 </li><li>openid: (String 类型 )登录授权用户的唯一标识 如果登录授权服务不支持此属性，则返回"undefined"。 </li><li>expires_in: (String 类型 )登录授权访问令牌过期时间 单位为秒，如果登录授权服务不支持此属性，则返回"undefined"。 </li><li>refresh_token: (String 类型 )登录授权的更新令牌 用来获取下一次的访问令牌，如果登录授权服务不支持此属性，则返回"undefined"。 </li><li>scope: (String 类型 )登录授权的权限范围 如果存在多个权限，则以","符号分割。 </li></ul>
<h1 style="margin-left:0;">UserInfo</h1>
登录授权用户信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.oauth.UserInfo {
attribute String openid;
attribute String headimgurl:
attribute String nickname;
attribute String email;
attribute String phonenumber;
attribute String sex;
attribute String province;
attribute String city;
attribute String country;
attribute String unionid;
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
用于保存登录授权用户的信息。此对象仅定义标准属性，登录授权认证服务可扩展自定义数据。例如“微信”登录授权服务，可能包括以下自定义数据：
<ul><li>privilege - 用户特权信息，json数组，如微信沃卡用户为（chinaunicom）</li></ul>
unionid - ，。

<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>openid: (String 类型 )登录授权用户的唯一标识 如果登录授权服务不支持此属性，则返回"undefined"。 </li><li>headimgurl: (String 类型 )登录授权用户的头像图片地址 要求为"http://"或"https://"开头的地址，如果登录授权服务不支持此属性，则返回"undefined"。 </li><li>nickname: (String 类型 )登录授权用户的昵称 如果登录授权服务不支持此属性，则返回"undefined"。 </li><li>email: (String 类型 )登录授权用户的邮箱地址 如果登录授权服务不支持此属性，则返回"undefined"。 </li><li>phonenumber: (String 类型 )登录授权用户的电话号码 如果登录授权服务不支持此属性，则返回"undefined"。 </li><li>sex: (String 类型 )登录授权用户的性别 1为男性，2为女性。如果登录授权服务不支持此属性，则返回"undefined"。 </li><li>province: (String 类型 )登录授权用户注册的省份信息 如果登录授权服务不支持此属性，则返回"undefined"。 </li><li>city: (String 类型 )登录授权用户注册的城市信息 如果登录授权服务不支持此属性，则返回"undefined"。 </li><li>country: (String 类型 )登录授权用户注册的国家信息 如果登录授权服务不支持此属性，则返回"undefined"。 </li><li>unionid: (String 类型 )用户统一标识 针对同一个登录授权服务平台帐号下的应用，同一用户的unionid是唯一的。 如果登录授权服务不支持此属性，则返回"undefined"。 注意：仅微信及QQ平台支持，QQ平台HBuilderX3.0.0+版本支持，需在QQ开放平台申请才能获取。 </li></ul>
<h1 style="margin-left:0;">UniverifyStyles</h1>
一键登录授权界面样式参数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.oauth.UniverifyStyles {
attribute Boolean fullScreen;
attribute String backgroundColor;
attribute String backgroundImage;
attribute UniverifyIconStyles icon;
attribute UniverifyIconStyles closeIcon;
attribute UniverifyPhoneNumStyles phoneNum;
attribute UniverifySloganStyles slogan;
attribute UniverifyAuthButtonStyles authButton;
attribute UniverifyOtherButtonStyles otherLoginButton;
attribute UniverifyPrivacyTermsStyles privacyTerms;
attribute UniVerifyButtonsStyles buttons;
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
用于一键登录授权界面自定义样式。 HBuilderX3.0.0+版本支持，详情参考<ahref="https://ask.dcloud.net.cn/article/38009">一键登录使用指南</a>。
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>fullScreen: (Boolean 类型 )是否全屏模式 true表示全屏模式，false表示非全屏模式，默认值为false。 注意：HBuilderX3.1.5+版本支持。 </li><li>backgroundColor: (String 类型 )授权界面背景颜色 格式为"#RRGGBB"，默认值为"#FFFFF"。 </li><li>backgroundImage: (String 类型 )背景图片</li><li>icon: (<ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.UniverifyIconStyles">UniverifyIconStyles</a> 类型 )授权界面图标样式 可设置自定义图标，默认为应用图标。 </li><li>closeIcon: (<ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.UniverifyIconStyles">UniverifyIconStyles</a> 类型 )关闭按钮图标样式 设置自定义关闭图标，不支持设置图标大小（忽略width/height属性）。 HBuilderX3.3.7+版本支持。 </li><li>phoneNum: (<ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.UniverifyPhoneNumStyles">UniverifyPhoneNumStyles</a> 类型 )授权界面电话号码样式 可设置自定义电话号码文字颜色、大小等。 </li><li>slogan: (<ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.UniverifySloganStyles">UniverifySloganStyles</a> 类型 )授权界面服务说明样式 可设置自定义服务说明文字颜色、大小等。 </li><li>authButton: (<ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.UniverifyAuthButtonStyles">UniverifyAuthButtonStyles</a> 类型 )授权界面登录按钮样式 可设置自定义登录按钮背景颜色、文本内容、大小等。 </li><li>otherLoginButton: (<ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.UniverifyOtherButtonStyles">UniverifyOtherButtonStyles</a> 类型 )授权界面其他登录按钮样式 可设置自定义其他登录按钮背景颜色、文本内容、大小等。 </li><li>privacyTerms: (<ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.UniverifyPrivacyTermsStyles">UniverifyPrivacyTermsStyles</a> 类型 )授权界面服务协议样式 自定义设置服务器协议文字颜色、文本内容，添加自定义服务协议链接等。 </li><li>buttons: (<ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.UniVerifyButtonsStyles">UniVerifyButtonsStyles</a> 类型 )自定义登录按钮列表样式 自定义设置更多登录按钮列表，如其它三方登录等。 注意：HBuilderX3.1.14+版本支持。 </li></ul>
<h1 style="margin-left:0;">UniverifyIconStyles</h1>
一键登录授权界面图标样式参数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.oauth.UniverifyIconStyles {
attribute String path;
attribute String width;
attribute String height;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>path: (String 类型 )图标地址 仅支持本地路径，默认为应用图标。 </li><li>width: (String 类型 )图标宽度 格式为“XXpx"，默认值为"60px"。 </li><li>height: (String 类型 )图标高度 格式为“XXpx"，默认值为"60px"。 </li></ul>
<h1 style="margin-left:0;">UniverifyPhoneNumStyles</h1>
一键登录授权界面电话号码文本样式参数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.oauth.UniverifyPhoneNumStyles {
attribute String color;
attribute String fontSize;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>color: (String 类型 )字体颜色 格式为"#RRGGBB"，默认值为"#000000"。 </li><li>fontSize: (String 类型 )字体大小 格式为“XXpx"，默认值为"18px"。注意：字体加粗显示。 </li></ul>
<h1 style="margin-left:0;">UniverifySloganStyles</h1>
一键登录授权界面服务说明文字样式参数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.oauth.UniverifySloganStyles {
attribute String color;
attribute String fontSize;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>color: (String 类型 )字体颜色 格式为"#RRGGBB"，默认值为"#8a8b90"。 </li><li>fontSize: (String 类型 )字体大小 格式为“XXpx"，默认值为"12px"。 </li></ul>
<h1 style="margin-left:0;">UniverifyAuthButtonStyles</h1>
一键登录授权界面登录按钮样式参数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.oauth.UniverifyAuthButtonStyles {
attribute String normalColor;
attribute String highlightColor;
attribute String disabledColor;
attribute String width;
attribute String height;
attribute String textColor;
attribute String title;
attribute String borderRadius;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>normalColor: (String 类型 )正常状态按钮颜色 格式为"#RRGGBB"，默认值为"#3479f5"。 </li><li>highlightColor: (String 类型 )按下状态按钮颜色 格式为"#RRGGBB"，默认值为"#2861c5"。 </li><li>disabledColor: (String 类型 )不可点击状态按钮颜色 格式为"#RRGGBB"，默认值为"#73aaf5"。注意：仅iOS平台支持。 </li><li>width: (String 类型 )按钮宽度 格式为“XXpx"，默认值为自适应，距离屏幕左右"32px"。 </li><li>height: (String 类型 )按钮高度 格式为“XXpx"，默认值为"94px"。 </li><li>textColor: (String 类型 )按钮上文字颜色 格式为"#RRGGBB"，默认值为"#ffffff"。 </li><li>title: (String 类型 )按钮上文字内容 默认值为"本机号码一键登录"。 </li><li>borderRadius: (String 类型 )按钮圆角半径 格式为“XXpx"，默认值为按钮高度的一半。 </li></ul>
<h1 style="margin-left:0;">UniverifyOtherButtonStyles</h1>
一键登录授权界面其它按钮样式参数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.oauth.UniverifyOtherButtonStyles {
attribute Boolean visible;
attribute String normalColor;
attribute String highlightColor;
attribute String width;
attribute String height;
attribute String textColor;
attribute String title;
attribute String borderWidth;
attribute String borderColor;
attribute String borderRadius;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>visible: (Boolean 类型 )是否显示其它按钮 可取值： true - 显示其它按钮；false - 不显示其它按钮。默认值为true。 </li><li>normalColor: (String 类型 )正常状态按钮颜色 格式为"#RRGGBB"，默认值为"#f8f8f8"。 </li><li>highlightColor: (String 类型 )按下状态按钮颜色 格式为"#RRGGBB"，默认值为"#dedede"。 </li><li>width: (String 类型 )按钮宽度 格式为“XXpx"，默认值为自适应，距离屏幕左右"32px"。 </li><li>height: (String 类型 )按钮高度 格式为“XXpx"，默认值为"94px"。 </li><li>textColor: (String 类型 )按钮上文字颜色 格式为"#RRGGBB"，默认值为"#000000"。 </li><li>title: (String 类型 )按钮上文字内容 默认值为"其他登录方式"。 </li><li>borderWidth: (String 类型 )按钮边框宽度 格式为“XXpx"，默认值为"1px"。注意：仅iOS平台支持。 </li><li>borderColor: (String 类型 )按钮边框颜色 格式为"#RRGGBB"，默认值为"#c5c5c5"。注意：仅iOS平台支持。 </li><li>borderRadius: (String 类型 )按钮圆角半径 格式为“XXpx"，默认值为按钮高度的一半。 </li></ul>
<h1 style="margin-left:0;">UniverifyPrivacyTermsStyles</h1>
一键登录服务协议样式参数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.oauth.UniverifyPrivacyTermsStyles {
attribute Boolean defaultCheckBoxState;
attribute String uncheckedImage;
attribute String checkedImage;
attribute String textColor;
attribute String termsColor;
attribute String prefix;
attribute String suffix;
attribute String fontSize;
attribute Array<UniverifyPrivacyItemStyles> privacyItems;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>defaultCheckBoxState: (Boolean 类型 )默认是否勾选同意协议选择框 ture表示勾选，false表示不勾选。默认值为true。 HBuilderX3.1.0+版本新增支持。 </li><li>uncheckedImage: (String 类型 )未勾选同意协议选择框的图片地址 仅支持本地路径，建议图片尺寸24x24px。 HBuilderX3.1.23+版本新增支持。 </li><li>checkedImage: (String 类型 )勾选同意协议选择框的图片地址 仅支持本地路径，建议图片尺寸24x24px。 HBuilderX3.1.23+版本新增支持。 </li><li>textColor: (String 类型 )普通文字颜色 格式为"#RRGGBB"，默认值为"#8a8b90"。 </li><li>termsColor: (String 类型 )协议链接文字颜色 格式为"#RRGGBB"，默认值为"#1d4788"。 </li><li>prefix: (String 类型 )服务协议前文本内容 默认值为"我已阅读并同意"。 </li><li>suffix: (String 类型 )服务协议后文本内容 默认值为"并使用本机号码登录"。 </li><li>fontSize: (String 类型 )字体大小 格式为“XXpx"，默认值为"12px"。 </li><li>privacyItems: (Array[<ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.UniverifyPrivacyItemStyles">UniverifyPrivacyItemStyles</a>] 类型 )服务协议 自定义服务协议，可设置使用手机号码登录的协议，最多可设置两个协议。注意：运营商的服务协议链接会自动添加到自定义服务协议之前。 </li></ul>
<h1 style="margin-left:0;">UniverifyPrivacyItemStyles</h1>
自定义服务协议链接样式参数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.oauth.UniverifyPrivacyItemStyles {
attribute String url;
attribute String title;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>url: (String 类型 )链接地址 http/https开头的协议链接地址。 </li><li>title: (String 类型 )协议链接文字</li></ul>
<h1 style="margin-left:0;">UniVerifyButtonsStyles</h1>
自定义登录按钮列表样式
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.oauth.UniVerifyButtonsStyles {
attribute String iconWidth;
attribute Array<UniVerifyButtonStyles> list;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>iconWidth: (String 类型 )自定义登录按钮图标宽度 单位为px，默认值为45px。 按指定宽度缩放，高度等比例缩放。 </li><li>list: (Array 类型 )自定义登录按钮列表</li></ul>
<h1 style="margin-left:0;">UniVerifyButtonStyles</h1>
自定义登录按钮样式
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface plus.oauth.UniVerifyButtonStyles {
attribute String iconPath;
attribute Function onclick;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>iconPath: (String 类型 )自定义按钮图标路径</li><li>onclick: (<ahref="https://blog.csdn.net/qq_40575646/article/details/122836890#plus.oauth.SuccessCallback">SuccessCallback</a> 类型 )点击按钮回调函数 用户点击按钮时触发。 </li></ul>
<h1 style="margin-left:0;">ServicesSuccessCallback</h1>
获取登录授权认证服务成功回调
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void ServicesSuccessCallback( services ) {
// Get oauth services success code
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
当获取登录授权认证服务列表成功时触发，并通过services参数返回运行环境支持的登录授权认证服务列表。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>services: ( Array[<ahref="https://www.html5plus.org/doc/zh_cn/oauth.html#plus.oauth.AuthService">AuthService</a>] ) 必选 运行环境支持的登录授权认证服务列表 运行环境支持的登录授权认证服务列表数组，可通过services.length获取服务列表的数目。如果当前运行环境没有支持的登录授权认证服务，则返回空数组。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">AuthorizeSuccessCallback</h1>
授权认证成功回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onAuthorizeSuccess(event){
　　// authorize code
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
授权认证成功时触发，并返回操作结果。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 必选 授权认证回调参数 包括以下字段： event.target - 授权认证服务对象； event.scope - 申请的权限作用范围，调用authorize方法传入的scope值； event.state - 自定义参数，调用authorize方法传入的state值； event.code - 用户换取access_token的code； event.lang - 客户端当前语言（仅微信授权登录支持）； event.country -用户当前国家信息（仅微信授权登录支持）。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">LogoutSuccessCallback</h1>
注销登录授权认证操作成功回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onLogoutSuccess(event){
　　// logout code
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
注销登录授权认证成功时触发，并返回操作结果。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 必选 注销登录授权认证操作回调事件参数 包括以下参数： event.target - 表示登录授权认证服务对象； 其它属性可保存注销登录授权的扩展数据。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">SuccessCallback</h1>
登录授权认证服务操作成功回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess(event){
　　// auth code
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
登录授权认证服务操作如请求登录授权认证、获取登录授权用户信息成功时触发，并返回操作结果。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>event: ( Object ) 必选 登录授权认证服务操作回调事件参数 包括以下参数： event.target - 表示登录授权认证服务对象，可以通过此对象的authResult、userInfo属性来获取操作结果信息。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h1 style="margin-left:0;">ErrorCallback</h1>
登录授权认证服务操作失败回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onError(error){
// Error code
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
登录授权认证服务操作如请求登录授权认证、注销登录授权认证、获取登录授权用户信息失败时触发，并返回错误信息。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>error: ( Exception ) 必选 操作失败错误信息 包括以下属性：
<ul style="margin-left:2em;"><li>code - Number类型，错误代码</li><li>message - String类型，错误描述信息</li></ul>一键登录（HBuilder3.0.5+版本新增）支持以下属性（排查错误时需提供给技术支持）：
<ul style="margin-left:2em;"><li>appid - String类型，一键登录的应用标识appid</li><li>metadata - JSON类型，一键登录的原数据</li><li>uid - String类型，一键登录的操作标识</li></ul> </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<div style="margin-left:0;"></div>
</div>
<div style="margin-left:auto;">

</div>
 </div>
 </div>
 <div id="treeSkill"></div>

页: [1]

宜信同城网交流论坛's Archiver

OAuth模块管理客户端的用户登录鉴权功能，允许应用访问第三方平台的资源 ...