oauth

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

方法：

getServices: 获取登录授权认证服务列表

对象：

AuthService: 登录授权认证服务对象
AuthOptions: JSON对象，授权认证参数选项
AuthInfo: 登录授权认证信息
UserInfo: 登录授权用户信息

回调方法：

ServicesSuccessCallback: 获取登录授权认证服务成功回调
AuthLogoutSuccessCallback: 注销登录授权认证操作成功回调函数
AuthSuccessCallback: 登录授权认证服务操作成功回调函数
AuthErrorCallback: 登录授权认证服务操作失败回调函数

模块：

permissions


{
// ...
"permissions":{
	// ...
	"OAuth": {
		"description": "登录鉴权"
	}
}
}

getServices

获取登录授权认证服务列表


void plus.oauth.getServices( successCB, errorCB );

说明：

获取终端支持的权登录认证服务列表，可用于提示用户进行登录平台的选择。获取登录授权认证服务成功后通过successCB回调返回支持的所有服务列表，获取服务失败则通过errorCB回调返回失败信息。

参数：

successCB: ( ServicesSuccessCallback ) 必选 获取登录授权认证服务成功回调函数
获取登录授权认证服务列表成功时触发回调，并返回终端支持的登录授权认证服务列表。
errorCB: ( AuthErrorCallback ) 可选 获取登录授权认证服务失败回调函数
获取登录授权认证服务列表失败时触发回调，并返回错误信息。

返回值：

void : 无

平台支持：

Android - 2.2+ (支持)
iOS - 5.0+ (支持)
360生活助手 (支持)

示例：


<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8"/>
	<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
	<title>OAuth Example</title>
	<script type="text/javascript">
var auths=null;
// 监听plusready事件  
document.addEventListener( "plusready", function(){
	// 扩展API加载完毕，现在可以正常调用扩展API
	plus.oauth.getServices( function(services){
		auths = services;
	}, function(e){
		alert( "获取分享服务列表失败："+e.message+" - "+e.code );
	} );
}, false );
	</script>
	</head>
	<body>
		获取登录授权认证服务列表
	</body>
</html>

AuthService

登录授权认证服务对象


interface plus.oauth.AuthService {
	// Attributes
	attribute String id;
	attribute String description;
	attribute AuthInfo authResult;
	attribute UserInfo userInfo;
	attribute JSON extra;
	
	// Methods
	function void login( successCallback, errorCallback, options );
	function void logout( successCallback, errorCallback );
	function void getUserInfo( successCallback, errorCallback );
	function void addPhoneNumber( successCallback, errorCallback );
}

说明：

AuthService对象用于表示登录授权认证服务，在JS中为对象，用于向系统进行登录授权认证操作。

属性：

id: 登录授权认证服务标识
description: 登录授权认证服务描述
authResult: 授权认证结果数据
userInfo: 登录授权认证用户信息
extra: 登录授权认证扩展信息

方法：

login: 请求登录授权认证操作
logout: 注销登录授权认证
getUserInfo: 获取登录授权用户信息
addPhoneNumber: 添加用户手机号信息

id

登录授权认证服务标识

说明：

String 类型只读属性

用于表示登录授权认证服务标识： "weixin" - 表示微信登录授权； "qq" - 表示QQ登录授权； "sinaweibo" - 表示新浪微博登录授权； "qihoo" - 表示360账号登录（仅360手助流应用环境下支持）。

平台支持：

Android - 2.2+ (支持)
iOS - 5.0+ (支持)
360生活助手 (支持)

description

登录授权认证服务描述

说明：

String 类型只读属性可选属性

用于描述登录授权认证服务的信息： "微信" - 表示微信登录授权； "QQ" - 表示QQ登录授权； "新浪微博" - 表示新浪微博登录授权； "360账号" - 表示360账号登录（仅360手助流应用环境下支持）。

平台支持：

Android - 2.2+ (支持)
iOS - 5.0+ (支持)
360生活助手 (支持)

authResult

授权认证结果数据

说明：

AuthInfo 类型只读属性可选属性

用于保存登录授权认证获取的认证信息，如果值为"undefined"则表示未进行授权认证或者是授权认证失败。

平台支持：

Android - 2.2+ (支持)
iOS - 5.0+ (支持)
360生活助手 (支持)

