uni.login(OBJECT)

登录

平台差异说明

H5平台登陆注意事项：

• 微信内嵌浏览器运行H5版时，可通过js sdk实现微信登陆，需要引入一个单独的js，详见
• 普通浏览器上实现微信登陆，并非开放API，需要向微信申请，仅个别开发者有此权限
• H5平台的其他登陆，比如QQ登陆、微博登陆，uni-app未封装，请在条件编译里按普通H5写法编写。OBJECT 参数说明

success 返回参数说明

各个小程序平台的登录流程存在差异，详细请参考相关平台的文档说明：

• 微信小程序登录
• 支付宝小程序用户授权
• 百度小程序登录
• 头条小程序登录示例

uni.login({
  provider: 'weixin',
  success: function (loginRes) {
    console.log(loginRes.authResult);
  }
});

uni.checkSession

检查登录状态是否过期

1.6.0 新增

平台差异说明

uni.getUserInfo(OBJECT)

获取用户信息。

平台差异说明

注意： 微信小程序端，在用户未授权过的情况下调用此接口，不会出现授权弹窗，会直接进入 fail 回调（详见《微信小程序公告》）。在用户已授权的情况下调用此接口，可成功获取用户信息。

OBJECT 参数说明

lang 值说明

注意：在小程序 withCredentials 为 true 时或是在 5+App 调用 uni.getUserInfo，要求此前有调用过 uni.login 且登录态尚未过期。

success 返回参数说明

userInfo 参数说明

除了以上三个必有的信息外，不同服务供应商返回的其它信息会存在差异。

App端登陆的扩展说明

App端还支持更多登陆相关API，如logout，详见

App端登陆相关的SDK需要在manifest中配置：

• 打开 manifest.json -> App模块权限配置，勾选 OAuth(登陆鉴权)。
• 打开 manifest.json -> App SDK配置，查看到登陆鉴权。在说明中有蓝色链接，其中包括向微信、QQ、微博等平台申请sdk的链接。
• 向微信、QQ、微博等平台申请到sdk的信息后，回填到manifest里。
• 这些配置需要打包生效，真机运行仍然是HBuilder基座的设置，可使用自定义基座包。离线打包请参考离线打包文档在原生工程中配置。
• 配置并打包后，通过uni.getProvider可以得到配置的结果列表，注意这里返回的是manifest配置的，与手机端是否安装微信、QQ、微博无关。如果手机端未安装QQ、微博，调用时会启动这些平台的wap页面登陆，如果已安装相应客户端，会启动它们的客户端登陆。

示例

uni.login({
  provider: 'weixin',
  success: function (loginRes) {
    console.log(loginRes.authResult);
    // 获取用户信息
    uni.getUserInfo({
      provider: 'weixin',
      success: function (infoRes) {
        console.log('用户昵称为：' + infoRes.userInfo.nickName);
      }
    });
  }
});

App端集成其他登陆SDK如支付宝、淘宝、facebook登陆的说明

• 使用原生插件方式，可以集成三方sdk，原生插件开发文档见https://ask.dcloud.net.cn/article/35428。开发之前可以先去插件市场看下有没有做好的。
• 支付宝登陆、淘宝登陆在插件市场均有插件，支付宝登陆、淘宝登陆。
• 也可以内嵌web-view组件，使用web登陆模式集成这些三方登陆

发现错误？想参与编辑？在 GitHub 上编辑此页面！