账号 1000+

接口声明

  1. { "name": "service.account" }

导入模块

  1. import account from '@service.account' const account = require('@service.account')

接口定义

account.getProvider()

获取服务提供商。

参数:

返回值:

字符串,服务提供商的代号,如厂商的英文品牌名称,假如无此服务则返回空字符串

示例:

  1. console.log(account.getProvider())

account.authorize(OBJECT)

进行 OAuth 授权。

参数:

参数名类型必填说明
typeString授权码模式为 code,简化模式为 token。
redirectUriUri重定向 URI。
scopeString申请的权限范围,目前只支持一种 scope,假如不填则 getProfile 只返回 openId。 scope.baseProfile:获取用户基本信息。
stateString可以指定任意值,认证服务器会原封不动地返回这个值。
successFunction成功回调
failFunction失败回调
completeFunction执行结束后的回调
success 返回值:
参数名类型说明
stateString请求时同字段指定的任意值。
codeString授权码模式下可用,返回的授权码。
accessTokenString简化模式下可用,返回的访问令牌。
tokenTypeString简化模式下可用,访问令牌类型。
expiresInNumber简化模式下可用,访问令牌过期时间,单位为秒,如果通过其他方式设置,则此处可能为空。
scopeString简化模式下可用,实际权限范围,如果与申请一致,则此处可能为空。
fail 返回错误代码
错误码说明
201用户拒绝,获取帐号权限失败

示例:

  1. account.authorize({
  2. type: 'code',
  3. redirectUri: 'http://www.example.com/',
  4. success: function(data) {
  5. console.log(`handling success: ${data.code}`)
  6. },
  7. fail: function(data, code) {
  8. console.log(`handling fail, code = ${code}`)
  9. }
  10. })

account.getProfile(OBJECT)

获得用户基本信息。

参数:

参数名类型必填说明
tokenString访问令牌
successFunction成功回调
failFunction失败回调,返回失败原因
completeFunction执行结束后的回调
success 返回值:
参数名类型说明
openidString用户的 openid,可能为空
idString用户的 user id,可能为空
unionidString用户在开放平台上的唯一标示符,本字段在满足一定条件下才会返回(需要在厂商的开放平台上额外申请)
nicknameString用户的昵称,可能为空
avatarObject用户的头像图片地址,可能为空,按照分辨率组织,当只有一个分辨率时,可以使用 default 对应的图片地址

unionid 机制说明

如果开发者拥有多个移动应用,可通过 unionid 来区分用户的唯一性,因为只要是同一个开放平台帐号下的移动应用,用户的 unionid 是唯一的。换句话说,同一用户,对同一个开放平台下的不同应用,unionid 是相同的。

示例:

  1. account.getProfile({
  2. token: 'abcdefg',
  3. success: function(data) {
  4. console.log(`handling success: ${data.nickname}`)
  5. },
  6. fail: function(data, code) {
  7. console.log(`handling fail, code = ${code}`)
  8. }
  9. })

后台运行限制

禁止使用。 后台运行详细用法参见后台运行 脚本

支持明细

厂商支持备注
小米YES小米帐号授权登录服务
中兴1010+-
华为YES华为开发者联盟
金立1010+金立快应用开发者中心
联想no-
魅族YES魅族账号接入服务
努比亚1010+努比亚开发者平台
OPPOYESOPPO 开放平台
vivoYESvivo 开发者平台
一加--
预览版no预览版不提供账号接口