userInfo

登录授权认证用户信息

说明：

UserInfo 类型只读属性可选属性

用于保存登录授权认证获取的用户信息，如果值为"undefined"则表示未获取过用户信息。

平台支持：

Android - 2.2+ (支持)
iOS - 5.0+ (支持)
360生活助手 (支持)

extra

登录授权认证扩展信息

说明：

JSON 类型只读属性可选属性

用于保存登录授权认证服务返回的扩展信息，具体内容由各登录平台决定，如果没有扩展信息则为undefined。例如“微信”，则可保存以下数据： state - 用于保持请求和回调的状态参数。

login

请求登录授权认证操作


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

说明：

对指定的登录授权认证服务进行登录认证操作，在登录前可通过对象的authResult属性判断是否已经登录认证过，通常只需要对没有进行过登录认证的服务进行登录认证操作。授权认证操作成功后通过successCB回调函数通知，失败则通过errorCB回调函数通知。

参数：

successCallback: ( AuthSuccessCallback ) 必选 登录授权认证服务登录认证成功回调函数
登录授权认证服务登录认证操作成功时触发，并返回登录认证成功信息。
errorCallback: ( AuthErrorCallback ) 可选 登录授权认证服务登录认证失败回调函数
登录授权认证服务授权认证操作失败时触发，并返回错误信息。
options: ( AuthOptions ) 可选 登录授权认证参数
登录授权认证服务授权认证操作使用的参数。

返回值：

void : 无

平台支持：

Android - 2.2+ (支持)
iOS - 5.0+ (支持)
360生活助手 (支持)

示例：


<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8"/>
	<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
	<title>OAuth Example</title>
	<script type="text/javascript">
var auths=null;
// 监听plusready事件  
document.addEventListener( "plusready", function(){
	// 扩展API加载完毕，现在可以正常调用扩展API
	plus.oauth.getServices( function(services){
		auths = services;
	}, function(e){
		alert( "获取分享服务列表失败："+e.message+" - "+e.code );
	} );
}, false );
// 登录操作
function authLogin(){
	var s = auths[0];
	if ( !s.authResult ) {
		s.login( function(e){
			alert( "登录认证成功！" );
		}, function(e){
			alert( "登录认证失败！" );
		} );
	}else{
		alert( "已经登录认证！" );
	}
}
	</script>
	</head>
	<body>
		1.请求登录授权认证操作<br/>
		<button onclick="authLogin()">Login</button>
	</body>
</html>

logout

注销登录授权认证


void obj.logout( successCallback, errorCallback );

说明：

对指定的登录授权认证服务注销登录认证操作，注销授权认证后，再次操作时需重新进行登录认证操作。如果第三方平台不需要注销操作，则情况保存的相关登录认证等信息。

参数：

successCallback: ( AuthLogoutSuccessCallback ) 必选 注销登录授权认证成功回调函数
注销登录授权认证服务登录认证操作成功时触发，并返回注销登录认证成功信息。
errorCallback: ( AuthErrorCallback ) 可选 注销登录授权认证失败回调函数
注销登录授权认证服务授权认证操作失败时触发，并返回错误信息。

返回值：

void : 无

示例：


<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8"/>
	<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
	<title>OAuth Example</title>
	<script type="text/javascript">
var auths=null;
// 监听plusready事件  
document.addEventListener( "plusready", function(){
	// 扩展API加载完毕，现在可以正常调用扩展API
	plus.oauth.getServices( function(services){
		auths = services;
	}, function(e){
		alert( "获取分享服务列表失败："+e.message+" - "+e.code );
	} );
}, false );
// 登录操作
function authLogin(){
	var s = auths[0];
	if ( !s.authResult ) {
		s.login( function(e){
			alert( "登录认证成功！" );
		}, function(e){
			alert( "登录认证失败！" );
		} );
	}else{
		alert( "已经登录认证！" );
	}
}
// 注销所有登录授权认证服务
function authLogout(){
	for ( var i in auths ) {
		var s = auths[i];
		if ( s.authResult ) {
			s.logout(function(e){
				alert( "注销登录认证成功！" );
			}, function(e){
				alert( "注销登录认证失败！" );
			});
		}
	}
}
	</script>
	</head>
	<body>
		1.请求登录授权认证操作<br/>
		<button onclick="authLogin()">Login</button>
		2.请求登录授权认证操作<br/>
		<button onclick="authLogout()">Logout</button>
	</body>
</html>

getUserInfo

获取登录授权用户信息


void obj.getUserInfo( successCallback, errorCallback );

说明：

获取登录授权认证的用户信息，在获取前可通过对象的userInfo属性判断是否已经获取过，通常只需要对没有获取过用户信息的服务进行操作。获取用户信息操作成功后通过successCallback回调函数通知，失败则通过errorCallback回调函数通知。

参数：

successCallback: ( AuthSuccessCallback ) 必选 获取登录授权用户信息成功回调函数
获取登录认证用户信息操作成功时触发，并返回用户的信息。
errorCallback: ( AuthErrorCallback ) 可选 获取登录授权用户信息失败回调函数
获取登录认证用户信息操作失败时触发，并返回错误信息。

返回值：

void : 无

平台支持：

Android - 2.2+ (支持)
iOS - 5.0+ (支持)
360生活助手 (支持)

示例：


<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8"/>
	<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
	<title>OAuth Example</title>
	<script type="text/javascript">
var auths=null;
// 监听plusready事件  
document.addEventListener( "plusready", function(){
	// 扩展API加载完毕，现在可以正常调用扩展API
	plus.oauth.getServices( function(services){
		auths = services;
	}, function(e){
		alert( "获取分享服务列表失败："+e.message+" - "+e.code );
	} );
}, false );
// 登录操作
function authLogin(){
	var s = auths[0];
	if ( !s.authResult ) {
		s.login( function(e){
			alert( "登录认证成功！" );
		}, function(e){
			alert( "登录认证失败！" );
		} );
	}else{
		alert( "已经登录认证！" );
	}
}
// 获取登录用户信息操作
function authUserInfo(){
	var s = auths[0];
	if ( !s.authResult ) {
		alert("未登录授权！");
	} else {
		s.getUserInfo( function(e){
			alert( "获取用户信息成功："+JSON.stringify(s.userInfo) );
		}, function(e){
			alert( "获取用户信息失败："+e.message+" - "+e.code );
		} );
	}
}
	</script>
	</head>
	<body>
		1.请求登录授权认证操作<br/>
		<button onclick="authLogin()">Login</button>
		2. 获取登录授权用户信息<br/>
		<button onclick="authUserInfo()">UserInfo</button>
	</body>
</html>

addPhoneNumber

添加用户手机号信息


void obj.addPhoneNumber( successCallback, errorCallback );

说明：

打开登录授权服务的添加用户手机号界面进行操作，添加用户手机号操作成功后通过successCallback回调函数通知，否则通过errorCallback回调函数通知。

参数：

successCallback: ( AuthSuccessCallback ) 必选 添加用户手机号信息成功回调函数
errorCallback: ( AuthErrorCallback ) 可选 添加用户手机号信息失败回调函数

返回值：

void : 无

平台支持：

Android - ALL (不支持)
iOS - ALL (不支持)
360手助流应用 (支持)
360生活助手 (支持)

示例：


<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8"/>
	<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
	<title>OAuth Example</title>
	<script type="text/javascript">
var auths=null;
// 监听plusready事件  
document.addEventListener( "plusready", function(){
	// 扩展API加载完毕，现在可以正常调用扩展API
	plus.oauth.getServices( function(services){
		auths = services;
	}, function(e){
		alert( "获取分享服务列表失败："+e.message+" - "+e.code );
	} );
}, false );
// 登录操作
function authLogin(){
	var s = auths[0];
	if ( !s.authResult ) {
		s.login( function(e){
			alert( "登录认证成功！" );
		}, function(e){
			alert( "登录认证失败！" );
		} );
	}else{
		alert( "已经登录认证！" );
	}
}
// 添加用户手机号信息
function addPhoneNumber(){
	var s = auths[0];
	if ( !s.authResult ) {
		alert("未登录授权！");
	} else {
		s.addPhoneNumber( function(e){
			alert( "添加用户手机号信息成功！" );
		}, function(e){
			alert( "添加用户手机号信息失败："+e.message+" - "+e.code );
		} );
	}
}
	</script>
	</head>
	<body>
		1.请求登录授权认证操作<br/>
		<button onclick="authLogin()">Login</button>
		2.添加用户手机号信息<br/>
		<button onclick="addPhoneNumber()">AddPhoneNumber</button>
	</body>
</html>

AuthOptions

JSON对象，授权认证参数选项


interface plus.oauth.AuthOptions {
	attribute String scope;
	attribute String state;
	attribute String appid;
	attribute String appkey;
	attribute String appsecret;
	attribute String redirect_uri;
}

说明：

此对象支持的属性值由登录授权认证服务定义。例如“微信”，则可配置以下参数： scope - 应用授权作用域； state - 用于保持请求和回调的状态参数。

属性：

scope: (String 类型 )申请的权限作用范围
如果存在多个权限，则以","符号分割。
state: (String 类型 )客户端的当前状态，可以指定任意值，登录认证后原封不动的返回保存到AuthService对象的extra中
appid: (String 类型 )登录授权认证服务平台申请的appid
动态设置登录授权服务中需要使用的appid，仅需要此参数的登录授权服务（如“微信登录”、“QQ登录”）支持。如果未设置则使用运行环境中内置的appid值（如在HBuilder中可在manifest.json的SDK配置项中进行设置）。
appkey: (String 类型 )登录授权认证服务平台申请的appkey
动态设置登录授权服务中需要使用的appkey，仅需要此参数的登录授权服务（如“新浪微博登录”、“360登录”）支持。如果未设置则使用运行环境中内置的appkey值（如在HBuilder中可在manifest.json的SDK配置项中进行设置）。
appsecret: (String 类型 )登录授权认证服务平台申请的appsecret
动态设置登录授权服务中需要使用的appsecret，仅需要此参数的登录授权服务（如“微信登录”、“新浪微博登录”）支持。如果未设置则使用运行环境中内置的appkey值（如在HBuilder中可在manifest.json的SDK配置项中进行设置）；当开放平台申请的appsecret值涉及到安全问题时，可在应用运行时从服务器获取，然后通过此api动态设置。
redirect_url: (String 类型 )登录授权认证服务平台申请的redirect_url
动态设置登录授权服务中需要使用的redirect_url，仅需要此参数的登录授权服务（如“新浪微博登录”）支持。如果未设置则使用运行环境中内置的redirect_url值（如在HBuilder中可在manifest.json的SDK配置项中进行设置）。

示例：


<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8"/>
	<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
	<title>OAuth Example</title>
	<script type="text/javascript">
var auths=null;
// 监听plusready事件  
document.addEventListener( "plusready", function(){
	// 扩展API加载完毕，现在可以正常调用扩展API
	plus.oauth.getServices( function(services){
		auths = services;
	}, function(e){
		alert( "获取分享服务列表失败："+e.message+" - "+e.code );
	} );
}, false );
// 登录操作
function authLogin(){
	var s = auths[0];
	if ( !s.authResult ) {
		s.login( function(e){
			alert( "登录认证成功！" );
		}, function(e){
			alert( "登录认证失败！" );
		}, {appid:"wx0411fa6a39d61297"  // 微信应用的appid
			,scope:"snsapi_userinfo"}   // 授权获取用户信息
		);
	}
}
	</script>
	</head>
	<body>
		请求登录授权认证操作（配置参数）
		<button onclick="authLogin()">Login</button>
	</body>
</html>

AuthInfo

登录授权认证信息


interface plus.oauth.AuthInfo {
	attribute String openid;
	attribute String access_token;
	attribute String expires_in:
	attribute String refresh_token;
	attribute String scope;
}

说明：

此对象仅定义标准属性，登录授权认证服务可扩展自定义数据。例如“微信”登录授权服务，则包括以下数据： unionid - 用户统一标识，针对一个微信开放平台帐号下的应用，同一用户的unionid是唯一的。

属性：

access_token: (String 类型 )登录授权的访问令牌
如果登录授权服务不支持此属性，则返回"undefined"。
openid: (String 类型 )登录授权用户的唯一标识
如果登录授权服务不支持此属性，则返回"undefined"。
expires_in: (String 类型 )登录授权访问令牌过期时间
单位为秒，如果登录授权服务不支持此属性，则返回"undefined"。
refresh_token: (String 类型 )登录授权的更新令牌
用来获取下一次的访问令牌，如果登录授权服务不支持此属性，则返回"undefined"。
scope: (String 类型 )登录授权的权限范围
如果存在多个权限，则以","符号分割。

UserInfo

登录授权用户信息


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;
}

说明：

用于保存登录授权用户的信息。此对象仅定义标准属性，登录授权认证服务可扩展自定义数据。例如“微信”登录授权服务，可能包括以下自定义数据： privilege - 用户特权信息，json数组，如微信沃卡用户为（chinaunicom）； unionid - 用户统一标识，针对一个微信开放平台帐号下的应用，同一用户的unionid是唯一的。

属性：

openid: (String 类型 )登录授权用户的唯一标识
如果登录授权服务不支持此属性，则返回"undefined"。
headimgurl: (String 类型 )登录授权用户的头像图片地址
要求为"http://"或"https://"开头的地址，如果登录授权服务不支持此属性，则返回"undefined"。
nickname: (String 类型 )登录授权用户的昵称
如果登录授权服务不支持此属性，则返回"undefined"。
email: (String 类型 )登录授权用户的邮箱地址
如果登录授权服务不支持此属性，则返回"undefined"。
phonenumber: (String 类型 )登录授权用户的电话号码
如果登录授权服务不支持此属性，则返回"undefined"。
sex: (String 类型 )登录授权用户的性别
1为男性，2为女性。如果登录授权服务不支持此属性，则返回"undefined"。
province: (String 类型 )登录授权用户注册的省份信息
如果登录授权服务不支持此属性，则返回"undefined"。
city: (String 类型 )登录授权用户注册的城市信息
如果登录授权服务不支持此属性，则返回"undefined"。
country: (String 类型 )登录授权用户注册的国家信息
如果登录授权服务不支持此属性，则返回"undefined"。

ServicesSuccessCallback

获取登录授权认证服务成功回调


void ServicesSuccessCallback( services ) {
	// Get oauth services success code
}

说明：

当获取登录授权认证服务列表成功时触发，并通过services参数返回运行环境支持的登录授权认证服务列表。

参数：

services: ( Array[ AuthService ] ) 必选 运行环境支持的登录授权认证服务列表
运行环境支持的登录授权认证服务列表数组，可通过services.length获取服务列表的数目。如果当前运行环境没有支持的登录授权认证服务，则返回空数组。

返回值：

void : 无

平台支持：

Android - 2.2+ (支持)
iOS - 5.0+ (支持)
360生活助手 (支持)

示例：


<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8"/>
	<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
	<title>OAuth Example</title>
	<script type="text/javascript">
var auths=null;
// 监听plusready事件  
document.addEventListener( "plusready", function(){
	// 扩展API加载完毕，现在可以正常调用扩展API
	plus.oauth.getServices( function(services){
		// services.length可获取当前运行环境支持登录授权认证服务数目
		if(services.length>0){
			auths = services;
		}else{
			alert("当前运行环境不支持登录授权认证服务！");
		}
	}, function(e){
		alert( "获取分享服务列表失败："+e.message+" - "+e.code );
	} );
}, false );
	</script>
	</head>
	<body>
		获取登录授权认证服务列表
	</body>
</html>

AuthLogoutSuccessCallback

注销登录授权认证操作成功回调函数


void AuthLogoutSuccessCallback( event ) {
	　　// logout code
}

说明：

注销登录授权认证成功时触发，并返回操作结果。

参数：

event: ( JSON ) 必选 注销登录授权认证操作回调事件参数
包括以下参数： event.target - 表示登录授权认证服务对象；其它属性可保存注销登录授权的扩展数据。

返回值：

void : 无

平台支持：

Android - 2.2+ (支持)
iOS - 5.0+ (支持)
360生活助手 (支持)

示例：


<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8"/>
	<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
	<title>OAuth Example</title>
	<script type="text/javascript">
var auths=null;
// 监听plusready事件  
document.addEventListener( "plusready", function(){
	// 扩展API加载完毕，现在可以正常调用扩展API
	plus.oauth.getServices( function(services){
		auths = services;
	}, function(e){
		alert( "获取分享服务列表失败："+e.message+" - "+e.code );
	} );
}, false );
// 注销所有登录授权认证服务
function authLogout(){
	for ( var i in auths ) {
		var s = auths[i];
		if ( s.authResult ) {
			s.logout(function(e){
				alert( "注销登录认证成功！" );
			}, function(e){
				alert( "注销登录认证失败！" );
			});
		}
	}
}
	</script>
	</head>
	<body>
		请求登录授权认证操作
		<br/>
		<button onclick="authLogout()">Logout</button>
	</body>
</html>

AuthSuccessCallback

登录授权认证服务操作成功回调函数


void AuthSuccessCallback( event ) {
	　　// auth code
}

说明：

登录授权认证服务操作如请求登录授权认证、获取登录授权用户信息成功时触发，并返回操作结果。

参数：

event: ( JSON ) 必选 登录授权认证服务操作回调事件参数
包括以下参数： event.target - 表示登录授权认证服务对象，可以通过此对象的authResult、userInfo属性来获取操作结果信息。

返回值：

void : 无

平台支持：

Android - 2.2+ (支持)
iOS - 5.0+ (支持)
360生活助手 (支持)

示例：


<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8"/>
	<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
	<title>OAuth Example</title>
	<script type="text/javascript">
var auths=null;
// 监听plusready事件  
document.addEventListener( "plusready", function(){
	// 扩展API加载完毕，现在可以正常调用扩展API
	plus.oauth.getServices( function(services){
		auths = services;
	}, function(e){
		alert( "获取分享服务列表失败："+e.message+" - "+e.code );
	} );
}, false );
// 登录操作
function authLogin(){
	var s = auths[0];
	if ( !s.authResult ) {
		s.login( function(e){
			// 获取登录操作结果
			var result = e.target.authResult;
			alert( "登录认证成功："+JSON.stringify(result) );
		}, function(e){
			alert( "登录认证失败！" );
		}, {} );
	}
}
	</script>
	</head>
	<body>
		请求登录授权认证操作
		<button onclick="authLogin()">Login</button>
	</body>
</html>

AuthErrorCallback

登录授权认证服务操作失败回调函数


void AuthErrorCallback(error){
	// Error code
}

说明：

登录授权认证服务操作如请求登录授权认证、注销登录授权认证、获取登录授权用户信息失败时触发，并返回错误信息。

参数：

error: ( Exception ) 必选 操作失败错误信息
包括以下参数： error.code - 表示错误代码； error.message - 错误描述信息；

返回值：

void : 无

平台支持：

Android - 2.2+ (支持)
iOS - 5.0+ (支持)
360生活助手 (支持)

示例：


<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8"/>
	<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no"/>
	<title>OAuth Example</title>
	<script type="text/javascript">
var auths=null;
// 监听plusready事件  
document.addEventListener( "plusready", function(){
	// 扩展API加载完毕，现在可以正常调用扩展API
	plus.oauth.getServices( function(services){
		auths = services;
	}, function(e){
		alert( "获取分享服务列表失败："+e.message+" - "+e.code );
	} );
}, false );
// 登录操作
function authLogin(){
	var s = auths[0];
	if ( !s.authResult ) {
		s.login( function(e){
			alert( "登录认证成功！" );
		}, function(e){
			alert( "登录认证失败："+e.message+" - "+e.code );
		}, {} );
	}
}
	</script>
	</head>
	<body>
		请求登录授权认证操作
		<button onclick="authLogin()">Login</button>
	</body>
</html>

OAuth

API Reference

Plugins

Native.js

方法：

对象：

回调方法：

模块：

说明：

参数：

返回值：

平台支持：

示例：

说明：

属性：

方法：

说明：

平台支持：

说明：

平台支持：

说明：

平台支持：

说明：

平台支持：

说明：

说明：

参数：

返回值：

平台支持：

示例：

说明：

参数：

返回值：

示例：

说明：

参数：

返回值：

平台支持：

示例：

说明：

参数：

返回值：

平台支持：

示例：

说明：

属性：

示例：

说明：

属性：

说明：

属性：

说明：

参数：

返回值：

平台支持：

示例：

说明：

参数：

返回值：

平台支持：

示例：

说明：

参数：

返回值：

平台支持：

示例：

说明：

参数：

返回值：

平台支持：

示例：